कंपेनियन डिवाइस प्रोफ़ाइल, एंड्रॉइड 12 में पेश की गई, एक ऐसी सुविधा है जो सहयोगी ऐप्स को सहयोगी डिवाइस के प्रकार के लिए विशिष्ट अनुमतियों के एक सेट का अनुरोध करने की अनुमति देती है, उदाहरण के लिए, एक स्मार्टवॉच। एक साथी डिवाइस प्रोफ़ाइल का उपयोग करने से नामांकन प्रक्रिया सरल हो जाती है, जिससे ऐप्स को अपने मोबाइल डिवाइस पर उपयोगकर्ताओं को व्यक्तिगत रूप से अनुमतियों का अनुरोध करने वाले एकाधिक संकेतों के बजाय अनुमतियों के एक परिभाषित सेट का अनुरोध करने के लिए एक संकेत प्रदर्शित करने की अनुमति मिलती है। यह अधिक सुव्यवस्थित सेटअप अनुभव और साथी ऐप्स के लिए बेहतर ऑप्ट-इन दरों की अनुमति दे सकता है।
सहयोगी डिवाइस प्रोफ़ाइल का उपयोग करने के लिए, सहयोगी ऐप्स को निम्नलिखित आवश्यकताओं को पूरा करना होगा:
- एक सहयोगी डिवाइस प्रबंधित करें (उदाहरण के लिए, एक स्मार्टवॉच)।
- ऐप सुविधाएं रखें या एंड्रॉइड एपीआई कॉल करें जिसके लिए सहयोगी डिवाइस प्रोफ़ाइल के लिए परिभाषित सभी अनुमतियों की आवश्यकता होती है।
प्रत्येक सहयोगी डिवाइस प्रोफ़ाइल एक Android भूमिका से मेल खाती है। प्रत्येक प्रोफ़ाइल की अनुमतियों और संबंधित Android भूमिका के बारे में अधिक जानकारी के लिए, तृतीय-पक्ष ऐप्स के लिए सहयोगी डिवाइस प्रोफ़ाइल देखें।
सहयोगी डिवाइस के बारे में अधिक जानकारी के लिए, सहयोगी डिवाइस पेयरिंग देखें।
डिवाइस व्यवहार
यह अनुभाग डिवाइस के व्यवहार का वर्णन करता है जब सहयोगी डिवाइस प्रोफ़ाइल का उपयोग किया जाता है।
जब कोई उपयोगकर्ता किसी सहयोगी डिवाइस के साथ संबंध बनाने के लिए किसी ऐप के अनुरोध को स्वीकार करता है, तो CompanionDeviceManager (CDM) सेवा उस निर्दिष्ट प्रोफ़ाइल भूमिका के लिए परिभाषित सभी अनुमतियाँ प्रदान करते हुए, सहयोगी ऐप को डिवाइस प्रोफ़ाइल भूमिका (उदाहरण के लिए, घड़ी) सौंपती है। चित्र 1 COMPANION_DEVICE_WATCH डिवाइस प्रोफ़ाइल के लिए अनुमति का अनुरोध करने वाले ऐप का एक उदाहरण दिखाता है।
चित्र 1. वॉच डिवाइस प्रोफ़ाइल के लिए अनुमतियों का अनुरोध करने वाला संवाद।
जब कोई उपयोगकर्ता सेटिंग्स में पैकेज डेटा साफ़ करता है या सहयोगी ऐप में सभी डिवाइस हटा देता है, तो सीडीएम प्रोफ़ाइल को रद्द कर देता है, जबकि ऐप अग्रभूमि में नहीं चल रहा है और न ही अग्रभूमि सेवा चल रही है। प्रोफ़ाइल को रद्द करने से प्रोफ़ाइल के लिए सभी परिभाषित अनुमतियाँ भी रद्द हो जाती हैं।
किसी उपयोगकर्ता द्वारा किसी विशेष डिवाइस प्रोफ़ाइल के लिए अनुमति देने के लिए ऐप के अनुरोध को स्वीकार करने के बाद, उपयोगकर्ता दी गई व्यक्तिगत अनुमतियों को रद्द कर सकता है। जब किसी उपयोगकर्ता द्वारा अनुमति रद्द कर दी जाती है, तो ऐप सहयोगी डिवाइस से संबद्ध रहता है लेकिन कुछ सुविधाएं अनुपलब्ध हो सकती हैं। यदि ऐप को कार्य करने के लिए अनुमति की आवश्यकता है, तो ऐप को सामान्य अनुमति अनुरोध के माध्यम से अनुमति का अनुरोध करना होगा।
तृतीय-पक्ष ऐप्स के लिए सहयोगी डिवाइस प्रोफ़ाइल
प्रोफ़ाइल देखें
वॉच प्रोफाइल को एंड्रॉइड 12 में पेश किया गया है।
निम्न तालिका COMPANION_DEVICE_WATCH डिवाइस प्रोफ़ाइल के लिए परिभाषित अनुमतियों और उनके उपयोग की आवश्यकताओं का वर्णन करती है।
| अनुमतियां | सहयोगी ऐप और डिवाइस आवश्यकताएँ |
|---|---|
सूचनाएंBIND_NOTIFICATION_LISTENER_SERVICE |
|
Phone |
|
SMS |
|
Contacts |
|
Calendar |
|
Nearby devices |
|
eSIM provisioning |
|
Managing ongoing calls |
|
चश्मा प्रोफाइल
Glasses प्रोफ़ाइल को Android 14 में पेश किया गया है।
निम्न तालिका COMPANION_DEVICE_GLASSES डिवाइस प्रोफ़ाइल के लिए परिभाषित अनुमतियों और उनके उपयोग की आवश्यकताओं का वर्णन करती है।
| अनुमतियां | सहयोगी ऐप और डिवाइस आवश्यकताएँ |
|---|---|
सूचनाएंBIND_NOTIFICATION_LISTENER_SERVICEPOST_NOTIFICATIONS |
|
Phone |
|
SMS |
|
Contacts |
|
Microphone |
|
Nearby devices |
|
Managing ongoing calls |
|
कार्यान्वयन
DEVICE_PROFILE_WATCH प्रोफ़ाइल का अनुरोध करने वाले सहयोगी ऐप को लागू करने वाले तृतीय-पक्ष डेवलपर्स के लिए, निम्न कार्य करें:
setDeviceProfileविधि को कॉल करें।प्रोफ़ाइल में पास करें (उदाहरण के लिए,
AssociationRequestबनाते समयDEVICE_PROFILE_WATCH।
डिवाइस निर्माता उपयोगकर्ता सहमति संवाद प्रदर्शित करना छोड़ देते हैं
किसी विशिष्ट डिवाइस के साथ एक सहयोगी ऐप लागू करने वाले डिवाइस निर्माताओं के लिए, सहयोगी ऐप को प्रमाणित करने के लिए निम्नलिखित आवश्यक एंड्रॉइड सिस्टम कॉन्फ़िगरेशन का उपयोग करें, जो ऐप को उपयोगकर्ताओं के लिए उपयोगकर्ता सहमति संवाद प्रदर्शित करना छोड़ने की अनुमति देता है।
निम्नलिखित आदेश का उपयोग करके प्रमाणपत्र पुनः प्राप्त करें:
keytool -printcert -jarfile PATH/TO/APKकॉन्फ़िगरेशन फ़ाइल में निम्नलिखित नमूना इनपुट में दिखाए अनुसार पैकेज नाम और प्रमाणपत्र बदलें:
<!-- 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>किसी एकल सहयोगी डिवाइस के लिए एसोसिएशन अनुरोध करने के लिए
AssociationRequestउपयोग करें।
मान्यकरण
सहयोगी डिवाइस प्रोफ़ाइल सुविधा के व्यवहार का परीक्षण करने के लिए, cts/tests/tests/companion/ में CTS परीक्षणों का उपयोग करें।