साथी डिवाइस की प्रोफ़ाइलें

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

साथी डिवाइस की प्रोफ़ाइल इस्तेमाल करने के लिए, साथी ऐप्लिकेशन को इन शर्तों को पूरा करना होगा ज़रूरतें:

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

हर साथी डिवाइस प्रोफ़ाइल एक Android भूमिका से जुड़ी होती है. ज़्यादा के लिए हर खाते के मालिक की भूमिका और अनुमतियों के बारे में जानकारी प्रोफ़ाइल, तो तीसरे पक्ष के ऐप्लिकेशन के लिए साथी डिवाइस प्रोफ़ाइल देखें.

साथी डिवाइसों के बारे में ज़्यादा जानकारी के लिए, इसे देखें दूसरे डिवाइस से जोड़ना.

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

इस सेक्शन में, साथी डिवाइस प्रोफ़ाइल इस्तेमाल किए जाने पर डिवाइस के व्यवहार के बारे में बताया गया है.

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

डिवाइस की प्रोफ़ाइल का डायलॉग बॉक्स देखें

पहला डायग्राम. स्मार्टवॉच की प्रोफ़ाइल के लिए अनुमतियों का अनुरोध करने वाला डायलॉग बॉक्स.

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

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

तीसरे पक्ष के ऐप्लिकेशन के लिए, साथ-साथ काम करने वाले डिवाइस की प्रोफ़ाइलें

स्मार्टवॉच की प्रोफ़ाइल

स्मार्टवॉच की प्रोफ़ाइल को Android 12 के लिए उपलब्ध कराया गया है.

नीचे दिए गए टेबल में, COMPANION_DEVICE_WATCH डिवाइस प्रोफ़ाइल और उनका इस्तेमाल करने से जुड़ी ज़रूरी शर्तों के बारे में जानकारी.

अनुमतियां साथी ऐप्लिकेशन और डिवाइस से जुड़ी ज़रूरी शर्तें
सूचनाएं

अभी तक किसी भी व्यक्ति ने चेक इन नहीं किया है BIND_NOTIFICATION_LISTENER_SERVICE

POST_NOTIFICATIONS (added in Android 15)
  • ब्लूटूथ और/या वाई-फ़ाई का इस्तेमाल करके कनेक्ट किया गया डिवाइस होना चाहिए
  • इसमें स्क्रीन पर सूचनाएं दिखाने की सुविधा हो (इन डिवाइस का इस्तेमाल किया जा सकता है) स्क्रीन के बजाय हैप्टिक की कैटगरी उपलब्ध नहीं है)
  • यह ऐप्लिकेशन इस्तेमाल करने वाले लोगों को सूचना देता है. उदाहरण के लिए, डिसप्ले साथी डिवाइस की स्क्रीन पर, फ़ोन पर मिलने वाली सूचनाओं को दिखाता है.
  • डिवाइस मैनेजमेंट के लिए फ़ोन पर मिलने वाली सूचनाएं पोस्ट करता है. उदाहरण के लिए, जब कोई स्मार्टवॉच कनेक्ट है या कोई सुविधा चालू है.
Phone
  • ब्लूटूथ और/या वाई-फ़ाई का इस्तेमाल करके कनेक्ट किया गया डिवाइस होना चाहिए
  • इसमें पहले से माइक्रोफ़ोन और स्पीकर है, जो बोलकर बातचीत करने की सुविधा देता है
  • इसमें एक स्क्रीन है, जो कॉलर की जानकारी दिखाती है
  • यह ऐप्लिकेशन, उपयोगकर्ता के लिए फ़ोन कॉल करने की सुविधा देता है (कंपैनियन ऐप्लिकेशन की मदद से कॉल किए जा सकते हैं)
SMS
  • ब्लूटूथ और/या वाई-फ़ाई का इस्तेमाल करके कनेक्ट किया गया डिवाइस होना चाहिए
  • डिवाइस पर एसएमएस मैसेज दिख रहे हों
  • उपयोगकर्ता को एसएमएस भेजने की सुविधा दें
Contacts
  • ब्लूटूथ और/या वाई-फ़ाई का इस्तेमाल करके कनेक्ट किया गया डिवाइस होना चाहिए
  • डिसप्ले स्क्रीन है
  • जिनमें कॉल या मैसेज करते समय संपर्क जानकारी का इस्तेमाल किया जाता हो
Calendar
  • ब्लूटूथ और/या वाई-फ़ाई का इस्तेमाल करके कनेक्ट किया गया डिवाइस होना चाहिए
  • डिसप्ले स्क्रीन है
  • स्मार्टवॉच पर, उपयोगकर्ताओं के लिए कैलेंडर का अनुभव पाएं
Nearby devices
  • ब्लूटूथ और/या वाई-फ़ाई का इस्तेमाल करके कनेक्ट किया गया डिवाइस होना चाहिए
  • डिसप्ले स्क्रीन है
  • स्मार्टवॉच पर, उपयोगकर्ता को फ़ोन को दूसरे डिवाइस से जोड़ने/कनेक्ट करने की सुविधा दें
eSIM provisioning
  • ब्लूटूथ और/या वाई-फ़ाई का इस्तेमाल करके कनेक्ट किया गया डिवाइस होना चाहिए
  • डिसप्ले स्क्रीन है
  • उपयोगकर्ताओं को ऐसा अनुभव देना जिससे उनकी सेवाओं को मैनेज किया जा सके मोबाइल और इंटरनेट सेवा देने वाली कंपनी से, स्मार्ट वॉच पर
