iOS 向けのアプリ管理による自動化

アプリ管理の自動化とは、パートナー アプリが Automation API を使用してプログラムで構築する自動化のことです。

このような自動化は、Google Home app (GHA) 自動化リストに表示されないように抑制されます。

アプリ管理の自動化がトリガーされたときに Home API のアクティビティ フィードに書き込まれる情報は、カスタマイズすることも、完全に抑制することもできます。たとえば、パートナーがアプリ管理の自動化を使用して実装された「Arctic」というブランド サービスを提供している場合、パートナーは、アプリ管理の自動化が実行されるときに、実際には自動化名ではなく、アクティビティ フィードで Arctic サービスが参照されるように指定できます。

アプリ管理の自動化を作成する

アプリ管理の自動化を作成する手順は次のとおりです。

  1. 自動化のロジック グラフを構築します。

  2. 省略可: 自動化のアクティビティをアクティビティ フィードに表示する場合は、自動化の名前の代わりにフィードに表示するローカライズされたメッセージを AppManagedAutomationConfig インスタンスに設定します。アプリやサービスのローカライズされた名前や、任意のメッセージを指定できます。ローカライズされた文字列を指定しない場合、自動化の実行は他の自動化と同様にログに記録されます。最適なユーザー エクスペリエンスを実現するため、これらのローカライズされた文字列を設定することをおすすめします。

    let automationConfig = AppManagedAutomationConfig(
    managingAppDisplayNames: [
      LocalizedText(text: "My Custom SmartApp", locale: "en-US"),
      LocalizedText(text: "Mi aplicación personalizada", locale: "es-MX")
    ]
)

  3. Automation.Builder を使用して自動化インスタンスを作成します。

    1. 自動化の name を設定します。
    2. 自動化の実行履歴を GHA の [アクティビティ] タブに表示する場合は client_feature_group を "APP_MANAGED_EXECUTION_REPORTED" に設定し、自動化の実行履歴を表示しない場合は "APP_MANAGED_EXECUTION_UNREPORTED" に設定します。
    3. automationGraph を設定します。
    4. 省略可: 自動化の appManagedAutomationConfig を設定します（ステップ 2 を参照）。

  4. 最後に、build() を呼び出して Automation インスタンスをビルドします。

この例は、手順全体を示しています。


import GoogleHomeSDK
import GoogleHomeTypes

let devices = try await home.devices().list()
let mySensor: HomeDevice = devices.first(where: {
    $0.types.contains(OccupancySensorDeviceType.self) &&
    $0.structureID == structure.id
})

let myLight: HomeDevice = devices.first(
  where: {
    $0.types.contains(OnOffLightDeviceType.self) &&
    $0.structureID == structure.id
  }
)

// 1. Create logic graph
let starterNode = StarterNode(
    device: mySensor,
    trait: Matter.OccupancySensingTrait.self
)

let actionNode = ActionNode(
    device: myLight,
    command: Matter.OnOffTrait.on()
)

// Bundle nodes into a sequential graph
let automationGraph = SequentialFlow(
    nodes: [starterNode, actionNode]
)

// 2. Build the AppManagedAutomationConfig with the localized app names
let automationConfig = 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
let myFunctionalAutomation = try AutomationBuilder()
    .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(automationConfig)           // d. Set the automationConfig
    .build() // 4. build the automation
前へ
マルチパート デバイスの自動化
次へ
自動化の例