बाहरी डिवाइसों को कंट्रोल करना

Android 11 और उसके बाद के वर्शन में, डिवाइस के कंट्रोल को तुरंत ऐक्सेस करने की सुविधा की मदद से, उपयोगकर्ता डिफ़ॉल्ट लॉन्चर से तीन इंटरैक्शन में, लाइट, थर्मोस्टैट, और कैमरे जैसे बाहरी डिवाइसों को तुरंत देख और कंट्रोल कर सकता है. डिवाइस का OEM यह चुनता है कि कौनसा लॉन्चर इस्तेमाल करना है. डिवाइस एग्रीगेटर, जैसे कि Google Home और तीसरे पक्ष के वेंडर ऐप्लिकेशन, इस स्पेस में डिवाइसों को दिखाने के लिए उपलब्ध करा सकते हैं. इस पेज पर, इस स्पेस में डिवाइस के कंट्रोल दिखाने और उन्हें कंट्रोल ऐप्लिकेशन से लिंक करने का तरीका बताया गया है.

इस सुविधा को जोड़ने के लिए, ControlsProviderService बनाएं और उसका एलान करें. पहले से तय कंट्रोल टाइप के आधार पर, ऐसे कंट्रोल बनाएं जिनका इस्तेमाल आपके ऐप्लिकेशन में किया जा सकता है. इसके बाद, इन कंट्रोल के लिए पब्लिशर बनाएं.

उपयोगकर्ता इंटरफ़ेस

डिवाइस, डिवाइस कंट्रोल में टेंप्लेट वाले विजेट के तौर पर दिखते हैं. डिवाइस कंट्रोल करने वाले पांच विजेट उपलब्ध हैं, जैसा कि इस इमेज में दिखाया गया है:

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

सेवा बनाना

इस सेक्शन में, 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() से एक्सटेंड़ करें:

    class MyCustomControlService : ControlsProviderService() {
        ...
    }
    

    public class MyCustomJavaControlService extends ControlsProviderService {
        ...
    }
    

कंट्रोल का सही टाइप चुनना

एपीआई, कंट्रोल बनाने के लिए बिल्डर के तरीके उपलब्ध कराता है. बिल्डर को जानकारी देने के लिए, यह तय करें कि आपको किस डिवाइस को कंट्रोल करना है और उपयोगकर्ता उससे कैसे इंटरैक्ट करता है. यह तरीका अपनाएं:

1. चुनें कि कंट्रोल किस तरह के डिवाइस के लिए है. DeviceTypes क्लास, उन सभी डिवाइसों की सूची है जिन पर यह सुविधा काम करती है. टाइप का इस्तेमाल, यूज़र इंटरफ़ेस (यूआई) में डिवाइस के आइकॉन और रंग तय करने के लिए किया जाता है.
2. उपयोगकर्ता के सामने दिखने वाला नाम, डिवाइस की जगह की जानकारी—उदाहरण के लिए, किचन—और कंट्रोल से जुड़े अन्य यूज़र इंटरफ़ेस (यूआई) टेक्स्ट एलिमेंट तय करें.
3. उपयोगकर्ता के इंटरैक्शन के लिए सबसे अच्छा टेंप्लेट चुनें. ऐप्लिकेशन से कंट्रोल को ControlTemplate असाइन किया जाता है. यह टेंप्लेट, उपयोगकर्ता को सीधे तौर पर कंट्रोल की स्थिति के साथ-साथ, इनपुट के उपलब्ध तरीकों को दिखाता है. जैसे, ControlAction. यहां दी गई टेबल में, उपलब्ध कुछ टेंप्लेट और उन पर की जा सकने वाली कार्रवाइयों के बारे में बताया गया है:

इस जानकारी की मदद से, यह कंट्रोल बनाया जा सकता है:

• जब कंट्रोल की स्थिति की जानकारी न हो, तो Control.StatelessBuilder बिल्डर क्लास का इस्तेमाल करें.
• जब कंट्रोल की स्थिति पता हो, तो Control.StatefulBuilder बिल्डर क्लास का इस्तेमाल करें.

