Đối với các thiết bị chạy Android 13 trở lên, khung Android cung cấp khả năng kiểm soát nhiều cấp độ cho độ bền 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ợ kiểm soát 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ư 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 để được 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ì không phải lúc nào chế độ đèn pin cũng cần được bật ở cường độ tối đa, điều này có thể dẫn đến tình trạng tiết lưu 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 độ ngọn đuốc thông qua các API công khai và các phím đặc điểm của máy ảnh sau đây. Không cần có quyền truy cập vào máy ảnh đối với các API này vì máy ảnh không được truy cập.
API Trình 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ịcameraId
đã cho ở chế độ đèn pin. Nếu chế độ đèn pin tắt vàtorchStrength
lớ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 bộ đèn flash được liên kết vớicameraId
.
Các phím CameraCharacteristics
-
FLASH_INFO_STRENGTH_MAXIMUM_LEVEL
: Mức độ sáng tối đa. Camera 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 mặc định của đèn pin.
Thực hiện
Để hỗ trợ tính năng kiểm soát cường độ ngọn đuốc 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
/android/phần cứng/máy ảnh/thiết bị/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 máy ảnh sau để hỗ trợ tính năng kiểm soát độ sáng của đèn pin:
Để tham khảo việc triển khai Camera HAL hỗ trợ kiểm soát cường độ ngọn đuốc, 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 độ mỏ cắt của bạn, hãy chạy các bài kiểm tra VTS và CTS sau:
- VTS:
/camera/provider/aidl/vts/VtsAidlHalCameraProvider\_TargetTest.cpp
aidl/vts/VtsAidlHalCameraProvider\_TargetTest.cpp - CTS:
/platform/cts/tests/camera/src/android/hardware/camera2/cts/FlashlightTest.java
/tests/máy ảnh/src/android/phần cứng/máy ảnh2/cts/FlashlightTest.java