बाहरी यूएसबी कैमरे

<!-- Copyright 2018 The Android Open Source Project

Apache License, वर्शन 2.0 ("लाइसेंस") के तहत लाइसेंस दिया गया है; इस फ़ाइल का इस्तेमाल, लाइसेंस से जुड़े दस्तावेज़ों में बताए गए नियमों के अलावा किसी और तरीके से नहीं किया जा सकता. लाइसेंस की कॉपी यहां से हासिल की जा सकती है

  http://www.apache.org/licenses/LICENSE-2.0

जब तक लागू कानून के तहत ज़रूरी न हो या लिखित में सहमति न दी गई हो, तब तक लाइसेंस के तहत उपलब्ध कराया गया सॉफ़्टवेयर, "जैसा है" के आधार पर उपलब्ध कराया जाता है. इसमें किसी भी तरह की वारंटी या शर्तें शामिल नहीं होती हैं, चाहे वे साफ़ तौर पर बताई गई हों या नहीं. लाइसेंस के तहत दी गई अनुमतियों और पाबंदियों की जानकारी पाने के लिए, लाइसेंस देखें. -->

Android प्लैटफ़ॉर्म, स्टैंडर्ड Android Camera2 API और कैमरे के एचएएल इंटरफ़ेस का इस्तेमाल करके, प्लग-ऐंड-प्ले यूएसबी कैमरों (यानी वेबकैम) के इस्तेमाल के साथ काम करता है. वेबकैम आम तौर पर, यूएसबी वीडियो क्लास (यूवीसी) ड्राइवर के साथ काम करते हैं. वहीं, Linux पर यूवीसी कैमरों को कंट्रोल करने के लिए, स्टैंडर्ड Video4Linux (V4L) ड्राइवर का इस्तेमाल किया जाता है.

वेबकैम की सुविधा की मदद से, डिवाइसों का इस्तेमाल वीडियो चैट और फ़ोटो कीऑस्क जैसे आसान कामों के लिए किया जा सकता है. यह सुविधा, Android फ़ोन पर मौजूद सामान्य इंटरनल कैमरा एचएएल की जगह नहीं लेती. साथ ही, इसे परफ़ॉर्मेंस-इंटेंसिव और मुश्किल टास्क के लिए डिज़ाइन नहीं किया गया है. जैसे, हाई रिज़ॉल्यूशन और तेज़ स्पीड वाली स्ट्रीमिंग, एआर, और मैन्युअल आईएसपी/सेंसर/लेंस कंट्रोल.

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

उदाहरण और सोर्स

यूएसबी कैमरे इस्तेमाल करने के तरीके के बारे में ज़्यादा जानने के लिए, बाहरी कैमरे की सेवा देने वाली कंपनी के रेफ़रंस के तौर पर लागू करने का तरीका देखें. इसके लिए, ExternalCameraProvider पर जाएं. बाहरी कैमरा डिवाइस और सेशन को लागू करने की सुविधा, ExternalCameraDevice और ExternalCameraDeviceSession में शामिल है. एपीआई लेवल 28 से, Java क्लाइंट एपीआई में EXTERNAL हार्डवेयर लेवल शामिल है.

लागू करना

लागू किए गए सिस्टम में, android.hardware.usb.host सिस्टम की सुविधा काम करनी चाहिए.

यूवीसी डिवाइसों के लिए, कर्नल सपोर्ट भी चालू होना चाहिए. इसे चालू करने के लिए, संबंधित कर्नेल defconfig फ़ाइलों में यह जोड़ें.

+CONFIG_USB_VIDEO_CLASS=y
+CONFIG_MEDIA_USB_SUPPORT=y

ध्यान दें: पक्का करें कि आपके पास यूवीसी वीडियो के लिए यह पैच भी हो.

डिवाइस के बिल्ड में बाहरी कैमरे की सेवा देने वाली कंपनी को चालू करने के लिए, यहां दिया गया तरीका अपनाएं. इससे SELinux की ज़रूरी अनुमतियां, बाहरी कैमरे का कॉन्फ़िगरेशन, और बाहरी कैमरे की सेवा देने वाली कंपनी पर निर्भरता जुड़ जाती है:

• बाहरी कैमरे की कॉन्फ़िगरेशन फ़ाइल और बाहरी कैमरे की लाइब्रेरी को device.mk में जोड़ें.

  +PRODUCT_PACKAGES += android.hardware.camera.provider-V1-external-service
  
  +PRODUCT_COPY_FILES += \
  +device/manufacturerX/productY/external_camera_config.xml:$(TARGET_COPY_OUT_VENDOR)/etc/external_camera_config.xml
  

• डिवाइस के Treble एचएएल मेनिफ़ेस्ट में, बाहरी कैमरे की सेवा देने वाली कंपनी का नाम जोड़ें.

  <hal format="aidl">
      <name>android.hardware.camera.provider</name>
      <version>1</version>
      <interface>
          <name>ICameraProvider</name>
          <instance>internal/0</instance>
  +       <instance>external/0</instance>
      </interface>
  </hal>
  

• डिवाइस की sepolicy/service_contexts फ़ाइल में, external/0 AIDL कैमरा प्रोवाइडर इंस्टेंस को hal_camera_service से बाइंड करें. ज़्यादा जानकारी के लिए, एआईडीएल एचएएल के लिए SEPolicy देखें.

  android.hardware.camera.provider.ICameraProvider/external/0 u:object_r:hal_camera_service:s0
  

