Mulai 27 Maret 2025, sebaiknya gunakan android-latest-release, bukan aosp-main, untuk mem-build dan berkontribusi pada AOSP. Untuk mengetahui informasi selengkapnya, lihat Perubahan pada AOSP.

Halaman ini diterjemahkan oleh Cloud Translation API.

Kontrol kekuatan senter

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 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 untuk meminta bantuan menggunakan efek strobo dengan mengirim pulsa cahaya cepat secara berurutan. Manfaat lain dari fitur ini adalah dapat meningkatkan daya tahan 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.

CameraManager API

public void turnOnTorchWithStrengthLevel (String cameraId, int torchStrength): Menetapkan tingkat kecerahan senter yang terkait dengan nilai cameraId tertentu dalam mode senter. Jika mode senter nonaktif dan torchStrength lebih besar dari atau sama dengan 1, senter akan menyala dengan tingkat kekuatan yang ditentukan dalam torchStrength.
public int getTorchStrengthLevel (String cameraId): Menampilkan tingkat kecerahan unit flash yang terkait dengan cameraId.

Kunci CameraCharacteristics

FLASH_INFO_STRENGTH_MAXIMUM_LEVEL: Tingkat kecerahan maksimum. HAL kamera mengiklankan fitur ini dengan menyetel nilai yang lebih besar dari 1.
FLASH_INFO_STRENGTH_DEFAULT_LEVEL: Tingkat kecerahan senter default.

Implementasi

Untuk mendukung fitur kontrol kekuatan senter 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 mengetahui implementasi Camera HAL referensi yang mendukung kontrol kekuatan senter, lihat EmulatedCameraDeviceHWLImpl.cpp.

Validasi

Untuk memvalidasi penerapan fitur kontrol kekuatan senter, jalankan pengujian VTS dan CTS berikut: