Tính năng tự động hoá do ứng dụng quản lý cho iOS

Quy trình tự động hoá do ứng dụng quản lý là quy trình tự động hoá được xây dựng theo chương trình bằng một ứng dụng đối tác sử dụng Automation API.

Những quy trình tự động hoá như vậy sẽ không xuất hiện trong danh sách quy trình tự động hoá Google Home app (GHA).

Bạn có thể tuỳ chỉnh thông tin được ghi vào bảng tin hoạt động của các API cho Home khi một quy trình tự động hoá do ứng dụng quản lý được kích hoạt. Ví dụ: nếu một đối tác cung cấp dịch vụ có thương hiệu tên là "Arctic" được triển khai bằng quy trình tự động hoá do ứng dụng quản lý, thì đối tác đó có thể chỉ định rằng khi quy trình tự động hoá do ứng dụng quản lý chạy, dịch vụ Arctic sẽ được tham chiếu trong bảng tin hoạt động thay vì tên thực tế của quy trình tự động hoá.

Tạo quy trình tự động hoá do ứng dụng quản lý

Để tạo một quy trình tự động do ứng dụng quản lý, hãy làm theo quy trình sau.

1. Tạo biểu đồ logic của quy trình tự động hoá.

2. Để tuỳ chỉnh cách hoạt động của quy trình tự động hoá xuất hiện trong Bảng tin hoạt động, hãy điền vào một thực thể AppManagedAutomationConfig bằng thông báo đã bản địa hoá mà bạn muốn xuất hiện trong nguồn cấp dữ liệu thay cho tên quy trình tự động hoá. Đây có thể là tên đã bản địa hoá của một ứng dụng hoặc dịch vụ, hoặc bất kỳ thông báo nào khác mà bạn muốn. Nếu bạn không cung cấp bất kỳ chuỗi bản địa hoá nào, thì các lần thực thi tự động hoá sẽ được ghi lại giống như mọi quy trình tự động hoá khác. Google khuyên bạn nên đặt các chuỗi đã bản địa hoá này để đảm bảo trải nghiệm tốt nhất cho người dùng.

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

3. Tạo thực thể tự động hoá bằng Automation.Builder.

   1. Đặt name của quy trình tự động hoá.
   2. Đặt client_feature_group thành "APP_MANAGED_EXECUTION_REPORTED" để nhật ký thực thi của quy trình tự động hoá xuất hiện trong thẻ Hoạt động trong GHA.
   3. Đặt automationGraph.
   4. Không bắt buộc Đặt appManagedAutomationConfig của quy trình tự động hoá (xem Bước 2).

4. Cuối cùng, hãy gọi build() để tạo thực thể Automation.

Ví dụ này cho thấy toàn bộ quy trình:

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_REPORTED")   // b. set the clientFeatureGroup
    .setAutomationGraph(automationGraph)                       // c. Attach the logic graph
    .setAppManagedAutomationConfig(automationConfig)           // d. Set the automationConfig
    .build() // 4. build the automation