Konfigurasi streaming

Android menyertakan fitur yang memungkinkan klien kamera untuk memilih kamera yang optimal streaming untuk kasus penggunaan tertentu dan memastikan bahwa kombinasi streaming tertentu didukung oleh perangkat kamera. Konfigurasi streaming mengacu pada satu streaming kamera yang dikonfigurasi di perangkat kamera dan kombinasi streaming merujuk ke satu atau beberapa kumpulan streaming yang dikonfigurasi di perangkat kamera. Untuk info selengkapnya tentang fitur ini, lihat konfigurasi streaming yang direkomendasikan dan API untuk mengkueri kombinasi fitur.

Penerapan referensi

Terdapat penerapan referensi sisi vendor untuk konfigurasi yang direkomendasikan stream dan API untuk mengkueri fitur kombinasi streaming. Anda dapat menemukannya implementasi di QCamera3HWI.cpp

Vendor kamera dapat mengiklankan konfigurasi streaming yang direkomendasikan untuk penggunaan tertentu ke klien kamera. Konfigurasi streaming yang direkomendasikan ini, subhimpunan dari StreamConfigurationMap, dapat membantu klien kamera memilih konfigurasi yang optimal.

Meskipun StreamConfigurationMap memberikan informasi konfigurasi streaming yang lengkap ke klien kamera, tidak memberikan informasi apa pun tentang efisiensi, daya, atau kinerja dampak memilih satu aliran data daripada yang lain. Klien kamera dapat memilih secara bebas dari semua kemungkinan konfigurasi streaming, tetapi dalam banyak kasus, hal ini menyebabkan klien menggunakan konfigurasi kamera dan aplikasi yang kurang optimal sehingga melakukan penelusuran menyeluruh yang memakan waktu.

Misalnya, meskipun beberapa format YUV yang diproses diperlukan dan harus didukung, perangkat kamera mungkin tidak memiliki dukungan native untuk format tersebut. Hal ini menghasilkan proses pemrosesan tambahan untuk konversi format dan mengurangi efisiensi. Ukuran dan rasio aspek yang sesuai juga dapat memiliki dampak serupa sehingga dimensi tertentu lebih disukai dalam hal daya dan performa.

Peta konfigurasi streaming yang direkomendasikan tidak harus lengkap dibandingkan dengan StreamConfigurationMap. Peta konfigurasi yang disarankan harus mengikuti persyaratan di bagian implementasi dan dapat menyertakan format, ukuran, atau nilai lain yang tersedia di StreamConfigurationMap. Format, ukuran, atau nilai lain tersembunyi yang tidak ditemukan di StreamConfigurationMap tidak dapat disertakan dalam rekomendasi peta konfigurasi streaming.

Semua pengujian tetap tidak berubah dan tidak dilonggarkan bergantung pada konfigurasi streaming yang direkomendasikan.

Konfigurasi streaming yang direkomendasikan yang disediakan oleh penerapan kamera adalah opsional dan klien kamera dapat mengabaikannya.

Implementasi

Ikuti langkah-langkah berikut untuk menerapkan fitur ini.

Entri metadata

Untuk mengaktifkan fitur ini, Camera HAL harus mengisi statis berikut entri metadata:

  • android.scaler.availableRecommendedStreamConfigurations: subset konfigurasi streaming yang direkomendasikan untuk kasus penggunaan tertentu. Deklarasi menggunakan bitmap yang menunjukkan kasus penggunaan yang disarankan dalam bentuk [1 << PREVIEW | 1 << RECORD..]. Kasus penggunaan memperluas tuple reguler (format, lebar, tinggi, input) dengan satu entri tambahan. Kasus penggunaan publik yang tidak ada atau bit lain yang ditetapkan dalam rentang tersebut [PUBLIC_END, VENDOR_START] dilarang.

    Informasi ini disimpan dalam tag metadata availableRecommendedStreamConfigurations.

    Contoh berikut menunjukkan array untuk streaming yang direkomendasikan untuk perangkat kamera yang hanya mendukung 4K dan 1080p, kedua resolusi lebih disukai untuk perekaman video, tetapi hanya 1080p yang disarankan untuk pratinjau.

    [3840, 2160, HAL_PIXEL_FORMAT_IMPLEMENTATION_DEFINED,
ANDROID_SCALER_AVAILABLE_STREAM_CONFIGURATIONS_OUTPUT,
(1 << ANDROID_SCALER_AVAILABLE_RECOMMENDED_STREAM_CONFIGURATIONS_RECORD |
1 << ANDROID_SCALER_AVAILABLE_RECOMMENDED_STREAM_CONFIGURATIONS_SNAPSHOT |
1 << ANDROID_SCALER_AVAILABLE_RECOMMENDED_STREAM_CONFIGURATIONS_VIDEO_SNAPSHOT),
1920, 1080, HAL_PIXEL_FORMAT_IMPLEMENTATION_DEFINED,
ANDROID_SCALER_AVAILABLE_STREAM_CONFIGURATIONS_OUTPUT,
(1 << ANDROID_SCALER_AVAILABLE_RECOMMENDED_STREAM_CONFIGURATIONS_PREVIEW |
1 << ANDROID_SCALER_AVAILABLE_RECOMMENDED_STREAM_CONFIGURATIONS_RECORD |
1 << ANDROID_SCALER_AVAILABLE_RECOMMENDED_STREAM_CONFIGURATIONS_SNAPSHOT |
1 << ANDROID_SCALER_AVAILABLE_RECOMMENDED_STREAM_CONFIGURATIONS_VIDEO_SNAPSHOT)]

  • android.depth.availableRecommendedDepthStreamConfigurations (hanya tersedia jika didukung oleh perangkat): Konfigurasi streaming ruang data kedalaman yang direkomendasikan untuk perangkat kamera ini. Serupa dengan di atas entri metadata, bitmap kasus penggunaan tambahan menunjukkan kasus penggunaan.

    Informasi ini disimpan dalam tag metadata availableRecommendedInputOutputFormatsMap.

  • android.scaler.availableRecommendedInputOutputFormatsMap (tersedia hanya jika didukung oleh perangkat): Pemetaan format gambar yang direkomendasikan yang disarankan untuk perangkat kamera ini untuk streaming input, ke format output yang sesuai.

    Informasi ini disimpan dalam tag metadata availableRecommendedDepthStreamConfigurations.

Informasi ini tersedia untuk klien kamera melalui RecommendedStreamConfigurationMap API.

Kasus penggunaan yang diperlukan

Konfigurasi streaming yang direkomendasikan harus diberikan untuk kasus penggunaan berikut dan memenuhi persyaratan yang sesuai:

Kasus penggunaan Persyaratan
PREVIEW Pratinjau hanya boleh menyertakan konfigurasi streaming yang diproses yang tidak stabil dengan format output seperti YUV_420_888 dan IMPLEMENTATION_DEFINED.
RECORD Rekaman video harus menyertakan konfigurasi streaming yang cocok dengan yang diiklankan profil media yang didukung dengan format IMPLEMENTATION_DEFINED.
VIDEO_SNAPSHOT Cuplikan video harus menyertakan konfigurasi streaming yang setidaknya memiliki sebesar resolusi RECORD maksimum dan hanya dengan BLOB + Kombinasi format/ruang data DATASPACE_JFIF (JPEG). Konfigurasi seharusnya tidak menyebabkan gangguan pratinjau dan seharusnya dapat berjalan pada kecepatan 30 fps.
SNAPSHOT Konfigurasi streaming snapshot harus menyertakan minimal satu dengan ukuran yang mendekati android.sensor.info.activeArraySize dengan kombinasi format/dataspace BLOB + DATASPACE_JFIF (JPEG). Mempertimbangkan batasan terkait rasio aspek, perataan, dan batasan khusus vendor lainnya, area ukuran maksimum yang disarankan tidak boleh kurang dari 97% dari sensor area ukuran array.
ZSL (jika didukung) Jika didukung oleh perangkat kamera, konfigurasi aliran input yang direkomendasikan hanya boleh diiklankan bersama dengan output yang diproses atau terhenti lainnya format font.
RAW (jika didukung) Jika didukung oleh perangkat kamera, konfigurasi streaming mentah yang direkomendasikan hanya boleh menyertakan format output berbasis RAW.

Kasus penggunaan lainnya

Anda dapat memberikan aliran konfigurasi tambahan yang direkomendasikan untuk kasus penggunaan spesifik untuk implementasi Anda.

Validasi

Untuk menguji penerapan aliran konfigurasi yang direkomendasikan, jalankan uji CTS dan VTS berikut:

API untuk membuat kueri kombinasi fitur

Mulai Android 15, platform Android menyediakan API untuk membuat kueri kombinasi fitur. API ini memungkinkan klien kamera mengkueri apakah kombinasi fitur tertentu dapat didukung oleh perangkat. API ini diperlukan karena camera2 API membuat model fitur yang berbeda seperti 4k, 60 fps, video HDR, UltraHDR, zoom Ultrawide, dan stabilisasi sebagai kontrol ortogonal.

Persyaratan

Untuk mendukung API guna membuat kueri kombinasi fitur, HAL kamera harus menerapkan antarmuka ICameraDevice versi 3. Untuk mengetahui detailnya, lihat bagian Penerapan.

Jika API didukung, stabilisasi pratinjau harus ortogonal untuk fitur lainnya. Ini berarti bahwa untuk perangkat kamera yang mendukung pratinjau stabilisasi, nilai hasil isStreamCombinationWithSettingsSupported untuk kombinasi tertentu harus bernilai sama saat stabilisasi pratinjau sedang nyala atau mati. Tindakan ini mengurangi ruang penelusuran untuk kueri kombinasi fitur.

Selain itu, untuk performa media kelas 15, kamera belakang utama harus mendukung stabilisasi pratinjau dengan pratinjau HLG10 10-bit untuk 1080p dan 720p JPEG ukuran maksimum dan pratinjau. Untuk mengetahui detail selengkapnya tentang persyaratan ini, lihat bagian 2.2.7.2. Kamera dari CDD.

Implementasi

Untuk mendukung API guna membuat kueri kombinasi fitur, terapkan API kueri kombinasi fitur berikut di ICameraDevice versi 3:

Untuk versi yang lebih rendah dari versi 3 antarmuka ICameraDevice, HAL harus menerapkan isStreamCombinationSupported .

Untuk informasi selengkapnya tentang kombinasi fitur yang dikueri oleh API, lihat dokumentasi tentang sessionConfigurationQueryVersion di system/media/camera/docs/metadata_definitions.xml.

Untuk implementasi referensi fitur ini, lihat hardware/google/camera/devices/EmulatedCamera/hwl/

API Publik

Aplikasi dapat menggunakan API publik berikut untuk mengkueri kombinasi fitur yang didukung untuk perangkat:

  • CameraDevice.CameraDeviceSetup: Representasi terbatas dari CameraDevice yang dapat digunakan untuk mengkueri fitur kombinasi tanpa memerlukan instance CameraDevice.

  • getCameraDeviceSetup: Mendapatkan objek CameraDeviceSetup untuk ID kamera tertentu jika isCameraDeviceSetupSupported menampilkan true.

  • INFO_SESSION_CONFIGURATION_QUERY_VERSION: Mendukung kueri kombinasi fitur jika nilai ini VANILLA_ICE_CREAM atau yang lebih tinggi.

  • OutputConfiguration: Class yang menjelaskan output kamera, yang dapat berisi permukaan yang ditangguhkan untuk tujuan kueri kombinasi fitur latensi rendah.

  • SessionConfiguration: Class utilitas yang menjelaskan konfigurasi sesi termasuk kombinasi streaming dan parameter sesi, yang dapat digunakan untuk kueri kombinasi fitur.

Validasi

Untuk memvalidasi penerapan fitur ini, gunakan VTS, CTS, dan Uji Camera ITS (CTS Verifier):

VTS

CTS

Kamera ITS