Untuk perangkat yang menjalankan Android 13 atau yang lebih baru, framework Android menyediakan kontrol multi-level untuk kekuatan senter. Di Android 12 dan yang lebih lama, framework hanya memungkinkan pengaktifan atau penonaktifan mode senter. Dengan mendukung kontrol kekuatan senter multilevel, perangkat dapat mengaktifkan kasus penggunaan seperti mengontrol kecerahan senter berdasarkan kondisi pencahayaan dan mengirim sinyal untuk bantuan menggunakan efek strobo dengan mengirimkan pulsa cahaya cepat secara berurutan. Manfaat lain dari fitur ini adalah dapat meningkatkan masa pakai baterai dan performa karena mode senter tidak selalu perlu diaktifkan pada kekuatan maksimum, yang dapat menyebabkan kondisi throttling termal.
API Publik
Aplikasi dapat menggunakan fitur kontrol kekuatan flash melalui API publik dan kunci karakteristik kamera berikut. 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
yang diberikan dalam mode flash. Jika mode senter nonaktif dantorchStrength
lebih besar dari atau sama dengan1
, senter akan 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 menetapkan nilai yang lebih besar dari1
.FLASH_INFO_STRENGTH_DEFAULT_LEVEL
: Tingkat kecerahan senter default.
Implementasi
Untuk mendukung fitur kontrol kekuatan flash di perangkat Anda, gunakan antarmuka HAL AIDL 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 implementasi Camera HAL referensi yang mendukung kontrol kekuatan flash,
lihat
EmulatedCameraDeviceHWLImpl.cpp
.
Validasi
Untuk memvalidasi penerapan fitur kontrol kekuatan flash, jalankan uji VTS dan CTS berikut: