Автоматизация действий с помощью приложений для 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 автоматизации (см. шаг 2).

4. Наконец, вызовите build(), чтобы создать экземпляр Automation.

Ниже приведен пример, в котором показана вся процедура.

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