• (ज़रूरी नहीं) अगर डिवाइस, Treble पासथ्रू मोड में काम करता है, तो sepolicy को अपडेट करें, ताकि cameraserver यूवीसी कैमरे को ऐक्सेस कर सके.

  +# for external camera
  +allow cameraserver device:dir r_dir_perms;
  +allow cameraserver video_device:dir r_dir_perms;
  +allow cameraserver video_device:chr_file rw_file_perms;
  

यहां external_camera_config.xml का एक उदाहरण दिया गया है. इसमें कॉपीराइट की लाइनें शामिल नहीं हैं.

<ExternalCamera>
    <Provider>
        <ignore> <!-- Internal video devices to be ignored by external camera HAL -->
            <id>0</id> <!-- No leading/trailing spaces -->
            <id>1</id>
        </ignore>
    </Provider>
    <!-- See ExternalCameraUtils.cpp for default values of Device configurations below -->
    <Device>
        <!-- Max JPEG buffer size in bytes-->
        <MaxJpegBufferSize bytes="3145728"/> <!-- 3MB (~= 1080p YUV420) -->
        <!-- Size of v4l2 buffer queue when streaming >= 30fps -->
        <!-- Larger value: more request can be cached pipeline (less janky)  -->
        <!-- Smaller value: use less memory -->
        <NumVideoBuffers count="4"/>
        <!-- Size of v4l2 buffer queue when streaming < 30fps -->
        <NumStillBuffers count="2"/>

        <!-- List of maximum fps for various output sizes -->
        <!-- Any image size smaller than the size listed in Limit row will report
            fps (as minimum frame duration) up to the fpsBound value. -->
        <FpsList>
            <!-- width/height must be increasing, fpsBound must be decreasing-->
            <Limit width="640" height="480" fpsBound="30.0"/>
            <Limit width="1280" height="720" fpsBound="15.0"/>
            <Limit width="1920" height="1080" fpsBound="10.0"/>
            <!-- image size larger than the last entry will not be supported-->
        </FpsList>
    </Device>
</ExternalCamera>

पसंद के मुताबिक बनाएं

Android कैमरे को बेहतर बनाने के लिए, पसंद के मुताबिक बनाने के सामान्य विकल्पों या डिवाइस के हिसाब से ऑप्टिमाइज़ेशन का इस्तेमाल किया जा सकता है.

सामान्य कस्टमाइज़ेशन

external_camera_config.xml फ़ाइल में बदलाव करके, बाहरी कैमरे की सेवा देने वाली कंपनी को अपनी पसंद के मुताबिक बनाया जा सकता है. खास तौर पर, क्लाइंट इन पैरामीटर को अपनी पसंद के मुताबिक बना सकते हैं:

• इंटरनल कैमरों के वीडियो नोड को बाहर रखना
• इमेज का साइज़ और फ़्रेम रेट की ज़्यादा से ज़्यादा सीमा
• इनफ़्लाइट बफ़र की संख्या (जैंक बनाम मेमोरी ट्रेडऑफ़)

इन पैरामीटर के अलावा, आपके पास अपने पैरामीटर जोड़ने या अपना कॉन्फ़िगरेशन बनाने का विकल्प भी होता है.

डिवाइस के हिसाब से ऑप्टिमाइज़ेशन

डिवाइस के हिसाब से ऑप्टिमाइज़ेशन जोड़कर भी परफ़ॉर्मेंस को बेहतर बनाया जा सकता है.

बफ़र कॉपी/स्केलिंग और JPEG डिकोड/एन्कोड

सामान्य तौर पर, सीपीयू (libyuv/libjpeg) का इस्तेमाल किया जाता है. हालांकि, इसे डिवाइस के हिसाब से ऑप्टिमाइज़ेशन से बदला जा सकता है.

एचएएल आउटपुट फ़ॉर्मैट

जेनरिक इंप्लिमेंटेशन में, इन आउटपुट फ़ॉर्मैट का इस्तेमाल किया जाता है:

• YUV_420_888 के लिए वीडियो IMPLEMENTATION_DEFINED बफ़र हो रहा है
• अन्य सभी IMPLEMENTATION_DEFINED बफ़र के लिए YUV12

परफ़ॉर्मेंस को बेहतर बनाने के लिए, आउटपुट फ़ॉर्मैट को डिवाइस के हिसाब से बेहतर फ़ॉर्मैट से बदला जा सकता है. पसंद के मुताबिक लागू करने की सुविधा में, अन्य फ़ॉर्मैट भी इस्तेमाल किए जा सकते हैं

सत्यापन

बाहरी कैमरे की सुविधा वाले डिवाइसों को कैमरा सीटीएस पास करना होगा. टेस्ट रन के दौरान, बाहरी यूएसबी वेबकैम को उस डिवाइस से कनेक्ट रखना ज़रूरी है. ऐसा न करने पर, कुछ टेस्ट केस फ़ेल हो जाएंगे.

ध्यान दें: media_profiles एंट्री, बाहरी यूएसबी वेबकैम के लिए उपलब्ध नहीं हैं. इसलिए, कैमकॉर्डर प्रोफ़ाइल मौजूद नहीं हैं.