Cámaras USB externas

Organiza tus páginas con colecciones Guarda y categoriza el contenido según tus preferencias.

La plataforma de Android admite el uso de cámaras USB plug-and-play (es decir, cámaras web) que usan la API de Android Camera2 estándar y la interfaz de HAL de la cámara. Por lo general, las cámaras web admiten los controladores de clase de video USB (UVC) y, en Linux, se usa el controlador estándar Video4Linux (V4L) para controlar las cámaras UVC.

Con la compatibilidad con cámaras web, los dispositivos se pueden usar en casos de uso ligeros, como chats de video y kioscos de fotos. Esta función no reemplaza los HAL de cámara internos típicos en teléfonos Android y no está diseñada para admitir tareas complejas de alto rendimiento que involucren transmisión de alta resolución y alta velocidad, RA y control manual de ISP, sensor o lente.

El proceso de HAL de la cámara USB es parte del proveedor de cámaras externas que escucha la disponibilidad de los dispositivos USB y enumera los dispositivos de cámara externos según corresponda. El proceso tiene permisos y una política de SE similar al proceso de HAL de la cámara integrada. Las apps de cámaras web de terceros que se comunican directamente con dispositivos USB requieren los mismos permisos de cámara para acceder a dispositivos UVC que cualquier app de cámara normal.

Ejemplos y fuentes

Para obtener más información sobre cómo implementar cámaras USB, consulta la implementación de referencia del proveedor de cámaras externas en ExternalCameraProvider. Las implementaciones de la sesión y el dispositivo de la cámara externa se incluyen en ExternalCameraDevice y ExternalCameraDeviceSession. A partir del nivel de API 28, la API cliente de Java incluye el nivel de hardware EXTERNAL.

Implementación

La implementación debe admitir la función del sistema android.hardware.usb.host.

También se debe habilitar la compatibilidad del kernel con los dispositivos UVC. Para habilitar esta opción, agrega lo siguiente a los archivos defconfig del kernel correspondiente.

+CONFIG_USB_VIDEO_CLASS=y
+CONFIG_MEDIA_USB_SUPPORT=y

Para habilitar el proveedor de cámara externa en la compilación del dispositivo correspondiente, que agrega los permisos de SELinux necesarios, la configuración de la cámara externa y la dependencia del proveedor de cámara externa, completa los siguientes pasos:

• Agrega el archivo de configuración y la biblioteca de la cámara externa a device.mk.

  +PRODUCT_PACKAGES += android.hardware.camera.provider-V1-external-service
  
  +PRODUCT_COPY_FILES += \
  +device/manufacturerX/productY/external_camera_config.xml:$(TARGET_COPY_OUT_VENDOR)/etc/external_camera_config.xml
  

• Agrega el nombre del proveedor de la cámara externa al manifiesto de HAL de Treble del dispositivo.

  <hal format="aidl">
      <name>android.hardware.camera.provider</name>
      <version>1</version>
      <interface>
          <name>ICameraProvider</name>
          <instance>internal/0</instance>
  +       <instance>external/0</instance>
      </interface>
  </hal>
  

• (Opcional) Si el dispositivo se ejecuta en el modo de transferencia de Treble, actualiza sepolicy para que cameraserver pueda acceder a la cámara UVC.

  +# for external camera
  +allow cameraserver device:dir r_dir_perms;
  +allow cameraserver video_device:dir r_dir_perms;
  +allow cameraserver video_device:chr_file rw_file_perms;
  

Este es un ejemplo de external_camera_config.xml (se omiten las líneas de derechos de autor).

<ExternalCamera>
    <Provider>
        <ignore> <!-- Internal video devices to be ignored by external camera HAL -->
            <id>0</id> <!-- No leading/trailing spaces -->
            <id>1</id>
        </ignore>
    </Provider>
    <!-- See ExternalCameraUtils.cpp for default values of Device configurations below -->
    <Device>
        <!-- Max JPEG buffer size in bytes-->
        <MaxJpegBufferSize bytes="3145728"/> <!-- 3MB (~= 1080p YUV420) -->
        <!-- Size of v4l2 buffer queue when streaming >= 30fps -->
        <!-- Larger value: more request can be cached pipeline (less janky)  -->
        <!-- Smaller value: use less memory -->
        <NumVideoBuffers count="4"/>
        <!-- Size of v4l2 buffer queue when streaming < 30fps -->
        <NumStillBuffers count="2"/>

        <!-- List of maximum fps for various output sizes -->
        <!-- Any image size smaller than the size listed in Limit row will report
            fps (as minimum frame duration) up to the fpsBound value. -->
        <FpsList>
            <!-- width/height must be increasing, fpsBound must be decreasing-->
            <Limit width="640" height="480" fpsBound="30.0"/>
            <Limit width="1280" height="720" fpsBound="15.0"/>
            <Limit width="1920" height="1080" fpsBound="10.0"/>
            <!-- image size larger than the last entry will not be supported-->
        </FpsList>
    </Device>
</ExternalCamera>

Personalización

Puedes mejorar la cámara de Android a través de opciones de personalización generales o optimizaciones específicas del dispositivo.

Personalizaciones generales

Para personalizar el proveedor de cámaras externas, modifica el archivo external_camera_config.xml. Específicamente, los clientes pueden personalizar los siguientes parámetros:

• Cómo excluir nodos de video de cámaras internas
• Límite superior admitido para el tamaño de la imagen y la velocidad de fotogramas
• Cantidad de búferes en curso (comparación entre la latencia y la memoria)

Además de estos parámetros, puedes agregar tus propios parámetros o desarrollar tus propios parámetros de configuración.

Optimizaciones específicas del dispositivo

También puedes mejorar el rendimiento agregando optimizaciones específicas para cada dispositivo.

Copia o escalamiento del búfer y decodificación o codificación de JPEG

Las implementaciones genéricas usan la CPU (libyuv/libjpeg), pero puedes reemplazarlas con optimizaciones específicas del dispositivo.

Formato de salida de HAL

Las implementaciones genéricas usan los siguientes formatos de salida:

• YUV_420_888 para búferes de IMPLEMENTATION_DEFINED de video
• YUV12 para todos los demás búferes IMPLEMENTATION_DEFINED

Para mejorar el rendimiento, puedes reemplazar los formatos de salida por formatos eficientes específicos del dispositivo. También puedes admitir formatos adicionales en una implementación personalizada.

Validación

Los dispositivos con compatibilidad con cámaras externas deben aprobar el CTS de la cámara. La cámara web USB externa debe permanecer conectada al dispositivo específico durante toda la ejecución de la prueba; de lo contrario, fallarán algunos casos de prueba.