Untuk perangkat yang menjalankan Android 13 atau yang lebih baru, Android memberikan kontrol multilevel untuk kekuatan flash. Di beberapa Android 12 dan yang lebih lama, framework hanya memungkinkan mengaktifkan atau menonaktifkan mode senter. Dengan mendukung kekuatan obor multilevel perangkat itu dapat memungkinkan kasus penggunaan seperti mengontrol kecerahan senter berdasarkan kondisi pencahayaan dan sinyal pengiriman untuk mendapatkan bantuan menggunakan efek stroboskopik dengan mengirimkan pulsa cahaya cepat secara berurutan. Lainnya manfaat dari fitur ini adalah dapat meningkatkan daya tahan baterai dan kinerja saat mode senter tidak selalu perlu dihidupkan pada kekuatan maksimum, yang dapat menyebabkan kondisi throttling termal.
API Publik
Aplikasi dapat menggunakan fitur kontrol kekuatan flash melalui fitur publik berikut Kunci karakteristik kamera dan API. Tidak ada izin kamera yang diperlukan untuk API ini karena kamera tidak diakses.
CameraManager API
public void turnOnTorchWithStrengthLevel (String cameraId, int torchStrength)
: Menyetel tingkat kecerahan senter yang terkait dengan NilaicameraId
dalam mode flash. Jika mode flash nonaktif dantorchStrength
lebih dari atau sama dengan1
, obor menyala dengan tingkat kekuatan yang ditentukan dalamtorchStrength
.public int getTorchStrengthLevel (String cameraId)
: Menampilkan tingkat kecerahan unit flash yang terkait dengancameraId
.
Tombol CameraCharacteristics
FLASH_INFO_STRENGTH_MAXIMUM_LEVEL
: Tingkat kecerahan maksimum. HAL kamera mengiklankan fitur ini dengan menyetel nilai yang lebih besar dari1
.FLASH_INFO_STRENGTH_DEFAULT_LEVEL
: Tingkat kecerahan senter default.
Implementasi
Untuk mendukung fitur kontrol kekuatan obor di perangkat Anda, gunakan antarmuka AIDL HAL kamera:
Lokasi: /camera/device/aidl/android/hardware/camera/device/ICameraDevice.aidl
Pastikan implementasi HAL Anda mengiklankan karakteristik kamera berikut untuk mendukung fitur kontrol kecerahan obor:
Untuk implementasi HAL Kamera referensi yang
mendukung kontrol kekuatan flash,
lihat
EmulatedCameraDeviceHWLImpl.cpp
Validasi
Untuk memvalidasi penerapan fitur kontrol kekuatan flash, jalankan berikut uji VTS dan CTS: