Untuk perangkat yang menjalankan Android 13 atau lebih tinggi, framework Android menyediakan kontrol bertingkat untuk kekuatan senter. Di Android 12 dan yang lebih rendah, framework ini hanya mengizinkan untuk mengaktifkan atau menonaktifkan mode senter. Dengan mendukung kontrol kekuatan obor bertingkat, perangkat dapat mengaktifkan kasus penggunaan seperti mengontrol kecerahan senter berdasarkan kondisi pencahayaan dan mengirimkan sinyal bantuan menggunakan efek strobo dengan mengirimkan pulsa cahaya cepat secara berurutan. Manfaat lain dari fitur ini adalah dapat meningkatkan masa pakai dan kinerja baterai karena mode senter tidak selalu perlu diaktifkan pada kekuatan maksimum, yang dapat menyebabkan kondisi pelambatan termal.
API Publik
Aplikasi dapat menggunakan fitur kontrol kekuatan obor melalui API publik dan tombol karakteristik kamera berikut. Tidak diperlukan izin kamera untuk API ini karena kamera tidak diakses.
API CameraManager
-
public void turnOnTorchWithStrengthLevel (String cameraId, int torchStrength)
: Menyetel tingkat kecerahan senter yang terkait dengan nilaicameraId
yang diberikan dalam mode obor. Jika mode obor mati dantorchStrength
lebih besar dari atau sama dengan1
, obor akan menyala dengan tingkat kekuatan yang ditentukan dalamtorchStrength
. -
public int getTorchStrengthLevel (String cameraId)
: Mengembalikan tingkat kecerahan unit lampu kilat yang terkait dengancameraId
.
Tombol Karakteristik CameraCharacteristics
-
FLASH_INFO_STRENGTH_MAXIMUM_LEVEL
: Tingkat kecerahan maksimum. Kamera HAL mengiklankan fitur ini dengan menetapkan nilai lebih besar dari1
. -
FLASH_INFO_STRENGTH_DEFAULT_LEVEL
: Tingkat kecerahan senter default.
Penerapan
Untuk mendukung fitur kontrol kekuatan obor pada perangkat Anda, gunakan antarmuka kamera AIDL HAL berikut:
Lokasi: /camera/device/aidl/android/hardware/camera/device/ICameraDevice.aidl
Pastikan penerapan HAL Anda mengiklankan tombol karakteristik kamera berikut untuk mendukung fitur kontrol kecerahan obor:
Untuk referensi implementasi Camera HAL yang mendukung kontrol kekuatan obor, lihat EmulatedCameraDeviceHWLImpl.cpp
.
Validasi
Untuk memvalidasi penerapan fitur kontrol kekuatan obor, jalankan pengujian VTS dan CTS berikut: