عمليات التشغيل الآلي التي يديرها التطبيق على Android

عمليات التشغيل الآلي التي يديرها التطبيق هي عمليات يتم إنشاؤها آليًا من خلال تطبيق شريك باستخدام Automation API.

يتم منع ظهور عمليات التشغيل الآلي هذه في Google Home app (GHA) قائمة عمليات التشغيل الآلي.

يمكن تخصيص المعلومات التي يتم تسجيلها في خلاصة الأنشطة الخاصة بواجهات برمجة التطبيقات Home عند تشغيل عملية تشغيل آلي يديرها تطبيق، أو يمكن إيقافها بالكامل. على سبيل المثال، إذا كان أحد الشركاء يقدّم خدمة تحمل علامة تجارية باسم "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