Managing ongoing calls
  • ब्लूटूथ और/या वाई-फ़ाई का इस्तेमाल करके कनेक्ट किया गया डिवाइस होना चाहिए
  • इसमें पहले से माइक्रोफ़ोन और स्पीकर है, जो बोलकर बातचीत करने की सुविधा देता है
  • इसमें एक स्क्रीन है, जो कॉलर की जानकारी दिखाती है
  • यह ऐप्लिकेशन, उपयोगकर्ता के लिए फ़ोन कॉल करने की सुविधा देता है (कंपैनियन ऐप्लिकेशन की मदद से कॉल किए जा सकते हैं)

Glasses प्रोफ़ाइल

Glasses प्रोफ़ाइल को Android 14 में पेश किया गया था.

नीचे दिए गए टेबल में, COMPANION_DEVICE_GLASSES डिवाइस प्रोफ़ाइल और उनका इस्तेमाल करने से जुड़ी ज़रूरी शर्तों के बारे में जानकारी.

अनुमतियां साथी ऐप्लिकेशन और डिवाइस से जुड़ी ज़रूरी शर्तें
सूचनाएं

अभी तक किसी भी व्यक्ति ने चेक इन नहीं किया है BIND_NOTIFICATION_LISTENER_SERVICE

POST_NOTIFICATIONS
  • ब्लूटूथ और/या वाई-फ़ाई का इस्तेमाल करके कनेक्ट किया गया डिवाइस होना चाहिए
  • इसमें स्क्रीन पर सूचनाएं दिखाने की सुविधा हो (इन डिवाइस का इस्तेमाल किया जा सकता है) स्क्रीन के बजाय हैप्टिक की कैटगरी उपलब्ध नहीं है)
  • यह ऐप्लिकेशन इस्तेमाल करने वाले लोगों को सूचना देता है. उदाहरण के लिए, डिसप्ले साथी डिवाइस की स्क्रीन पर, फ़ोन पर मिलने वाली सूचनाओं को दिखाता है.
  • डिवाइस मैनेजमेंट के लिए, फ़ोन पर मिलने वाली सूचनाओं को पोस्ट करता है. उदाहरण के लिए, चश्मे वाला डिवाइस कनेक्ट होने पर या कोई खास सुविधा चालू होने पर.
Phone
  • ब्लूटूथ और/या वाई-फ़ाई का इस्तेमाल करके कनेक्ट किया गया डिवाइस होना चाहिए
  • इसमें पहले से माइक्रोफ़ोन और स्पीकर है, जो बोलकर बातचीत करने की सुविधा देता है
  • इसमें एक स्क्रीन है, जो कॉलर की जानकारी दिखाती है
  • यह ऐप्लिकेशन, उपयोगकर्ता के लिए फ़ोन कॉल करने की सुविधा देता है (कंपैनियन ऐप्लिकेशन की मदद से कॉल किए जा सकते हैं)
SMS
  • ब्लूटूथ और/या वाई-फ़ाई का इस्तेमाल करके कनेक्ट किया गया डिवाइस होना चाहिए
  • डिवाइस पर एसएमएस मैसेज दिख रहे हों
  • उपयोगकर्ता को एसएमएस भेजने की सुविधा दें
Contacts
  • ब्लूटूथ और/या वाई-फ़ाई का इस्तेमाल करके कनेक्ट किया गया डिवाइस होना चाहिए
  • डिसप्ले स्क्रीन है
  • जिनमें कॉल या मैसेज करते समय संपर्क जानकारी का इस्तेमाल किया जाता हो
Microphone
  • ब्लूटूथ और/या वाई-फ़ाई का इस्तेमाल करके कनेक्ट किया गया डिवाइस होना चाहिए
  • डिसप्ले स्क्रीन है
  • चश्मे पर उपयोगकर्ता के सामने वाले माइक्रोफ़ोन का अनुभव प्रदान करता है
Nearby devices
  • ब्लूटूथ और/या वाई-फ़ाई का इस्तेमाल करके कनेक्ट किया गया डिवाइस होना चाहिए
  • डिसप्ले स्क्रीन है
  • चश्मों पर उपयोगकर्ता को जोड़ने/कनेक्ट करने का अनुभव देता है
Managing ongoing calls
  • ब्लूटूथ और/या वाई-फ़ाई का इस्तेमाल करके कनेक्ट किया गया डिवाइस होना चाहिए
  • इसमें पहले से माइक्रोफ़ोन और स्पीकर है, जो बोलकर बातचीत करने की सुविधा देता है
  • इसमें एक स्क्रीन है, जो कॉलर की जानकारी दिखाती है
  • यह ऐप्लिकेशन, उपयोगकर्ता के लिए फ़ोन कॉल करने की सुविधा देता है (कंपैनियन ऐप्लिकेशन की मदद से कॉल किए जा सकते हैं)

लागू करना

तीसरे पक्ष के ऐसे डेवलपर के लिए जो ऐसा साथी ऐप्लिकेशन लागू करते हों जो DEVICE_PROFILE_WATCH तो ये काम करें:

  1. कॉल करें setDeviceProfile तरीका.

  2. कोई प्रोफ़ाइल पास करें (उदाहरण के लिए, DEVICE_PROFILE_WATCH जब लोग, AssociationRequest.

डिवाइस बनाने वाली कंपनियों के लिए, जो किसी खास ऐप्लिकेशन को इंस्टॉल करने के बाद, तो प्रमाणित करने के लिए इन ज़रूरी 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_COMPANION_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 किसी एक कंपैनियन डिवाइस से असोसिएशन का अनुरोध करने के लिए.

पुष्टि करें

साथी डिवाइस प्रोफ़ाइल की सुविधा के काम करने के तरीके की जांच करने के लिए, सीटीएस का इस्तेमाल करें में जांच cts/tests/tests/companion/.