टॉर्च की रोशनी कंट्रोल करना

Android 13 या इसके बाद के वर्शन वाले डिवाइसों के लिए, Android फ़्रेमवर्क, टॉर्च की रोशनी को कई लेवल पर कंट्रोल करने की सुविधा देता है. Android 12 और इससे पहले के वर्शन में, फ़्रेमवर्क सिर्फ़ टॉर्च मोड को चालू या बंद करने की सुविधा देता है. टॉर्च की रोशनी को कई लेवल पर कंट्रोल करने की सुविधा की मदद से, डिवाइसों में कई तरह के इस्तेमाल के उदाहरणों को लागू किया जा सकता है. जैसे, रोशनी की स्थितियों के हिसाब से फ़्लैशलाइट की चमक को कंट्रोल करना. इसके अलावा, एक के बाद एक तेज़ी से पल्स भेजकर, स्ट्रोब इफ़ेक्ट का इस्तेमाल करके मदद के लिए सिग्नल भेजना. इस सुविधा का एक और फ़ायदा यह है कि इससे बैटरी लाइफ़ और परफ़ॉर्मेंस को बेहतर बनाया जा सकता है. ऐसा इसलिए, क्योंकि टॉर्च मोड को हमेशा सबसे ज़्यादा रोशनी पर चालू रखने की ज़रूरत नहीं होती. इससे डिवाइस के ज़्यादा गर्म होने की समस्या हो सकती है.

पब्लिक एपीआई

ऐप्लिकेशन, टॉर्च की रोशनी को कंट्रोल करने की सुविधा का इस्तेमाल, इन पब्लिक एपीआई और कैमरे की विशेषताओं की कुंजियों की मदद से कर सकते हैं. इन एपीआई के लिए, कैमरे की अनुमतियों की ज़रूरत नहीं होती, क्योंकि कैमरे का ऐक्सेस नहीं लिया जाता.

CameraManager APIs

• public void turnOnTorchWithStrengthLevel (String cameraId, int torchStrength): टॉर्च मोड में, दी गई cameraId वैल्यू से जुड़ी फ़्लैशलाइट की चमक का लेवल सेट करता है. अगर टॉर्च मोड बंद है और torchStrength की वैल्यू 1 या इससे ज़्यादा है, तो टॉर्च, torchStrength में बताए गए लेवल पर चालू हो जाती है.
• public int getTorchStrengthLevel (String cameraId): cameraId से जुड़ी फ़्लैश यूनिट की चमक का लेवल दिखाता है.

CameraCharacteristics keys

• FLASH_INFO_STRENGTH_MAXIMUM_LEVEL: चमक का सबसे ज़्यादा लेवल. कैमरा HAL, 1 से ज़्यादा वैल्यू सेट करके इस सुविधा के बारे में जानकारी देता है.
• FLASH_INFO_STRENGTH_DEFAULT_LEVEL: फ़्लैशलाइट की चमक का डिफ़ॉल्ट लेवल.

लागू करना

अपने डिवाइस पर, टॉर्च की रोशनी को कंट्रोल करने की सुविधा लागू करने के लिए, कैमरे के इन AIDL HAL इंटरफ़ेस का इस्तेमाल करें:

जगह: /camera/device/aidl/android/hardware/camera/device/ICameraDevice.aidl

• void turnOnTorchWithStrengthLevel(int torchStrength)
• int getTorchStrengthLevel()

पक्का करें कि आपका HAL लागू करने का तरीका, टॉर्च की रोशनी को कंट्रोल करने की सुविधा लागू करने के लिए, कैमरे की इन विशेषताओं की कुंजियों के बारे में जानकारी दे:

• FLASH_INFO_STRENGTH_MAXIMUM_LEVEL
• FLASH_INFO_STRENGTH_DEFAULT_LEVEL

टॉर्च की रोशनी को कंट्रोल करने की सुविधा के साथ काम करने वाले, कैमरा HAL को लागू करने के तरीके के बारे में जानने के लिए, देखें EmulatedCameraDeviceHWLImpl.cpp.

सत्यापन

टॉर्च की रोशनी को कंट्रोल करने की सुविधा को लागू करने के तरीके की पुष्टि करने के लिए, VTS और CTS के ये टेस्ट चलाएं:

• VTS: /camera/provider/aidl/vts/VtsAidlHalCameraProvider\_TargetTest.cpp
• CTS: /platform/cts/tests/camera/src/android/hardware/camera2/cts/FlashlightTest.java