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

एंड्रॉइड 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 : अधिकतम चमक स्तर। कैमरा HAL 1 से अधिक मान सेट करके इस सुविधा का विज्ञापन करता है।
  • FLASH_INFO_STRENGTH_DEFAULT_LEVEL : डिफ़ॉल्ट फ्लैशलाइट चमक स्तर।

कार्यान्वयन

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

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

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

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

मान्यकरण

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

,

एंड्रॉइड 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 : अधिकतम चमक स्तर। कैमरा HAL 1 से अधिक मान सेट करके इस सुविधा का विज्ञापन करता है।
  • FLASH_INFO_STRENGTH_DEFAULT_LEVEL : डिफ़ॉल्ट फ्लैशलाइट चमक स्तर।

कार्यान्वयन

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

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

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

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

मान्यकरण

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