Untuk perangkat yang menjalankan Android 13 atau yang lebih baru, framework Android menyediakan kontrol multi-level untuk intensitas senter. Di Android 12 dan yang lebih rendah, framework hanya memungkinkan mengaktifkan atau menonaktifkan mode senter. Dengan mendukung kontrol kekuatan senter multi-level, perangkat dapat mengaktifkan kasus penggunaan seperti mengontrol kecerahan senter berdasarkan kondisi pencahayaan dan mengirim sinyal bantuan menggunakan efek strobo dengan mengirim pulsa cahaya cepat secara berurutan. Manfaat lain dari fitur ini adalah dapat meningkatkan masa pakai dan performa baterai karena mode senter tidak selalu perlu diaktifkan pada kekuatan maksimum, yang dapat menyebabkan kondisi pembatasan termal.
API Publik
Aplikasi dapat menggunakan fitur kontrol kekuatan senter melalui API publik dan kunci karakteristik kamera berikut. Tidak ada izin kamera yang diperlukan untuk API ini karena kamera tidak diakses.
API CameraManager
public void turnOnTorchWithStrengthLevel (String cameraId, int torchStrength): Menetapkan tingkat kecerahan senter yang terkait dengan nilaicameraIdtertentu dalam mode senter. Jika mode senter nonaktif dantorchStrengthlebih besar dari atau sama dengan1, senter akan menyala dengan tingkat kecerahan yang ditentukan dalamtorchStrength.public int getTorchStrengthLevel (String cameraId): Menampilkan tingkat kecerahan unit flash yang terkait dengancameraId.
Kunci 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.
Penerapan
Untuk mendukung fitur kontrol kekuatan senter di perangkat Anda, gunakan antarmuka AIDL HAL kamera berikut:
Lokasi: /camera/device/aidl/android/hardware/camera/device/ICameraDevice.aidl
Pastikan implementasi HAL Anda mengiklankan kunci karakteristik kamera berikut untuk mendukung fitur kontrol kecerahan senter:
Untuk mengetahui implementasi Camera HAL referensi yang mendukung kontrol kekuatan senter, lihat EmulatedCameraDeviceHWLImpl.cpp.
Validasi
Untuk memvalidasi penerapan fitur kontrol intensitas senter, jalankan pengujian VTS dan CTS berikut: