सहयोगी उपकरण प्रोफाइल

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

सहयोगी डिवाइस प्रोफ़ाइल का उपयोग केवल उन डिवाइस निर्माताओं के लिए उपलब्ध है जिनके पास सहयोगी डिवाइस हैं। सहयोगी उपकरणों के लिए सुविधा तक पहुंच प्राप्त करने के लिए, उन्हें आवश्यकताओं को पूरा करना होगा और स्वीकृत होना चाहिए।

निम्न सहयोगी डिवाइस प्रोफ़ाइल प्रकार Android 12 में उपलब्ध हैं: COMPANION_DEVICE_WATCH

सहयोगी उपकरणों के बारे में अधिक जानकारी के लिए, सहयोगी उपकरण युग्मन देखें।

डिवाइस व्यवहार

यह खंड डिवाइस व्यवहार का वर्णन करता है जब सहयोगी डिवाइस प्रोफ़ाइल का उपयोग किया जाता है।

जब कोई उपयोगकर्ता किसी सहयोगी डिवाइस के साथ संबद्धता बनाने के लिए ऐप के अनुरोध को स्वीकार करता है, तो CompanionDeviceManager (CDM) सेवा सहयोगी डिवाइस के कनेक्ट होने की प्रतीक्षा करती है, और जब यह कनेक्ट होता है, तो CDM डिवाइस प्रोफ़ाइल भूमिका (उदाहरण के लिए, वॉच) को असाइन करता है। सहयोगी ऐप, उस निर्दिष्ट प्रोफ़ाइल भूमिका के लिए परिभाषित सभी अनुमतियां प्रदान करता है। चित्र 1 COMPANION_DEVICE_WATCH डिवाइस प्रोफ़ाइल के लिए अनुमतियों का अनुरोध करने वाले ऐप का एक उदाहरण दिखाता है।

डिवाइस प्रोफ़ाइल देखें संवाद संकेत

चित्र 1. घड़ी डिवाइस प्रोफ़ाइल के लिए अनुमतियों का अनुरोध करने वाला संवाद।

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

उपयोगकर्ता द्वारा किसी विशेष डिवाइस प्रोफ़ाइल के लिए अनुमतियां प्रदान करने के लिए ऐप के अनुरोध को स्वीकार करने के बाद, उपयोगकर्ता दी गई व्यक्तिगत अनुमतियों को रद्द कर सकता है। जब किसी उपयोगकर्ता द्वारा अनुमति रद्द कर दी जाती है, तो ऐप सहयोगी डिवाइस से जुड़ा रहता है लेकिन कुछ सुविधाएं अनुपलब्ध हो सकती हैं। यदि ऐप को काम करने के लिए अनुमति की आवश्यकता है, तो ऐप को सामान्य अनुमति अनुरोध के माध्यम से अनुमति का अनुरोध करना होगा।

आवश्यकताएं

सहयोगी ऐप के लिए सहयोगी डिवाइस प्रोफ़ाइल एपीआई तक पहुंच प्राप्त करने के लिए, ऐप को निम्नलिखित आवश्यकताओं को पूरा करना होगा:

  • एक साथी उपकरण रखें (उदाहरण के लिए, एक स्मार्टवॉच)।
  • सहयोगी डिवाइस प्रोफ़ाइल के लिए परिभाषित अनुमतियों की आवश्यकता के लिए एक वैध कारण है।

साथी डिवाइस प्रोफ़ाइल की आवश्यकताएं देखें

निम्न तालिका COMPANION_DEVICE_WATCH डिवाइस प्रोफ़ाइल भूमिका के लिए परिभाषित अनुमतियों और उनका उपयोग करने की आवश्यकताओं का वर्णन करती है।

अनुमतियां सहयोगी ऐप और डिवाइस की आवश्यकताएं
सूचनाएं

BIND_NOTIFICATION_LISTENER_SERVICE
  • ब्लूटूथ और/या वाई-फ़ाई का उपयोग करके कनेक्टेड डिवाइस बनें
  • सूचनाएं प्रदर्शित करने में सक्षम स्क्रीन है (वे उपकरण जो स्क्रीन के बजाय हैप्टिक्स का उपयोग करते हैं, उन्हें बाहर रखा गया है)
  • एक उपयोगकर्ता-सामना करने वाला अधिसूचना अनुभव प्रदान करता है, उदाहरण के लिए, सहयोगी डिवाइस स्क्रीन पर फोन अधिसूचनाएं प्रदर्शित करना
फ़ोन

phone
  • ब्लूटूथ और/या वाई-फ़ाई का उपयोग करके कनेक्टेड डिवाइस बनें
  • एक अंतर्निहित माइक्रोफ़ोन और स्पीकर है जो ध्वनि वार्तालाप को सक्षम बनाता है
  • एक स्क्रीन है जो कॉलर की जानकारी प्रदर्शित करती है
  • एक उपयोगकर्ता-सामना करने वाला फोन कॉलिंग अनुभव प्रदान करता है (साथी ऐप ब्रिज फोन कॉल)
एसएमएस

sms
  • ब्लूटूथ और/या वाई-फ़ाई का उपयोग करके कनेक्टेड डिवाइस बनें
  • एक स्क्रीन है जो एसएमएस संदेश प्रदर्शित करती है
  • एक उपयोगकर्ता-सामना करने वाला एसएमएस अनुभव प्रदान करें
