Đối với các thiết bị chạy Android 13 trở lên, khung Android cung cấp một chế độ kiểm soát nhiều cấp cho cường độ đèn pin. Trong Android 12 trở xuống, khung này chỉ cho phép bật hoặc tắt chế độ đèn pin. Bằng cách hỗ trợ chế độ kiểm soát cường độ đèn pin nhiều cấp, các thiết bị có thể bật các trường hợp sử dụng như kiểm soát độ sáng của đèn pin dựa trên điều kiện ánh sáng và gửi tín hiệu hỗ trợ bằng hiệu ứng nhấp nháy bằng cách gửi các xung ánh sáng nhanh liên tiếp. Một lợi ích khác của tính năng này là có thể cải thiện thời lượng pin và hiệu suất vì chế độ đèn pin không phải lúc nào cũng cần bật ở cường độ tối đa, điều này có thể dẫn đến tình trạng điều tiết nhiệt.
API công khai
Các ứng dụng có thể dùng tính năng kiểm soát cường độ đèn pin thông qua các API công khai và khoá đặc điểm máy ảnh sau đây. Bạn không cần có quyền sử dụng camera cho các API này vì camera không được truy cập.
CameraManager API
public void turnOnTorchWithStrengthLevel (String cameraId, int torchStrength): Đặt mức độ sáng của đèn pin được liên kết với giá trịcameraIdđã cho ở chế độ đèn pin. Nếu chế độ đèn pin đang tắt vàtorchStrengthlớn hơn hoặc bằng1, thì đèn pin sẽ bật với mức cường độ được chỉ định trongtorchStrength.public int getTorchStrengthLevel (String cameraId): Trả về mức độ sáng của đèn flash được liên kết vớicameraId.
Khoá CameraCharacteristics
FLASH_INFO_STRENGTH_MAXIMUM_LEVEL: Mức độ sáng tối đa. HAL camera quảng cáo tính năng này bằng cách đặt một giá trị lớn hơn1.FLASH_INFO_STRENGTH_DEFAULT_LEVEL: Mức độ sáng mặc định của đèn pin.
Triển khai
Để hỗ trợ tính năng điều khiển cường độ đèn pin trên thiết bị, hãy sử dụng các giao diện HAL AIDL camera sau đây:
Vị trí: /camera/device/aidl/android/hardware/camera/device/ICameraDevice.aidl
Đảm bảo chế độ triển khai HAL của bạn quảng cáo các khoá đặc điểm camera sau đây để hỗ trợ tính năng điều khiển độ sáng của đèn pin:
Để tham khảo cách triển khai HAL camera hỗ trợ tính năng kiểm soát cường độ đèn pin, hãy xem EmulatedCameraDeviceHWLImpl.cpp.
Xác nhận kết quả
Để xác thực việc triển khai tính năng điều khiển cường độ đèn pin, hãy chạy các kiểm thử VTS và CTS sau: