Đối với các thiết bị chạy Android 13 trở lên, khung Android cung cấp chế độ điều khiển 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ợ tính năng điều khiển cường độ đèn pin ở nhiều cấp, các thiết bị có thể hỗ trợ các trường hợp sử dụng như điều khiển độ 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 đèn 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ể sử dụng tính năng kiểm soát độ mạnh đèn pin thông qua các API công khai và khoá về đặc điểm của máy ảnh sau đây. Các API này không yêu cầu quyền sử dụng máy ảnh vì không truy cập vào máy ảnh.
API CameraManager
public void turnOnTorchWithStrengthLevel (String cameraId, int torchStrength): Đặt độ 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 độ sáng được chỉ định trongtorchStrength.public int getTorchStrengthLevel (String cameraId): Trả về mức độ sáng của đơn vị flash liên kết vớicameraId.
Khoá CameraCharacteristics
FLASH_INFO_STRENGTH_MAXIMUM_LEVEL: Cấp độ độ sáng tối đa. HAL máy ảnh quảng cáo tính năng này bằng cách đặt giá trị lớn hơn1.FLASH_INFO_STRENGTH_DEFAULT_LEVEL: Độ sáng đèn pin mặc định.
Triển khai
Để hỗ trợ tính năng kiểm soát độ mạnh đèn pin trên thiết bị của bạn, hãy sử dụng các giao diện AIDL HAL của máy ảnh sau đây:
Vị trí: /camera/device/aidl/android/hardware/camera/device/ICameraDevice.aidl
Đảm bảo việc triển khai HAL của bạn quảng cáo các khoá đặc điểm máy ảnh 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 của máy ảnh hỗ trợ kiểm soát độ sáng của đè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 bài kiểm thử VTS và CTS sau: