اتوماسیون‌های مدیریت‌شده توسط برنامه برای iOS، اتوماسیون‌های مدیریت‌شده توسط برنامه برای iOS، اتوماسیون‌های مدیریت‌شده توسط برنامه برای iOS

اتوماسیون‌های مدیریت‌شده توسط برنامه، اتوماسیون‌هایی هستند که به صورت برنامه‌نویسی‌شده توسط یک برنامه‌ی همکار با استفاده از API اتوماسیون ساخته می‌شوند.

چنین اتوماسیون‌هایی از نمایش در فهرست اتوماسیون‌های Google Home app (GHA) منع می‌شوند.

اطلاعاتی که هنگام فعال شدن اتوماسیون مدیریت‌شده توسط برنامه در فید فعالیت Home APIs نوشته می‌شود، می‌تواند سفارشی‌سازی شود یا به‌طور کامل حذف شود. به‌عنوان مثال، اگر یک شریک، سرویسی با نام تجاری «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. اگر می‌خواهید تاریخچه اجرای اتوماسیون در تب Activity در GHA نمایش داده شود، client_feature_group را روی "APP_MANAGED_EXECUTION_REPORTED" تنظیم کنید، یا اگر نمی‌خواهید تاریخچه اجرای اتوماسیون نمایش داده شود، آن را روی "APP_MANAGED_EXECUTION_UNREPORTED" تنظیم کنید.
   3. automationGraph را تنظیم کنید.
   4. اختیاری appManagedAutomationConfig مربوط به اتوماسیون را تنظیم کنید (به مرحله ۲ مراجعه کنید).

4. در نهایت، برای ساخت نمونه Automation ، تابع build() را فراخوانی کنید.

این مثال کل روش را نشان می‌دهد:

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

اتوماسیون‌های مدیریت‌شده توسط برنامه، اتوماسیون‌هایی هستند که به صورت برنامه‌نویسی‌شده توسط یک برنامه‌ی همکار با استفاده از API اتوماسیون ساخته می‌شوند.

چنین اتوماسیون‌هایی از نمایش در فهرست اتوماسیون‌های Google Home app (GHA) منع می‌شوند.

اطلاعاتی که هنگام فعال شدن اتوماسیون مدیریت‌شده توسط برنامه در فید فعالیت Home APIs نوشته می‌شود، می‌تواند سفارشی‌سازی شود یا به‌طور کامل حذف شود. به‌عنوان مثال، اگر یک شریک، سرویسی با نام تجاری «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. اگر می‌خواهید تاریخچه اجرای اتوماسیون در تب Activity در GHA نمایش داده شود، client_feature_group را روی "APP_MANAGED_EXECUTION_REPORTED" تنظیم کنید، یا اگر نمی‌خواهید تاریخچه اجرای اتوماسیون نمایش داده شود، آن را روی "APP_MANAGED_EXECUTION_UNREPORTED" تنظیم کنید.
   3. automationGraph را تنظیم کنید.
   4. اختیاری appManagedAutomationConfig مربوط به اتوماسیون را تنظیم کنید (به مرحله ۲ مراجعه کنید).

4. در نهایت، برای ساخت نمونه Automation ، تابع build() را فراخوانی کنید.

این مثال کل روش را نشان می‌دهد:

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

اتوماسیون‌های مدیریت‌شده توسط برنامه، اتوماسیون‌هایی هستند که به صورت برنامه‌نویسی‌شده توسط یک برنامه‌ی همکار با استفاده از API اتوماسیون ساخته می‌شوند.

چنین اتوماسیون‌هایی از نمایش در فهرست اتوماسیون‌های Google Home app (GHA) منع می‌شوند.

اطلاعاتی که هنگام فعال شدن اتوماسیون مدیریت‌شده توسط برنامه در فید فعالیت Home APIs نوشته می‌شود، می‌تواند سفارشی‌سازی شود یا به‌طور کامل حذف شود. به‌عنوان مثال، اگر یک شریک، سرویسی با نام تجاری «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. اگر می‌خواهید تاریخچه اجرای اتوماسیون در تب Activity در GHA نمایش داده شود، client_feature_group را روی "APP_MANAGED_EXECUTION_REPORTED" تنظیم کنید، یا اگر نمی‌خواهید تاریخچه اجرای اتوماسیون نمایش داده شود، آن را روی "APP_MANAGED_EXECUTION_UNREPORTED" تنظیم کنید.
   3. automationGraph را تنظیم کنید.
   4. اختیاری appManagedAutomationConfig مربوط به اتوماسیون را تنظیم کنید (به مرحله ۲ مراجعه کنید).

4. در نهایت، برای ساخت نمونه Automation ، تابع build() را فراخوانی کنید.

این مثال کل روش را نشان می‌دهد:

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