उदाहरण के लिए, स्मार्ट लाइट बल्ब और थर्मोस्टैट को कंट्रोल करने के लिए, अपने MyCustomControlService में ये कॉन्स्टेंट जोड़ें:

    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() {
      ...
    }
    

    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 ऑब्जेक्ट बनाने के लिए, Control.StatelessBuilder() का इस्तेमाल करें.
• createPublisherFor(): दिए गए कंट्रोल की सूची के लिए Publisher बनाता है, जैसा कि उनके स्ट्रिंग आइडेंटिफ़ायर से पता चलता है. इन Control ऑब्जेक्ट को बनाने के लिए Control.StatefulBuilder का इस्तेमाल करें, क्योंकि पब्लिशर को हर कंट्रोल के लिए एक स्टेटस असाइन करना होगा.

पब्लिशर बनाना

जब आपका ऐप्लिकेशन पहली बार सिस्टम यूज़र इंटरफ़ेस (यूआई) में कंट्रोल पब्लिश करता है, तो ऐप्लिकेशन को हर कंट्रोल की स्थिति के बारे में पता नहीं होता. डिवाइस की स्थिति जानने में काफ़ी समय लग सकता है. इसके लिए, डिवाइस की सेवा देने वाली कंपनी के नेटवर्क में कई हॉप की ज़रूरत होती है. सिस्टम में उपलब्ध कंट्रोल का विज्ञापन करने के लिए, createPublisherForAllAvailable() वाला तरीका इस्तेमाल करें. यह तरीका Control.StatelessBuilder बिल्डर क्लास का इस्तेमाल करता है, क्योंकि हर कंट्रोल की स्थिति पता नहीं होती.

Android यूज़र इंटरफ़ेस (यूआई) में कंट्रोल दिखने के बाद , उपयोगकर्ता अपने पसंदीदा कंट्रोल चुन सकता है.

ControlsProviderService बनाने के लिए Kotlin कोरूटीन का इस्तेमाल करने के लिए, अपने build.gradle में एक नई डिपेंडेंसी जोड़ें:

dependencies {
    implementation "org.jetbrains.kotlinx:kotlinx-coroutines-jdk9:1.6.4"
}

dependencies {
    implementation("org.jetbrains.kotlinx:kotlinx-coroutines-jdk9:1.6.4")
}

Gradle फ़ाइलों को सिंक करने के बाद, createPublisherForAllAvailable() को लागू करने के लिए, अपने Service में यह स्निपेट जोड़ें:

    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()
        }
    }
    

    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);
        }
    }
    

सिस्टम मेन्यू को नीचे की ओर स्वाइप करें और डिवाइस कंट्रोल बटन ढूंढें. यह बटन चौथे चित्र में दिखाया गया है:

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

अब, createPublisherFor() तरीका लागू करें. इसके लिए, अपने Service में ये चीज़ें जोड़ें:

    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()
    }
 
    

    @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);
    }
 
    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 की शर्तों को पूरा करता है. इसके लिए, यह तरीका ये काम करता है:

1. Flow बनाता है.
2. एक सेकंड इंतज़ार करता है.
3. स्मार्ट लाइट की स्थिति बनाता और उसे दिखाता है.
4. एक और सेकंड इंतज़ार करता है.
5. थर्मोस्टैट की स्थिति बनाता और उसे भेजता है.

कार्रवाइयां मैनेज करना

performControlAction() तरीका तब सिग्नल भेजता है, जब उपयोगकर्ता किसी पब्लिश किए गए कंट्रोल से इंटरैक्ट करता है. भेजे गए ControlAction के टाइप से कार्रवाई तय होती है. दिए गए कंट्रोल के लिए सही कार्रवाई करें. इसके बाद, Android यूज़र इंटरफ़ेस (यूआई) में डिवाइस की स्थिति अपडेट करें.

उदाहरण को पूरा करने के लिए, अपने Service में यह जानकारी जोड़ें:

    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)
    }
    

    @Override
    public void performControlAction(@NonNull String controlId, @NonNull ControlAction action, @NonNull Consumer consumer) {
        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());
        }
    }
    

ऐप्लिकेशन चलाएं, डिवाइस कंट्रोल मेन्यू ऐक्सेस करें, और अपनी लाइट और थिर्मोस्टैट के कंट्रोल देखें.