Kamera USB eksternal

<!-- Copyright 2018 The Android Open Source Project

Dilisensikan di bawah Lisensi Apache, Versi 2.0 ("Lisensi"); Anda tidak boleh menggunakan file ini kecuali sesuai dengan Lisensi. Anda dapat memperoleh salinan Lisensi di

  http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. Lihat Lisensi untuk bahasa khusus yang mengatur izin dan batasan menurut Lisensi. -->

Platform Android mendukung penggunaan kamera USB plug-and-play (yaitu, webcam) menggunakan Android Camera2 API standar dan antarmuka HAL kamera. Webcam umumnya mendukung driver USB video class (UVC) dan di Linux, driver Video4Linux (V4L) standar digunakan untuk mengontrol kamera UVC.

Dengan dukungan untuk webcam, perangkat dapat digunakan dalam kasus penggunaan ringan seperti video chat dan kios foto. Fitur ini tidak menggantikan HAL kamera internal umum di ponsel Android dan tidak dirancang untuk mendukung tugas kompleks yang membutuhkan performa tinggi yang melibatkan streaming berkecepatan tinggi dan beresolusi tinggi, AR, serta kontrol ISP/sensor/lensa manual.

Proses HAL kamera USB adalah bagian dari penyedia kamera eksternal yang memantau ketersediaan perangkat USB dan mencantumkan perangkat kamera eksternal sebagaimana mestinya. Proses ini memiliki izin dan kebijakan SE yang mirip dengan proses HAL kamera bawaan. Aplikasi webcam pihak ketiga yang berkomunikasi langsung dengan perangkat USB memerlukan izin kamera yang sama untuk mengakses perangkat UVC seperti aplikasi kamera biasa.

Contoh dan sumber

Untuk mengetahui informasi selengkapnya tentang cara menerapkan kamera USB, lihat implementasi referensi penyedia kamera eksternal di ExternalCameraProvider. Implementasi perangkat dan sesi kamera eksternal disertakan dalam ExternalCameraDevice dan ExternalCameraDeviceSession. Mulai API level 28, Java Client API menyertakan EXTERNAL level hardware.

Implementasi

Implementasi harus mendukung fitur sistem android.hardware.usb.host.

Dukungan kernel untuk perangkat UVC juga harus diaktifkan. Anda dapat mengaktifkannya dengan menambahkan kode berikut ke file defconfig kernel masing-masing.

+CONFIG_USB_VIDEO_CLASS=y
+CONFIG_MEDIA_USB_SUPPORT=y

Untuk mengaktifkan penyedia kamera eksternal di build perangkat masing-masing, yang menambahkan izin SELinux yang diperlukan, konfigurasi kamera eksternal, dan dependensi penyedia kamera eksternal, selesaikan langkah-langkah berikut:

  • Tambahkan file konfigurasi kamera eksternal dan library kamera eksternal ke 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

  • Tambahkan nama penyedia kamera eksternal ke manifes HAL Treble perangkat.

    <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>

  • (Opsional) Jika perangkat berjalan dalam mode teruskan Treble, perbarui sepolicy agar cameraserver dapat mengakses kamera 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;

Berikut adalah contoh external_camera_config.xml (baris hak cipta tidak disertakan).

<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>

Penyesuaian

Anda dapat meningkatkan kualitas kamera Android melalui opsi penyesuaian umum atau pengoptimalan khusus perangkat.

Penyesuaian umum

Anda dapat menyesuaikan penyedia kamera eksternal dengan mengubah file external_camera_config.xml. Secara khusus, klien dapat menyesuaikan parameter berikut:

  • Mengecualikan node video kamera internal
  • Batas atas ukuran gambar dan kecepatan frame yang didukung
  • Jumlah buffer dalam penerbangan (kompromi jank vs. memori)

Selain parameter ini, Anda dapat menambahkan parameter sendiri atau mengembangkan konfigurasi Anda sendiri.

Pengoptimalan khusus perangkat

Anda juga dapat meningkatkan performa dengan menambahkan pengoptimalan khusus perangkat.

Penyalinan/penskalaan buffer dan dekode/encode JPEG

Penerapan generik menggunakan CPU (libyuv/libjpeg), tetapi Anda dapat menggantinya dengan pengoptimalan khusus perangkat.

Format output HAL

Penerapan generik menggunakan format output berikut:

  • YUV_420_888 untuk buffer video IMPLEMENTATION_DEFINED
  • YUV12 untuk semua buffer IMPLEMENTATION_DEFINED lainnya

Untuk meningkatkan performa, Anda dapat mengganti format output dengan format efisien khusus perangkat. Anda juga dapat mendukung format tambahan dalam penerapan yang disesuaikan

Validasi

Perangkat dengan dukungan kamera eksternal harus lulus CTS kamera. Webcam USB eksternal harus tetap dicolokkan ke perangkat tertentu selama seluruh pengujian dijalankan, jika tidak, beberapa kasus pengujian akan gagal.