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à những quy trình tự động hoá được tạo theo phương thức lập trình bằng một ứng dụng đối tác thông qua 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 hoặc hoàn toàn ẩn thông tin được ghi vào nhật ký hoạt động của Home API khi một chế độ 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 tính năng tự động hoá do ứng dụng quản lý, thì đối tác đó có thể chỉ định rằng khi tính năng tự động hoá do ứng dụng quản lý chạy, dịch vụ Arctic sẽ được tham chiếu trong nguồn cấp dữ liệu hoạt động thay vì tên tự động hoá thực tế.

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

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

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

2. Không bắt buộc Nếu muốn hoạt động của quy trình tự động hoá xuất hiện trong nguồn cấp dữ liệu hoạt động, bạn có thể điền 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 của 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 như các lần thực thi 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 người dùng có trải nghiệm tốt nhất.

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

3. Tạo phiên bản tự động hoá bằng Automation.Builder.

   1. Đặt name cho quy trình tự động hoá.
   2. Đặt client_feature_group thành "APP_MANAGED_EXECUTION_REPORTED" nếu bạn muốn 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 hoặc "APP_MANAGED_EXECUTION_UNREPORTED" nếu bạn không muốn nhật ký thực thi của quy trình tự động hoá xuất hiện.
   3. Đặt automationGraph.
   4. Không bắt buộc Đặt appManagedAutomationConfig cho 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 minh hoạ 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_UNREPORTED") // b. set the clientFeatureGroup
    .setAutomationGraph(automationGraph)                       // c. Attach the logic graph
    .setAppManagedAutomationConfig(automationConfig)           // d. Set the automationConfig
    .build() // 4. build the automation