دليل لغات وصف البيانات (DSL) لنظام التشغيل iOS للإجراءات المبرمَجة المعقدة

يمكن استخدام لغة DSL الخاصة بالتشغيل الآلي لإنشاء عمليات تشغيل آلي أكثر تعقيدًا من تلك الموضّحة في دليل لغة DSL - عمليات التشغيل الآلي الأساسية على أجهزة iOS.

تسلسلي مع إجراءات متعددة

يمكن أن ينفّذ التشغيل الآلي أكثر من إجراء واحد. على سبيل المثال، بدلاً من عقدة action الفردية، يمكنك استخدام عقد action متعددة يتم تشغيلها بترتيب تسلسلي:

import GoogleHomeSDK
import GoogleHomeTypes

automation (
...
) {

  starter(...)
  condition {...}
  action {...}
  action {...}
  action {...}

}

تسلسلي مع إجراءات متوازية متعددة

إذا وضعت عُقد action متعددة في عقدة parallel، سيتم تنفيذ الإجراءات بشكل متزامن.

import GoogleHomeSDK
import GoogleHomeTypes

automation (
...
) {

  starter(...)
  condition {...}
  parallel {
    action {...}
    action {...}
    action {...}
  }

}

إذا كانت هناك عقد action في العقدة sequential تلي العقدة parallel، سيتم تأجيل تنفيذها إلى حين انتهاء تنفيذ جميع العُقد داخل العقدة parallel.

التأخيرات

يمكنك إدخال فواصل في عمليات التشغيل الآلي باستخدام طريقة delay(for:)، التي تتضمّن وسيطًا Duration يمثّل مدة الإيقاف المؤقت قبل مواصلة التنفيذ. يمكن أن تتراوح مدة الإيقاف المؤقت بين خمس ثوانٍ و24 ساعة.

على سبيل المثال، لتبديل حالة المصباح أربع مرات مع إيقاف مؤقت لمدة خمس ثوانٍ بين كل عملية تبديل:

typealias OnOffLightDevice = Matter.OnOffLightDeviceType
typealias OnOffTrait = Matter.OnOffTrait

sequential {
  action(light, OnOffLightDevice.self) { OnOffTrait.toggle() }
  delay(for:.seconds(5))
  action(light, OnOffLightDevice.self) { OnOffTrait.toggle() }
  delay(for:.seconds(5))
  action(light, OnOffLightDevice.self) { OnOffTrait.toggle() }
  delay(for:.seconds(5))
  action(light, OnOffLightDevice.self) { OnOffTrait.toggle() }
}

إيقاف المشغِّل

ميزة "منع التكرار" هي إحدى الإمكانات التي تتيح للتشغيل الآلي تجاهل starter لمدة زمنية محددة بعد حدث التفعيل الأولي. على سبيل المثال، إذا كان التشغيل الآلي يتضمّن starter يتم تفعيله عند كشف الحركة، وإذا حدّدت مدة منع التكرار بخمس دقائق، فعندما يتم تفعيل starter، لن يتم تفعيله مرة أخرى خلال الدقائق الخمس التالية. ويمنع ذلك التشغيل الآلي من التفعيل بشكل متكرر وسريع.

لتطبيق ميزة حظر التكرار على عملية التشغيل الآلي، استخدِم الكلمة الرئيسية suppress(for:) مع وسيط Duration يمثّل مدة الانتظار قبل الاستجابة للمشغّلات اللاحقة. ويمكن أن تكون مدة الحظر قصيرة تصل إلى خمس ثوانٍ أو طويلة تصل إلى 24 ساعة.

typealias OccupancySensorDevice = Matter.OccupancySensorDeviceType
typealias OnOffLightDevice = Matter.OnOffLightDeviceType
typealias MotionDetectionTrait = Google.MotionDetectionTrait
typealias OnOffTrait = Matter.OnOffTrait

automation {
  let starterNode = starter(device, OccupancySensorDevice.self, MotionDetectionTrait.self)
  starterNode
  suppress(for: .seconds(30 * 60)  // 30 minutes
  action(light, OnOffLightDevice.self) { OnOffTrait.toggle() }
}

يُرجى العِلم أنّ ميزة إيقاف المشغّلات تؤثر في جميع starters في عملية التشغيل الآلي التي تسبق Suppression.

ضبط سمات السمة في إجراء

لضبط قيمة سمة السلوك، اتّبِع الخطوات التالية:

1. أنشئ عقدة update ضمن عقدة action، بما في ذلك السمة ذات الصلة كمعلَمة لعقدة update:

   action(deviceReference, deviceType) {
     update(trait) {
   
     }
   }
   

2. ضمن العقدة update، لكل سمة سيتم تعديلها، استخدِم دالة معدِّلة، ومرِّر إليها القيمة الجديدة. لتكوين اسم دالة المعدِّل، اتّبِع الخطوات التالية:
   1. كتابة اسم السمة بأحرف كبيرة
   2. أضِف كلمة set قبلها.
   على سبيل المثال، لتعديل سمة باسم defaultMoveRate، عليك استخدام دالة معدِّلة باسم setDefaultMoveRate.

يُرجى العِلم أنّه يمكن أن تتضمّن عقدة update عدة دوال معدِّلة. إليك مثالاً يتم فيه تعديل سمتَين:

typealias FanDeviceType = Matter.FanDeviceType
typealias FanControlTrait = Matter.FanControlTrait

action(fan, FanDeviceType.self) {
  update(FanControlTrait.self) {
    $0.setFanMode(.on)
  }
}