Streaming Kamera Bersamaan

Android memungkinkan perangkat untuk mendukung streaming perangkat kamera secara bersamaan. Misalnya, ini memungkinkan perangkat memiliki kamera depan dan belakang yang beroperasi secara bersamaan. Dari Android 11, Camera2 API menyertakan metode berikut yang dapat dipanggil aplikasi untuk menentukan apakah kamera mendukung streaming bersamaan dan konfigurasi streaming yang didukung.

Kumpulan kombinasi streaming wajib yang harus didukung selama streaming bersamaan disertakan melalui karakteristik kamera perangkat kamera di properti SCALER_MANDATORY_CONCURRENT_STREAM_COMBINATIONS .

Setiap perangkat kamera yang diiklankan melalui getConcurrentStreamingCameraIds() harus mendukung konfigurasi dijamin berikut untuk streaming serentak.

Target 1 Target 2
Jenis Ukuran maksimal Jenis Ukuran maksimal Contoh kasus penggunaan
YUV s1440p Pemrosesan video atau gambar dalam aplikasi
PRIV s1440p Analisis jendela bidik dalam aplikasi
JPEG s1440p Tidak ada pengambilan gambar diam jendela bidik
YUV / PRIV s720p JPEG s1440p Pencitraan diam standar
YUV / PRIV s720p YUV / PRIV s1440p Video atau pemrosesan dalam aplikasi dengan pratinjau

Perangkat dengan kemampuan MONOCHROME ( CameraCharacteristics#REQUEST_AVAILABLE_CAPABILITIES termasuk CameraMetadata#REQUEST_AVAILABLE_CAPABILITIES_MONOCHROME ) yang mendukung Y8 harus mendukung penggantian aliran YUV dengan Y8 di semua kombinasi aliran yang dijamin.

s720p mengacu pada 720p (1280 x 720) atau resolusi maksimum yang didukung untuk format tertentu yang dikembalikan oleh StreamConfigurationMap.getOutputSizes() . s1440p mengacu pada 1440p (1920 x 1440) atau resolusi maksimum yang didukung untuk format tertentu yang dikembalikan oleh StreamConfigurationMap.getOutputSizes() . Perangkat yang kemampuannya tidak menyertakan ANDROID_REQUEST_AVAILABLE_CAPABILITIES_BACKWARD_COMPATIBLE harus mendukung setidaknya satu aliran Y16, Dataspace::DEPTH dengan resolusi sVGA, selama operasi bersamaan, di mana sVGA lebih kecil dari dua resolusi berikut:

  • resolusi output maksimum untuk format yang diberikan
  • 640x480

Penerapan

Untuk mengizinkan aplikasi menanyakan perangkat guna menentukan apakah kameranya mendukung streaming bersamaan, terapkan antarmuka ICameraProvider@2.6 HAL, yang mencakup metode berikut:

Untuk implementasi referensi antarmuka HAL ICameraProvider@2.6 , lihat perpustakaan HAL kamera yang diemulasi di EmulatedCameraProviderHWLImpl.cpp .

Validasi

Untuk menguji apakah penerapan fitur ini berfungsi sebagaimana dimaksud, gunakan pengujian CTS ConcurrentCameraTest.java . Juga, uji menggunakan aplikasi yang membuka banyak kamera dan mengoperasikannya secara bersamaan.

Masalah alokasi sumber daya

Jika HAL kamera mengiklankan dukungan untuk pengoperasian perangkat kamera secara bersamaan, mereka mungkin mengalami masalah alokasi sumber daya, terutama dalam kasus di mana ada cukup sumber daya prosesor sinyal gambar (ISP) di telepon untuk mengalirkan kamera depan dan belakang (atau lainnya) secara bersamaan , tapi tidak untuk kapasitas penuh mereka. Dalam hal ini, HAL kamera harus mengalokasikan sumber daya perangkat keras yang terbatas untuk setiap perangkat kamera.

Contoh skenario

Skenario berikut menunjukkan masalah ini.

Masalah

Perangkat memiliki konfigurasi berikut:

  • Camera ID 0 adalah kamera logis yang didukung oleh kamera wide dan ultra-wide, yang masing-masing mengambil satu sumber daya ISP.
  • Kamera ID 1 adalah kamera yang mengambil satu sumber daya ISP.

Perangkat (ponsel) memiliki dua ISP. Jika ID kamera 0 dibuka dan sesi dikonfigurasi, kemungkinan HAL kamera mencadangkan dua ISP yang mengantisipasi penggunaan kamera ultrawide dan wide.

Jika demikian, kamera depan (ID 1 ) tidak dapat mengonfigurasi aliran apa pun karena kedua ISP sedang digunakan.

Larutan

Untuk mengatasi masalah ini, framework dapat membuka ID kamera 0 dan 1 sebelum mengonfigurasi sesi untuk memberikan petunjuk kepada HAL kamera tentang cara mengalokasikan sumber daya (karena sekarang mengharapkan pengoperasian kamera secara bersamaan). Namun, ini dapat menyebabkan kemampuan terbatas, misalnya, zoom mungkin tidak dapat menangani rasio rentang zoom penuh (karena mengganti ID kamera fisik mungkin bermasalah).

Untuk menerapkan solusi ini, buat pembaruan berikut ke provider@2.6::ICameraProvider::getConcurrentCameraStreamingCameraIds .

  • Mengamanatkan bahwa untuk pengoperasian kamera secara bersamaan, kerangka kerja kamera harus membuka perangkat kamera ( @3.2::ICameraDevice::open ) sebelum mengonfigurasi sesi apa pun pada perangkat kamera. Hal ini memungkinkan penyedia kamera untuk mengalokasikan sumber daya yang sesuai.

  • Untuk mengatasi masalah tidak mampu menangani rasio rentang zoom penuh, pastikan bahwa aplikasi kamera, saat menggunakan kamera secara bersamaan, dijamin menggunakan pengaturan kontrol ZOOM_RATIO antara hanya 1x dan MAX_DIGITAL_ZOOM alih-alih ZOOM_RATIO_RANGE lengkap (ini mencegah peralihan kamera fisik secara internal, yang berpotensi membutuhkan lebih banyak ISP).

Masalah dengan testDualCameraPreview

Saat Anda melakukan pembaruan di atas, hal itu dapat menimbulkan masalah dengan perilaku yang diizinkan oleh pengujian MultiViewTest.java#testDualCameraPreview .

Tes testDualCameraPreview tidak mengonfigurasi sesi hanya setelah membuka semua kamera. Ini mengikuti urutan ini:

for each camera  in cameraDevices :
  device = openCamera(camera)
     createCaptureSession(device);

Namun, itu mentolerir kegagalan kamera terbuka dengan ERROR_MAX_CAMERAS_IN_USE [1] . Aplikasi pihak ketiga mungkin bergantung pada perilaku ini.

Karena kamera HAL tidak akan mengetahui set lengkap ID kamera yang dibuka untuk operasi bersamaan sebelum mengonfigurasi sesi, mungkin sulit untuk mengalokasikan sumber daya perangkat keras (dengan asumsi ada beberapa persaingan untuk mereka).

Untuk mengatasi masalah ini, mempertahankan kompatibilitas mundur selain mendukung streaming bersamaan, HAL kamera harus menggagalkan panggilan openCamera dengan ERROR_MAX_CAMERAS_IN_USE jika mereka tidak dapat mendukung konfigurasi streaming penuh untuk semua kamera yang berjalan secara bersamaan.