संपर्क

contacts
  • ब्लूटूथ और/या वाई-फ़ाई का उपयोग करके कनेक्टेड डिवाइस बनें
  • एक डिस्प्ले स्क्रीन है
  • कॉलिंग या मैसेजिंग अनुभव के हिस्से के रूप में संपर्क जानकारी का उपयोग करता है
पंचांग

calendar
  • ब्लूटूथ और/या वाई-फ़ाई का उपयोग करके कनेक्टेड डिवाइस बनें
  • एक डिस्प्ले स्क्रीन है
  • घड़ी पर उपयोगकर्ता के अनुकूल कैलेंडर अनुभव प्रदान करें
निकट के उपकरण

nearby_devices
  • ब्लूटूथ और/या वाई-फ़ाई का उपयोग करके कनेक्टेड डिवाइस बनें
  • एक डिस्प्ले स्क्रीन है
  • घड़ी पर उपयोगकर्ता के अनुकूल पेयरिंग/कनेक्टिंग अनुभव प्रदान करें
eSIM प्रावधान

USE_ICC_AUTH_WITH_DEVICE_IDENTIFIER
  • ब्लूटूथ और/या वाई-फ़ाई का उपयोग करके कनेक्टेड डिवाइस बनें
  • एक डिस्प्ले स्क्रीन है
  • एक उपयोगकर्ता-सामना करने वाला अनुभव प्रदान करें जो घड़ी पर वाहक से ग्राहक की सेवाओं का प्रबंधन करता है
चल रही कॉलों को प्रबंधित करना

MANAGE_ONGOING_CALLS
  • ब्लूटूथ और/या वाई-फ़ाई का उपयोग करके कनेक्टेड डिवाइस बनें
  • एक अंतर्निहित माइक्रोफ़ोन और स्पीकर है जो ध्वनि वार्तालाप को सक्षम बनाता है
  • एक स्क्रीन है जो कॉलर की जानकारी प्रदर्शित करती है
  • एक उपयोगकर्ता-सामना करने वाला फोन कॉलिंग अनुभव प्रदान करता है (साथी ऐप ब्रिज फोन कॉल)

पहुंच प्राप्त करना

ऐप्स को सहयोगी डिवाइस प्रोफ़ाइल तक पहुंच प्राप्त करने के लिए, उन्हें स्वीकृत होना चाहिए और एक अनुमति सूची में जोड़ा जाना चाहिए। जब अनुमति सूची में जोड़े जाने का अनुरोध प्राप्त होता है, तो Android टीम यह सुनिश्चित करने के लिए ऐप की समीक्षा करती है कि यह संबंधित सहयोगी डिवाइस प्रोफ़ाइल की आवश्यकताओं को पूरा करता है।

कार्यान्वयन

एक विशिष्ट डिवाइस के साथ एक साथी ऐप को लागू करने वाले डिवाइस निर्माताओं के लिए, साथी ऐप को प्रमाणित करने के लिए निम्नलिखित आवश्यक एंड्रॉइड सिस्टम कॉन्फ़िगरेशन का उपयोग करें, जो ऐप को उपयोगकर्ताओं के लिए सीडीएम प्रॉम्प्ट प्रदर्शित करने की अनुमति देता है।

  1. निम्न आदेश का उपयोग कर प्रमाण पत्र पुनर्प्राप्त करें:

    keytool  -printcert -jarfile PATH/TO/APK
    
  2. कॉन्फ़िगरेशन फ़ाइल में निम्न नमूना इनपुट में दिखाए गए अनुसार पैकेज का नाम और प्रमाणपत्र बदलें:

    <!-- A list of packages managing companion device(s) by the same manufacturers as the main device.
    It will not create the association without prompting if the association has been called multiple
    times in a short period. Note that config_companionDeviceManagerPackage and config_companionDeviceCerts
    are parallel arrays. -->
    
        <string-array name="config_companionDevicePackages" translatable="false">
            <item>YOUR_COMAPNION_APP_PACKAGE_NAME</item>
        </string-array>
    
        <!-- A list of SHA256 Certificates managing companion device(s) by the same manufacturers as the
        main device. It will fall back to showing a prompt if the association has been called multiple
        times in a short period. Note that config_companionDeviceCerts and config_companionDeviceManagerPackage
        are parallel arrays.
        Example: "1A:2B:3C:4D" -->
    
        <string-array name="config_companionDeviceCerts" translatable="false">
            <item>YOUR_COMPANION_APP_CERTIFICATE</item>
        </string-array>
    
  3. किसी एकल सहयोगी डिवाइस से संबद्धता अनुरोध करने के लिए AssociationRequest का उपयोग करें।

DEVICE_PROFILE_WATCH प्रोफ़ाइल का अनुरोध करने वाले सहयोगी ऐप को लागू करने वाले तृतीय-पक्ष डेवलपर के लिए, निम्न कार्य करें:

  1. setDeviceProfile विधि को कॉल करें।
  2. AssociationRequest रिक्वेस्ट बनाते समय DEVICE_PROFILE_WATCH प्रोफाइल में पास करें।

मान्यकरण

सहयोगी डिवाइस प्रोफ़ाइल सुविधा के व्यवहार का परीक्षण करने के लिए, निम्नलिखित सीटीएस परीक्षणों का उपयोग करें: