Esta página se ha traducido con Cloud Translation API.

Cámaras USB Externas

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

Con soporte para cámaras web, los dispositivos se pueden utilizar en casos de uso livianos, como video chat y quioscos de fotografías. Esta característica no reemplaza las HAL de cámara interna típicas en teléfonos Android y no está diseñada para admitir tareas complejas y de alto rendimiento que involucran transmisión de alta resolución y alta velocidad, AR y control manual de ISP/sensor/lente.

El proceso HAL de la cámara USB es parte del proveedor de cámaras externas que escucha la disponibilidad del dispositivo USB y enumera los dispositivos de cámara externos en consecuencia. El proceso tiene permisos y una política SE similar al proceso HAL de la cámara incorporada. Las aplicaciones de cámara web de terceros que se comunican directamente con dispositivos USB requieren los mismos permisos de cámara para acceder a dispositivos UVC que cualquier aplicación de cámara normal.

Ejemplos y fuentes

Para obtener más información sobre cómo implementar cámaras USB, consulte la implementación de referencia del proveedor de cámaras externas en ExternalCameraProvider . El dispositivo de cámara externa y las implementaciones de sesión se incluyen en ExternalCameraDevice y ExternalCameraDeviceSession . A partir del nivel de API 28, la API del cliente 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 con el kernel para dispositivos UVC. Puede habilitar esto agregando lo siguiente a los respectivos archivos defconfig del kernel.

+CONFIG_USB_VIDEO_CLASS=y
+CONFIG_MEDIA_USB_SUPPORT=y

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

Agregue el archivo de configuración de la cámara externa 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

Agregue el nombre del proveedor de la cámara externa al manifiesto Treble HAL 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 modo de transferencia de agudos, actualice 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;

A continuación se muestra 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

Puede mejorar la cámara de Android mediante opciones de personalización generales u optimizaciones específicas del dispositivo.

Personalizaciones generales

Puede personalizar el proveedor de la cámara externa modificando el archivo external_camera_config.xml . Específicamente, los clientes pueden personalizar los siguientes parámetros:

Excluyendo nodos de video de cámaras internas.
Tamaño de imagen admitido y límite superior de velocidad de fotogramas
Número de buffers en tránsito (compensación entre bloqueo y memoria)

Además de estos parámetros, puede agregar sus propios parámetros o desarrollar sus propias configuraciones.

Optimizaciones específicas del dispositivo

También puede mejorar el rendimiento agregando optimizaciones específicas del dispositivo.

Copia/escalado de búfer y decodificación/codificación JPEG

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

Formato de salida HAL

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

YUV_420_888 para buffers de video IMPLEMENTATION_DEFINED
YUV12 para todos los demás buffers IMPLEMENTATION_DEFINED

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

Validación

Los dispositivos con soporte para cámara externa deben pasar el CTS de 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, algunos casos de prueba fallarán.