मशाल शक्ति नियंत्रण

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

सार्वजनिक एपीआई

ऐप्स निम्न सार्वजनिक API और कैमरा विशेषता कुंजियों के माध्यम से मशाल शक्ति नियंत्रण सुविधा का उपयोग कर सकते हैं। इन एपीआई के लिए किसी कैमरा अनुमति की आवश्यकता नहीं है क्योंकि कैमरा एक्सेस नहीं किया गया है।

CameraManager एपीआई

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

CameraCharacteristics कुंजियाँ

  • FLASH_INFO_STRENGTH_MAXIMUM_LEVEL : अधिकतम चमक स्तर। कैमरा एचएएल 1 से अधिक मान सेट करके इस सुविधा का विज्ञापन करता है।
  • FLASH_INFO_STRENGTH_DEFAULT_LEVEL : डिफ़ॉल्ट फ्लैशलाइट चमक स्तर।

कार्यान्वयन

अपने डिवाइस पर मशाल शक्ति नियंत्रण सुविधा का समर्थन करने के लिए, निम्नलिखित कैमरा एआईडीएल एचएएल इंटरफेस का उपयोग करें:

स्थान: /camera/device/aidl/android/hardware/camera/device/ICameraDevice.aidl

सुनिश्चित करें कि आपका एचएएल कार्यान्वयन टॉर्च की चमक नियंत्रण सुविधा का समर्थन करने के लिए निम्नलिखित कैमरा विशेषता कुंजियों का विज्ञापन करता है:

टॉर्च शक्ति नियंत्रण का समर्थन करने वाले कैमरा एचएएल कार्यान्वयन के संदर्भ के लिए, EmulatedCameraDeviceHWLImpl.cpp देखें।

मान्यकरण

मशाल शक्ति नियंत्रण सुविधा के अपने कार्यान्वयन को मान्य करने के लिए, निम्नलिखित वीटीएस और सीटीएस परीक्षण चलाएँ: