Đối với các thiết bị chạy Android 13 trở lên, Android framework cung cấp khả năng kiểm soát đa cấp độ cho độ mạnh của đèn pin. Trong Android 12 trở xuống, khung chỉ cho phép bật hoặc tắt chế độ đèn pin. Bằng cách hỗ trợ điều khiển cường độ đèn pin đa cấp, các thiết bị có thể cho phép 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 nhờ 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à nó có thể cải thiện tuổi thọ và hiệu suất của pin vì chế độ đèn pin không phải lúc nào cũng cần được bật ở mức cường độ tối đa, điều này có thể dẫn đến tình trạng điều chỉnh nhiệt.
API công khai
Các ứng dụng có thể sử dụng tính năng kiểm soát cường độ đèn pin thông qua các API công khai sau đây và các phím đặc điểm của máy ảnh. Không cần quyền đối với máy ảnh đối với các API này vì máy ảnh không được truy cập.
API CameraManager
-
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ịcameraIdcho ở chế độ đèn pin. Nếu chế độ ngọn đuốc tắt vàtorchStrengthlớn hơn hoặc bằng1, ngọn đuốc sẽ bật với mức độ mạnh được chỉ định trongtorchStrength. -
public int getTorchStrengthLevel (String cameraId): Trả về mức độ sáng của bộ đèn flash được liên kết vớicameraId.
CameraCharacteristics
-
FLASH_INFO_STRENGTH_MAXIMUM_LEVEL: Mức sáng tối đa. Máy ảnh HAL 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: Mức độ sáng đèn pin mặc định.
Thực hiện
Để hỗ trợ tính năng kiểm soát cường độ đè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:
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 phím đặc điểm của máy ảnh sau để hỗ trợ tính năng điều khiển độ sáng đèn pin:
Để biết cách triển khai Camera HAL tham khảo hỗ trợ kiểm soát cường độ đèn pin, hãy xem EmulatedCameraDeviceHWLImpl.cpp .
Thẩm định
Để xác thực việc triển khai tính năng kiểm soát cường độ đèn pin của bạn, hãy chạy các bài kiểm tra VTS và CTS sau: