مخطط سمة موقّت المنزل المزوّد بأجهزة ذكية

action.devices.traits.Timer: تمثّل سمة "الموقّت" موقّتًا على الجهاز.

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

سمات الجهاز

قد تُبلغ الأجهزة التي تتضمّن هذه السمة عن السمات التالية كجزء من عملية SYNC. لمزيد من المعلومات عن التعامل مع أغراض SYNC، يُرجى الاطّلاع على تنفيذ النية.

السمات النوع الوصف
maxTimerLimitSec عدد صحيح

يجب ملء هذا الحقل.

تشير هذه السمة إلى أطول إعدادات موقّت متاحة على الجهاز، ويتم قياسها بالثواني.

commandOnlyTimer منطقية

(القيمة التلقائية: false)

يشير إلى ما إذا كان الجهاز يتيح استخدام الاتصال أحادي الاتجاه (صحيح) أو اتصال ثنائي الاتجاه (خطأ). اضبُط هذه السمة على "صحيح" إذا لم يتمكن الجهاز من الاستجابة للغرض من QUERY أو "حالة التقرير" لهذه السمة.

أمثلة

جهاز مؤقت لمدة ساعتين كحد أقصى.

{
  "maxTimerLimitSec": 7200
}

حالات الجهاز

قد تبلّغ الكيانات التي تتضمّن هذه السمة عن الحالات التالية كجزء من عملية QUERY. لمزيد من المعلومات عن التعامل مع أغراض QUERY، يُرجى الاطّلاع على تنفيذ النية.

الولايات النوع الوصف
timerRemainingSec عدد صحيح

يجب ملء هذا الحقل.

الوقت الحالي المتبقي بالثواني، أو -1، أو [0، maxTimerLimitSec]. اضبطه على -1 للإشارة إلى عدم تشغيل أي موقّت.

timerPaused منطقية

صحيح إذا كان هناك مؤقت نشط ولكنه متوقف مؤقتًا حاليًا.

أمثلة

كم من الوقت يتبقى في موقّت الجهاز؟ (لا يتم العرض).

{
  "timerRemainingSec": -1
}

كم من الوقت يتبقى في موقّت الجهاز؟ (جري).

{
  "timerRemainingSec": 60
}

كم من الوقت يتبقى في موقّت الجهاز؟ (متوقّف مؤقتًا).

{
  "timerRemainingSec": 30,
  "timerPaused": true
}

مفاتيح الجهاز

قد تستجيب الأجهزة التي تتضمّن هذه السمة إلى الأوامر التالية كجزء من عملية EXECUTE. لمزيد من المعلومات عن التعامل مع أغراض EXECUTE، يُرجى الاطّلاع على تنفيذ النية.

action.devices.commands.TimerStart

بَدْءْ مُوَقِّتِ جِدِيدْ.

المَعلمات

المَعلمات النوع الوصف
timerTimeSec عدد صحيح

يجب ملء هذا الحقل.

مدة الموقّت بالثواني، يجب أن تكون ضمن [1، maxTimerLimitSec].

أمثلة

تشغيل موقّت الجهاز لمدة خمس دقائق

{
  "command": "action.devices.commands.TimerStart",
  "params": {
    "timerTimeSec": 300
  }
}

حدث خطأ أثناء بدء الموقّت.

القيم المسموح بها:

noTimerExists
timerValueOutOfRange
aboveMaximumTimerDuration
belowMinimumTimerDuration

action.devices.commands.TimerAdjust

ضبط مدة الموقت.

المَعلمات

المَعلمات النوع الوصف
timerTimeSec عدد صحيح

يجب ملء هذا الحقل.

تعديل إيجابي أو سلبي للموقّت بالثواني، ويجب أن يكون ضمن [-maxTimerLimitSec، maxTimerLimitSec].

أمثلة

أضِف دقيقة واحدة إلى موقّت الجهاز.

{
  "command": "action.devices.commands.TimerAdjust",
  "params": {
    "timerTimeSec": 60
  }
}

طرح 30 ثانية من موقّت الجهاز.

{
  "command": "action.devices.commands.TimerAdjust",
  "params": {
    "timerTimeSec": -30
  }
}

حدث خطأ أثناء ضبط الموقّت.

القيم المسموح بها:

noTimerExists
timerValueOutOfRange
aboveMaximumTimerDuration
belowMinimumTimerDuration

action.devices.commands.TimerPause

إيقاف الموقّت مؤقتًا.

المَعلمات

المَعلمات النوع الوصف

ما من مواقع

أمثلة

إيقاف موقِّت الجهاز مؤقتًا

{
  "command": "action.devices.commands.TimerPause",
  "params": {}
}

حدث خطأ عند إيقاف الموقّت مؤقتًا.

القيم المسموح بها:

noTimerExists

action.devices.commands.TimerResume

اسْتِئْنَافِ الْمُؤَقِّتْ.

المَعلمات

المَعلمات النوع الوصف

ما من مواقع

أمثلة

استئناف موقّت الجهاز

{
  "command": "action.devices.commands.TimerResume",
  "params": {}
}

حدث خطأ أثناء استئناف الموقّت.

القيم المسموح بها:

noTimerExists

action.devices.commands.TimerCancel

إلغاء الموقِّت.

المَعلمات

المَعلمات النوع الوصف

ما من مواقع

أمثلة

أوقِف موقّت الجهاز.

{
  "command": "action.devices.commands.TimerCancel",
  "params": {}
}

حدث خطأ أثناء إيقاف الموقّت.

القيم المسموح بها:

noTimerExists

أخطاء الجهاز

راجِع القائمة الكاملة للأخطاء والاستثناءات.