एंड्रॉइड 13 या उच्चतर चलाने वाले उपकरणों के लिए, एंड्रॉइड फ्रेमवर्क टॉर्च ताकत के लिए एक बहुस्तरीय नियंत्रण प्रदान करता है। एंड्रॉइड 12 और उससे पहले के संस्करण में, फ्रेमवर्क केवल टॉर्च मोड को चालू या बंद करने की अनुमति देता है। बहुस्तरीय टॉर्च शक्ति नियंत्रण का समर्थन करके, उपकरण प्रकाश की स्थिति के आधार पर फ्लैशलाइट की चमक को नियंत्रित करने और एक पंक्ति में प्रकाश की त्वरित दालों को भेजकर स्ट्रोब प्रभाव का उपयोग करके सहायता के लिए संकेत भेजने जैसे उपयोग के मामलों को सक्षम कर सकते हैं। इस सुविधा का एक अन्य लाभ यह है कि यह बैटरी जीवन और प्रदर्शन में सुधार कर सकता है क्योंकि टॉर्च मोड को हमेशा अधिकतम शक्ति पर चालू करने की आवश्यकता नहीं होती है, जिससे थर्मल थ्रॉटलिंग की स्थिति पैदा हो सकती है।
सार्वजनिक एपीआई
ऐप्स निम्नलिखित सार्वजनिक एपीआई और कैमरा विशेषता कुंजियों के माध्यम से टॉर्च शक्ति नियंत्रण सुविधा का उपयोग कर सकते हैं। इन एपीआई के लिए किसी कैमरा अनुमति की आवश्यकता नहीं है क्योंकि कैमरे तक पहुंच नहीं है।
CameraManager
एपीआई
-
public void turnOnTorchWithStrengthLevel (String cameraId, int torchStrength)
: टॉर्च मोड में दिए गएcameraId
मान से जुड़े फ्लैशलाइट का चमक स्तर सेट करता है। यदि टॉर्च मोड बंद है औरtorchStrength
1
से अधिक या उसके बराबर है, तो टॉर्चtorchStrength
में निर्दिष्ट शक्ति स्तर के साथ चालू हो जाती है। -
public int getTorchStrengthLevel (String cameraId)
:cameraId
से जुड़ी फ्लैश यूनिट का चमक स्तर लौटाता है।
CameraCharacteristics
कुंजियाँ
-
FLASH_INFO_STRENGTH_MAXIMUM_LEVEL
: अधिकतम चमक स्तर। कैमरा HAL1
से अधिक मान सेट करके इस सुविधा का विज्ञापन करता है। -
FLASH_INFO_STRENGTH_DEFAULT_LEVEL
: डिफ़ॉल्ट फ्लैशलाइट चमक स्तर।
कार्यान्वयन
अपने डिवाइस पर टॉर्च शक्ति नियंत्रण सुविधा का समर्थन करने के लिए, निम्नलिखित कैमरा एआईडीएल एचएएल इंटरफेस का उपयोग करें:
स्थान: /camera/device/aidl/android/hardware/camera/device/ICameraDevice.aidl
सुनिश्चित करें कि आपका एचएएल कार्यान्वयन टॉर्च चमक नियंत्रण सुविधा का समर्थन करने के लिए निम्नलिखित कैमरा विशेषताओं कुंजियों का विज्ञापन करता है:
टॉर्च शक्ति नियंत्रण का समर्थन करने वाले संदर्भ कैमरा एचएएल कार्यान्वयन के लिए, EmulatedCameraDeviceHWLImpl.cpp
देखें।
मान्यकरण
टॉर्च शक्ति नियंत्रण सुविधा के अपने कार्यान्वयन को सत्यापित करने के लिए, निम्नलिखित वीटीएस और सीटीएस परीक्षण चलाएं:
- वीटीएस:
/camera/provider/aidl/vts/VtsAidlHalCameraProvider\_TargetTest.cpp
/vts/VtsAidlHalCameraProvider\_TargetTest.cpp - सीटीएस:
/platform/cts/tests/camera/src/android/hardware/camera2/cts/FlashlightTest.java