دليل Android DSL للعمليات المبرمَجة المعقّدة

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

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

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

automation {
  sequential {
    starter<_>(...)
    condition {...}
    action {...}
    action {...}
    action {...}
    }
}

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

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

automation {
  sequential {
    starter<_>(...)
    condition {...}
    parallel {
      action {...}
      action {...}
      action {...}
    }
  }
}

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

التأخيرات

يمكنك إدراج فواصل في عمليات التشغيل الآلي باستخدام الكلمة الرئيسية delayFor، التي تتضمّن وسيطة java.time.Duration تمثّل مدة التوقف المؤقت قبل مواصلة التنفيذ. يمكن أن تتراوح مدة الإيقاف المؤقت بين خمس ثوانٍ و24 ساعة.

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

sequential {
  action(light, OnOffLightDevice) { command(OnOff.toggle()) }
  delayFor(Duration.ofSeconds(5))
  action(light, OnOffLightDevice) { command(OnOff.toggle()) }
  delayFor(Duration.ofSeconds(5))
  action(light, OnOffLightDevice) { command(OnOff.toggle()) }
  delayFor(Duration.ofSeconds(5))
  action(light, OnOffLightDevice) { command(OnOff.toggle()) }
}

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

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

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

automation {
  sequential {
    val starterNode = starter<_>(device, OccupancySensor, MotionDetection)
    suppressFor(Duration.ofMinutes(30))
    action(light, OnOffLightDevice) { command(OnOff.toggle()) }
}

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

وضع حدّ لعدد عمليات التنفيذ

يمكنك الحدّ من عدد المرات المسموح فيها بتشغيل عملية آلية.

على سبيل المثال، يمكنك إعداد عملية تشغيل آلي لمرة واحدة تشغّل المكنسة الكهربائية أثناء تواجدك خارج المنزل طوال اليوم.

لإجراء ذلك، اضبط حقل البيانات الوصفية maxExecutionCount في عملية التشغيل الآلي. المثال التالي هو عملية أتمتة يمكن تنفيذها مرة واحدة فقط:

automation {
  // The automation can only be executed once.
  maxExecutionCount = 1
  // When the door lock state changes
  sequential {
    val doorLockEvent = starter<_>(doorLock, DoorLockDevice, LockOperationEvent)
    // if the door is unlocked
    condition() {
      expression = (doorLockEvent.lockOperationType equals LockOperationTypeEnum.Unlock)
    }
    // turn the light on
    action(light, DimmableLightDevice) { command(OnOff.on()) }
  }
}

يتم حذف عملية التشغيل الآلي فورًا بعد اكتمال تنفيذها للمرة الأخيرة والوصول إلى maxExecutionCount. يبقى إدخال سجلّ التشغيل الآلي في علامة التبويب Google Home app (GHA) النشاط، بما في ذلك automation_id.

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

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

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

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

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

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

action(device, Fan) {
  update(FanControl) {
    setPercentSetting(50u)
    setRockSetting(FanControlCluster.RockBitmap.rockUpDown)
  }
}