Android 11 और उसके बाद के वर्शन में, क्विक ऐक्सेस डिवाइस कंट्रोल की सुविधा उपयोगकर्ता को लाइट जैसे बाहरी डिवाइसों को तुरंत देखने और कंट्रोल करने की सुविधा देता है, साथ ही, थर्मोस्टैट और उपयोगकर्ता की कीमत से तीन इंटरैक्शन के लिए कैमरे डिफ़ॉल्ट लॉन्चर. डिवाइस का OEM यह चुनता है कि उसे कौनसा लॉन्चर इस्तेमाल करना है. डिवाइस एग्रीगेटर—जैसे, Google Home और तीसरे पक्ष के वेंडर ऐप्लिकेशन इस जगह में डिसप्ले के लिए डिवाइस उपलब्ध कराएं. इस पेज में बताया गया है कि इस स्पेस में डिवाइस कंट्रोल जोड़े जा सकते हैं. साथ ही, इन्हें अपने कंट्रोल ऐप्लिकेशन से जोड़ा जा सकता है.
यह सहायता जोड़ने के लिए, ControlsProviderService
बनाएं और उसका एलान करें. अपनी ऑडियंस के लिए
पहले से तय कंट्रोल टाइप के आधार पर, आपके ऐप्लिकेशन के साथ काम करता है. इसके बाद,
इन कंट्रोल के लिए, पब्लिशर के लिए कुछ ज़रूरी शर्तें पूरी करते हैं.
उपयोगकर्ता इंटरफ़ेस
डिवाइसों को डिवाइस कंट्रोल में टेंप्लेट वाले विजेट के तौर पर दिखाया जाता है. पांच डिवाइस कंट्रोल के विजेट भी उपलब्ध हैं, जैसा कि यहां दिखाया गया है:
![]() |
![]() |
![]() |
![]() |
![]() |
टच और विजेट को दबाकर रखने से, ऐप्लिकेशन पर ज़्यादा कंट्रोल मिलता है. आप हर विजेट के आइकॉन और रंग को पसंद के मुताबिक बना सकते हैं, लेकिन सबसे अच्छे उपयोगकर्ता अनुभव के लिए, अगर डिफ़ॉल्ट सेट, डिवाइस से मेल खाता है, तो डिफ़ॉल्ट आइकॉन और रंग का इस्तेमाल करें.
![तापमान मापने वाले पैनल का विजेट दिखाने वाली इमेज (खुला है)](https://developer.android.google.cn/static/images/device-control/device-control-panel2.png?authuser=7&hl=hi)
सेवा बनाएं
इस सेक्शन में बताया गया है कि
ControlsProviderService
.
यह सेवा, Android सिस्टम के यूज़र इंटरफ़ेस (यूआई) को बताती है कि आपके ऐप्लिकेशन में डिवाइस कंट्रोल हैं
जो Android यूज़र इंटरफ़ेस (यूआई) के डिवाइस कंट्रोल सेक्शन में दिखनी चाहिए.
ControlsProviderService
एपीआई, प्रतिक्रिया वाली स्ट्रीम को समझना चाहता है, क्योंकि
Reactive Streams GitHub में तय किया गया है
प्रोजेक्ट
और Java 9 फ़्लो में लागू किया जाता है
इंटरफ़ेस के रूप में दिखाया जाता है.
एपीआई को इन सिद्धांतों के आधार पर बनाया गया है:
- प्रकाशक: आपका ऐप्लिकेशन, प्रकाशक है.
- सदस्य: सिस्टम का यूज़र इंटरफ़ेस (यूआई), सदस्य है और यह नंबर का अनुरोध कर सकता है कंट्रोल मिलता है.
- सदस्यता: वह समयसीमा जिसके दौरान पब्लिशर, अपडेट भेज सकता है सिस्टम यूज़र इंटरफ़ेस (यूआई) पर ले जाएं. पब्लिशर या सदस्य में से कोई भी इसे बंद कर सकता है विंडो.
सेवा का एलान करें
आपके ऐप्लिकेशन को किसी सेवा की जानकारी देना ज़रूरी है. जैसे, MyCustomControlService
की जानकारी
मेनिफ़ेस्ट फ़ाइल में मौजूद सभी दस्तावेज़ शामिल हैं.
सेवा में ControlsProviderService
के लिए इंटेंट फ़िल्टर शामिल होना चाहिए. यह
फ़िल्टर की मदद से, ऐप्लिकेशन सिस्टम यूज़र इंटरफ़ेस (यूआई) में कंट्रोल जोड़ सकते हैं.
आपको label
की भी ज़रूरत होगी, जो सिस्टम के यूज़र इंटरफ़ेस (यूआई) के कंट्रोल में दिखता है.
यहां दिए गए उदाहरण में, किसी सेवा का एलान करने का तरीका बताया गया है:
<service
android:name="MyCustomControlService"
android:label="My Custom Controls"
android:permission="android.permission.BIND_CONTROLS"
android:exported="true"
>
<intent-filter>
<action android:name="android.service.controls.ControlsProviderService" />
</intent-filter>
</service>
इसके बाद, MyCustomControlService.kt
नाम की नई Kotlin फ़ाइल बनाएं और इसे
ControlsProviderService()
को आगे बढ़ाएं:
Kotlin
class MyCustomControlService : ControlsProviderService() { ... }
Java
public class MyCustomJavaControlService extends ControlsProviderService { ... }
कंट्रोल का सही टाइप चुनें
एपीआई, कंट्रोल बनाने के लिए बिल्डर तरीके उपलब्ध कराता है. को पॉप्युलेट करने के लिए बिल्डर, वह डिवाइस तय करें जिसे आपको कंट्रोल करना है. साथ ही, यह भी तय करें कि उपयोगकर्ता कैसे इंटरैक्ट करे उसके साथ. यह तरीका अपनाएं:
- कंट्रोल से जिस तरह का डिवाइस दिखाया जा रहा है उसे चुनें. कॉन्टेंट बनाने
DeviceTypes
क्लास काम करने वाले सभी डिवाइसों की सूची. टाइप का इस्तेमाल यह तय करने के लिए किया जाता है कि यूज़र इंटरफ़ेस (यूआई) में डिवाइस के आइकॉन और रंग. - उपयोगकर्ता को दिखने वाला नाम और डिवाइस की जगह की जानकारी तय करना—उदाहरण के लिए, किचन—और कंट्रोल से जुड़े अन्य यूज़र इंटरफ़ेस (यूआई) टेक्स्ट एलिमेंट.
- उपयोगकर्ता इंटरैक्शन की सुविधा देने के लिए सबसे सही टेंप्लेट चुनें. कंट्रोल, असाइन किए गए
ControlTemplate
से हटा दें. यह टेंप्लेट, उपयोगकर्ता, आपके लिए उपलब्ध इनपुट के तरीकों—यानी,ControlAction
. नीचे दी गई टेबल में, कुछ उपलब्ध टेंप्लेट और कार्रवाइयों के बारे में बताया गया है ये सुविधाएं इस तरह से काम करती हैं:
टेंप्लेट | कार्रवाई | ब्यौरा |
ControlTemplate.getNoTemplateObject()
|
None
|
ऐप्लिकेशन इसका इस्तेमाल कंट्रोल के बारे में जानकारी देने के लिए कर सकता है, हालांकि, उपयोगकर्ता इससे इंटरैक्ट नहीं कर सकता. |
ToggleTemplate
|
BooleanAction
|
यह ऐसे कंट्रोल को दिखाता है जिसे चालू और बंद के बीच स्विच किया जा सकता है
राज्य. BooleanAction ऑब्जेक्ट में ऐसा फ़ील्ड है जो बदलता है
जब उपयोगकर्ता कंट्रोल पर टैप करेगा, तब अनुरोध की गई नई स्थिति को दिखाया जाएगा.
|
RangeTemplate
|
FloatAction
|
यह स्लाइडर विजेट दिखाता है. इसमें कम से कम, ज़्यादा से ज़्यादा, और चरण की वैल्यू शामिल हैं. टास्क कब शुरू होगा
जब उपयोगकर्ता स्लाइडर से इंटरैक्ट करता है, तो नया FloatAction भेजें
ऑब्जेक्ट अपडेट किए गए मान के साथ ऐप्लिकेशन पर वापस ले जाता है.
|
ToggleRangeTemplate
|
BooleanAction, FloatAction
|
यह टेंप्लेट, ToggleTemplate और
RangeTemplate . यह सुविधा, टच इवेंट के साथ-साथ, स्लाइडर का इस्तेमाल करती है.
जैसे कि रोशनी कम की जा सकने वाली लाइटों को कंट्रोल करना.
|
TemperatureControlTemplate
|
ModeAction, BooleanAction, FloatAction
|
पहले की कार्रवाइयों को शामिल करने के अलावा, यह टेंप्लेट आपको उपयोगकर्ता ने कोई मोड सेट किया हो, जैसे कि हीट, कूल, हीट/कूल, ईको या बंद. |
StatelessTemplate
|
CommandAction
|
इसका इस्तेमाल ऐसे कंट्रोल के बारे में बताने के लिए किया जाता है जो टच क्षमता उपलब्ध कराता है, लेकिन जिसकी स्थिति तय नहीं किया जा सकता, जैसे कि IR टेलीविज़न रिमोट. आप इसका इस्तेमाल कर सकते हैं टेंप्लेट का इस्तेमाल करके रूटीन या मैक्रो बनाएं, जो कि अलग-अलग तरह के कंट्रोल को और राज्य के बदलाव शामिल हैं. |
इस जानकारी की मदद से, ये कंट्रोल बनाए जा सकते हैं:
- इसका इस्तेमाल करें
Control.StatelessBuilder
बिल्डर क्लास तब जोड़ें, जब कंट्रोल की स्थिति की जानकारी न हो. - इसका इस्तेमाल करें
Control.StatefulBuilder
बिल्डर क्लास को तब सेट करता है, जब कंट्रोल की स्थिति का पता चलता है.
उदाहरण के लिए, स्मार्ट लाइट बल्ब और थर्मोस्टैट को कंट्रोल करने के लिए, यह जानकारी जोड़ें
आपके MyCustomControlService
के लिए स्थिरांक:
Kotlin
private const val LIGHT_ID = 1234 private const val LIGHT_TITLE = "My fancy light" private const val LIGHT_TYPE = DeviceTypes.TYPE_LIGHT private const val THERMOSTAT_ID = 5678 private const val THERMOSTAT_TITLE = "My fancy thermostat" private const val THERMOSTAT_TYPE = DeviceTypes.TYPE_THERMOSTAT class MyCustomControlService : ControlsProviderService() { ... }
Java
public class MyCustomJavaControlService extends ControlsProviderService { private final int LIGHT_ID = 1337; private final String LIGHT_TITLE = "My fancy light"; private final int LIGHT_TYPE = DeviceTypes.TYPE_LIGHT; private final int THERMOSTAT_ID = 1338; private final String THERMOSTAT_TITLE = "My fancy thermostat"; private final int THERMOSTAT_TYPE = DeviceTypes.TYPE_THERMOSTAT; ... }
कंट्रोल के लिए पब्लिशर बनाएं
कंट्रोल बनाने के बाद, उसके लिए पब्लिशर की ज़रूरत होती है. पब्लिशर,
कंट्रोल की मौजूदगी का सिस्टम यूज़र इंटरफ़ेस. ControlsProviderService
क्लास
में प्रकाशक के दो तरीके हैं, जिन्हें आपको अपने ऐप्लिकेशन कोड में ओवरराइड करना होगा:
createPublisherForAllAvailable()
: एकPublisher
आपके ऐप्लिकेशन में उपलब्ध सभी कंट्रोल के लिए.Control.StatelessBuilder()
का उपयोग करें इस पब्लिशर के लिएControl
ऑब्जेक्ट बनाने के लिए.createPublisherFor()
: यह दिए गए कंट्रोल की सूची के लिए,Publisher
बनाता है, जिसकी पहचान उनके स्ट्रिंग आइडेंटिफ़ायर से की जाती है. इसके लिएControl.StatefulBuilder
का इस्तेमाल करें येControl
ऑब्जेक्ट बना सकते हैं, क्योंकि पब्लिशर को हर कंट्रोल के लिए.
पब्लिशर बनाएं
जब आपका ऐप्लिकेशन, पहली बार सिस्टम यूज़र इंटरफ़ेस (यूआई) पर कंट्रोल पब्लिश करता है, तो ऐप्लिकेशन को इस बात का पता नहीं चलता
हर कंट्रोल की स्थिति के बारे में जानकारी. राज्य का नाम तय करने में काफ़ी समय लग सकता है
जिसमें device-provider के नेटवर्क में कई हॉप शामिल हैं. इसका इस्तेमाल करें
createPublisherForAllAvailable()
का इस्तेमाल करना है. यह तरीका,
Control.StatelessBuilder
बिल्डर क्लास, क्योंकि हर कंट्रोल की स्थिति यह है
अज्ञात.
Android के यूज़र इंटरफ़ेस (यूआई) में कंट्रोल दिखने के बाद , उपयोगकर्ता अपना पसंदीदा कंट्रोल चुन सकता है नियंत्रण.
ControlsProviderService
बनाने के लिए, Kotlin कोरूटीन का इस्तेमाल करने के लिए, नया कोड जोड़ें
आपके build.gradle
पर निर्भरता:
ग्रूवी
dependencies { implementation "org.jetbrains.kotlinx:kotlinx-coroutines-jdk9:1.6.4" }
Kotlin
dependencies { implementation("org.jetbrains.kotlinx:kotlinx-coroutines-jdk9:1.6.4") }
अपनी Gradle फ़ाइलें सिंक करने के बाद, अपने Service
में, नीचे दिया गया स्निपेट जोड़ें
createPublisherForAllAvailable()
को लागू करें:
Kotlin
class MyCustomControlService : ControlsProviderService() { override fun createPublisherForAllAvailable(): Flow.Publisher= flowPublish { send(createStatelessControl(LIGHT_ID, LIGHT_TITLE, LIGHT_TYPE)) send(createStatelessControl(THERMOSTAT_ID, THERMOSTAT_TITLE, THERMOSTAT_TYPE)) } private fun createStatelessControl(id: Int, title: String, type: Int): Control { val intent = Intent(this, MainActivity::class.java) .putExtra(EXTRA_MESSAGE, title) .addFlags(Intent.FLAG_ACTIVITY_NEW_TASK) val action = PendingIntent.getActivity( this, id, intent, PendingIntent.FLAG_UPDATE_CURRENT or PendingIntent.FLAG_IMMUTABLE ) return Control.StatelessBuilder(id.toString(), action) .setTitle(title) .setDeviceType(type) .build() } override fun createPublisherFor(controlIds: List ): Flow.Publisher { TODO() } override fun performControlAction( controlId: String, action: ControlAction, consumer: Consumer ) { TODO() } }
Java
public class MyCustomJavaControlService extends ControlsProviderService { private final int LIGHT_ID = 1337; private final String LIGHT_TITLE = "My fancy light"; private final int LIGHT_TYPE = DeviceTypes.TYPE_LIGHT; private final int THERMOSTAT_ID = 1338; private final String THERMOSTAT_TITLE = "My fancy thermostat"; private final int THERMOSTAT_TYPE = DeviceTypes.TYPE_THERMOSTAT; private boolean toggleState = false; private float rangeState = 18f; private final Map> controlFlows = new HashMap<>(); @NonNull @Override public Flow.Publisher createPublisherForAllAvailable() { List controls = new ArrayList<>(); controls.add(createStatelessControl(LIGHT_ID, LIGHT_TITLE, LIGHT_TYPE)); controls.add(createStatelessControl(THERMOSTAT_ID, THERMOSTAT_TITLE, THERMOSTAT_TYPE)); return FlowAdapters.toFlowPublisher(Flowable.fromIterable(controls)); } @NonNull @Override public Flow.Publisher createPublisherFor(@NonNull List controlIds) { ReplayProcessor updatePublisher = ReplayProcessor.create(); controlIds.forEach(control -> { controlFlows.put(control, updatePublisher); updatePublisher.onNext(createLight()); updatePublisher.onNext(createThermostat()); }); return FlowAdapters.toFlowPublisher(updatePublisher); } }
सिस्टम मेन्यू से नीचे की ओर स्वाइप करें और यहां दिख रहे डिवाइस कंट्रोल बटन का पता लगाएं चौथी इमेज:
![डिवाइस कंट्रोल के लिए सिस्टम यूज़र इंटरफ़ेस (यूआई) दिखाने वाली इमेज](https://developer.android.google.cn/static/images/ui/device_controls_ui.png?authuser=7&hl=hi)
डिवाइस कंट्रोल पर टैप करने से, आपको ऐसी दूसरी स्क्रीन पर ले जाया जाएगा जहां से आपका ऐप्लिकेशन. ऐप्लिकेशन चुनने के बाद, आपको पता चलता है कि पिछला स्निपेट कस्टम सिस्टम मेन्यू, जिसमें नए कंट्रोल दिखाए गए हैं, जैसा कि पांचवीं इमेज में दिखाया गया है:
![सिस्टम मेन्यू दिखाने वाली इमेज, जिसमें लाइट और थर्मोस्टैट को कंट्रोल किया गया है](https://developer.android.google.cn/static/images/ui/device_controls_example_1.png?authuser=7&hl=hi)
अब createPublisherFor()
तरीके को लागू करें. साथ ही, इन्हें अपने
Service
:
Kotlin
private val job = SupervisorJob() private val scope = CoroutineScope(Dispatchers.IO + job) private val controlFlows = mutableMapOf>() private var toggleState = false private var rangeState = 18f override fun createPublisherFor(controlIds: List ): Flow.Publisher { val flow = MutableSharedFlow (replay = 2, extraBufferCapacity = 2) controlIds.forEach { controlFlows[it] = flow } scope.launch { delay(1000) // Retrieving the toggle state. flow.tryEmit(createLight()) delay(1000) // Retrieving the range state. flow.tryEmit(createThermostat()) } return flow.asPublisher() } private fun createLight() = createStatefulControl( LIGHT_ID, LIGHT_TITLE, LIGHT_TYPE, toggleState, ToggleTemplate( LIGHT_ID.toString(), ControlButton( toggleState, toggleState.toString().uppercase(Locale.getDefault()) ) ) ) private fun createThermostat() = createStatefulControl( THERMOSTAT_ID, THERMOSTAT_TITLE, THERMOSTAT_TYPE, rangeState, RangeTemplate( THERMOSTAT_ID.toString(), 15f, 25f, rangeState, 0.1f, "%1.1f" ) ) private fun createStatefulControl(id: Int, title: String, type: Int, state: T, template: ControlTemplate): Control { val intent = Intent(this, MainActivity::class.java) .putExtra(EXTRA_MESSAGE, "$title $state") .addFlags(Intent.FLAG_ACTIVITY_NEW_TASK) val action = PendingIntent.getActivity( this, id, intent, PendingIntent.FLAG_UPDATE_CURRENT or PendingIntent.FLAG_IMMUTABLE ) return Control.StatefulBuilder(id.toString(), action) .setTitle(title) .setDeviceType(type) .setStatus(Control.STATUS_OK) .setControlTemplate(template) .build() } override fun onDestroy() { super.onDestroy() job.cancel() }
Java
@NonNull @Override public Flow.PublishercreatePublisherFor(@NonNull List controlIds) { ReplayProcessor updatePublisher = ReplayProcessor.create(); controlIds.forEach(control -> { controlFlows.put(control, updatePublisher); updatePublisher.onNext(createLight()); updatePublisher.onNext(createThermostat()); }); return FlowAdapters.toFlowPublisher(updatePublisher); } private Control createStatelessControl(int id, String title, int type) { Intent intent = new Intent(this, MainActivity.class) .putExtra(EXTRA_MESSAGE, title) .addFlags(Intent.FLAG_ACTIVITY_NEW_TASK); PendingIntent action = PendingIntent.getActivity( this, id, intent, PendingIntent.FLAG_UPDATE_CURRENT | PendingIntent.FLAG_IMMUTABLE ); return new Control.StatelessBuilder(id + "", action) .setTitle(title) .setDeviceType(type) .build(); } private Control createLight() { return createStatefulControl( LIGHT_ID, LIGHT_TITLE, LIGHT_TYPE, toggleState, new ToggleTemplate( LIGHT_ID + "", new ControlButton( toggleState, String.valueOf(toggleState).toUpperCase(Locale.getDefault()) ) ) ); } private Control createThermostat() { return createStatefulControl( THERMOSTAT_ID, THERMOSTAT_TITLE, THERMOSTAT_TYPE, rangeState, new RangeTemplate( THERMOSTAT_ID + "", 15f, 25f, rangeState, 0.1f, "%1.1f" ) ); } private Control createStatefulControl(int id, String title, int type, T state, ControlTemplate template) { Intent intent = new Intent(this, MainActivity.class) .putExtra(EXTRA_MESSAGE, "$title $state") .addFlags(Intent.FLAG_ACTIVITY_NEW_TASK); PendingIntent action = PendingIntent.getActivity( this, id, intent, PendingIntent.FLAG_UPDATE_CURRENT | PendingIntent.FLAG_IMMUTABLE ); return new Control.StatefulBuilder(id + "", action) .setTitle(title) .setDeviceType(type) .setStatus(Control.STATUS_OK) .setControlTemplate(template) .build(); }
इस उदाहरण में, createPublisherFor()
तरीके में
इस बात पर ध्यान देना कि आपके ऐप्लिकेशन को क्या करना चाहिए: अपने डिवाइस से
उसकी स्थिति को पुनर्प्राप्त कर सकता है और उस स्थिति को सिस्टम को भेज सकता है.
createPublisherFor()
तरीका, Kotlin कोरूटीन का इस्तेमाल करता है और फ़्लो की मदद से ऐसा किया जाता है
ज़रूरी Reactive Streams API को हटाने के लिए ये काम करें:
- यह
Flow
बनाता है. - एक सेकंड इंतज़ार करें.
- इससे स्मार्ट लाइट की अलग-अलग स्थिति बनती है.
- थोड़ी देर और इंतज़ार करें.
- इससे थर्मोस्टैट की स्थिति बनती है और आगे बढ़ती है.
कार्रवाइयों को हैंडल करें
जब उपयोगकर्ता, किसी डिवाइस से इंटरैक्ट करता है, तो performControlAction()
तरीका
पब्लिश करने के लिए कंट्रोल. भेजे गए ControlAction
के टाइप के आधार पर कार्रवाई तय होती है.
दिए गए कंट्रोल के लिए ज़रूरी कार्रवाई करें और फिर स्टेटस अपडेट करें
Android यूज़र इंटरफ़ेस (यूआई) में दिख रहा है.
उदाहरण को पूरा करने के लिए, अपने Service
में यह जोड़ें:
Kotlin
override fun performControlAction( controlId: String, action: ControlAction, consumer: Consumer) { controlFlows[controlId]?.let { flow -> when (controlId) { LIGHT_ID.toString() -> { consumer.accept(ControlAction.RESPONSE_OK) if (action is BooleanAction) toggleState = action.newState flow.tryEmit(createLight()) } THERMOSTAT_ID.toString() -> { consumer.accept(ControlAction.RESPONSE_OK) if (action is FloatAction) rangeState = action.newValue flow.tryEmit(createThermostat()) } else -> consumer.accept(ControlAction.RESPONSE_FAIL) } } ?: consumer.accept(ControlAction.RESPONSE_FAIL) }
Java
@Override public void performControlAction(@NonNull String controlId, @NonNull ControlAction action, @NonNull Consumerconsumer) { ReplayProcessor processor = controlFlows.get(controlId); if (processor == null) return; if (controlId.equals(LIGHT_ID + "")) { consumer.accept(ControlAction.RESPONSE_OK); if (action instanceof BooleanAction) toggleState = ((BooleanAction) action).getNewState(); processor.onNext(createLight()); } if (controlId.equals(THERMOSTAT_ID + "")) { consumer.accept(ControlAction.RESPONSE_OK); if (action instanceof FloatAction) rangeState = ((FloatAction) action).getNewValue() processor.onNext(createThermostat()); } }
ऐप्लिकेशन चलाएं, डिवाइस कंट्रोल मेन्यू को ऐक्सेस करें, और अपनी रोशनी और थर्मोस्टैट के कंट्रोल.
![लाइट और थर्मोस्टैट को कंट्रोल करने वाली इमेज](https://developer.android.google.cn/static/images/ui/device_controls_example_2.png?authuser=7&hl=hi)