Android के लिए, ऐप्लिकेशन मैनेज किए जाने वाले ऑटोमेशन

ऐप्लिकेशन से मैनेज होने वाले ऑटोमेशन, ऐसे ऑटोमेशन होते हैं जिन्हें पार्टनर ऐप्लिकेशन, Automation API का इस्तेमाल करके प्रोग्राम के हिसाब से बनाता है.

ऐसे ऑटोमेशन, Google Home app (GHA) की ऑटोमेशन सूची में नहीं दिखते.

ऐप्लिकेशन से मैनेज होने वाले ऑटोमेशन के ट्रिगर होने पर, Home API के गतिविधि फ़ीड में सेव की जाने वाली जानकारी को पसंद के मुताबिक बनाया जा सकता है या उसे पूरी तरह से छिपाया जा सकता है. उदाहरण के लिए, अगर कोई पार्टनर "Arctic" नाम की ब्रैंडेड सेवा ऑफ़र करता है, जिसे ऐप्लिकेशन से मैनेज किए जाने वाले ऑटोमेशन का इस्तेमाल करके लागू किया जाता है, तो पार्टनर यह तय कर सकता है कि जब ऐप्लिकेशन से मैनेज किए जाने वाले ऑटोमेशन चालू हों, तो गतिविधि फ़ीड में ऑटोमेशन के असल नाम के बजाय Arctic सेवा का रेफ़रंस दिया जाए.

ऐप्लिकेशन से मैनेज किया जाने वाला ऑटोमेशन बनाना

ऐप्लिकेशन से मैनेज होने वाला ऑटोमेशन बनाने के लिए, यह तरीका अपनाएं.

1. ऑटोमेशन का लॉजिक ग्राफ़ बनाएं.

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

   val myAutomationConfig = AppManagedAutomationConfig(
       managingAppDisplayNames = listOf(
           LocalizedText(text = "My custom SmartApp", locale = "en-US"),
           LocalizedText(text = "Mi aplicación personalizada", locale = "es-MX")
       )
   )
   

3. Automation.Builder का इस्तेमाल करके, ऑटोमेशन इंस्टेंस बनाएं.

   1. ऑटोमेशन के लिए name सेट करें.
   2. client_feature_group को "APP_MANAGED_EXECUTION_REPORTED" पर सेट करें, अगर आपको ऑटोमेशन के लागू होने का इतिहास, GHA में गतिविधि टैब में दिखाना है. अगर आपको ऑटोमेशन के लागू होने का इतिहास नहीं दिखाना है, तो इसे "APP_MANAGED_EXECUTION_UNREPORTED" पर सेट करें.
   3. automationGraph सेट करें.
   4. ज़रूरी नहीं ऑटोमेशन के लिए appManagedAutomationConfig सेट करें (दूसरा चरण देखें).

4. आखिर में, Automation इंस्टेंस बनाने के लिए build() को कॉल करें.

इस उदाहरण में पूरी प्रोसेस दिखाई गई है:

import com.google.home.automation.Automation
import com.google.home.automation.SequentialNode
import com.google.home.automation.StarterNode
import com.google.home.automation.ActionNode
import com.google.home.HomeDevice
import com.google.home.matter.standard.OnOff
import com.google.home.matter.standard.OnOffLightDevice
import com.google.home.matter.standard.MotionDetection
import com.google.home.matter.standard.OccupancySensorDevice

 HomeDevice mySensor = home.devices().list().first { device -> device.has(OccupancySensorDevice) }
 HomeDevice myLight = home.devices().list().first { device -> device.has(OnOffLightDevice) }

// 1. Create logic graph
val starterNode = StarterNode(
    device = mySensor,
    trait = OccupancySensing
)

val actionNode = ActionNode(
    device = myLight,
    command = OnOff.on()
)

// Bundle nodes into a sequential graph
val automationGraph = SequentialNode(
    nodes = listOf(starterNode, actionNode)
)

 // 2. Build the AppManagedAutomationConfig with the localized app names
val AppManagedAutomationConfig myAutomationConfig = AppManagedAutomationConfig(
        managingAppDisplayNames: [
          LocalizedText(text: "My Custom SmartApp", locale: "en-US"),
          LocalizedText(text: "Mi aplicación personalizada", locale: "es-MX")
        ]
    )

// 3. Build the Automation with both configuration and the graph
val myAutomation = Automation.Builder()
    .setName("Motion Activated Light")                         // a. Set the name
    .setClientFeatureGroup("APP_MANAGED_EXECUTION_UNREPORTED") // b. set the clientFeatureGroup
    .setAutomationGraph(automationGraph)                       // c. Attach the logic graph
    .setAppManagedAutomationConfig(myCustomConfig)             // d. Set the automationConfig
    .build() // 4. build the automation