مخطط ميزة موقّت المنزل الذكي
action.devices.traits.Timer
: تمثّل سمة "الموقّت" موقّتًا على الجهاز.
على سبيل المثال، قد تتضمن وحدة التحكم بالرش الذكي أو مفتاح الإضاءة الذكية موقّتًا مدمجًا. يمكن استخدام هذه الميزة للتحكّم في موقّت مُدمَج على الأجهزة، مثل بدء موقّت جديد بالإضافة إلى إيقاف موقّت قيد التشغيل وإلغاؤه، والسؤال عن مقدار الوقت المتبقي.
الجهاز ATTRIBUTES
ويمكن للأجهزة التي تتضمّن هذه السمة الإبلاغ عن السمات التالية كجزء من عملية SYNC
. لمزيد من المعلومات حول التعامل مع إجراءات SYNC
، يُرجى الاطّلاع على تنفيذ الإجراء.
السمات | النوع | الوصف |
---|---|---|
maxTimerLimitSec |
عدد صحيح |
مطلوبة. يشير إلى أطول موقّت تم ضبطه على الجهاز، ويتم قياسه بالثواني. |
commandOnlyTimer |
منطقي |
(القيمة التلقائية: تشير إلى ما إذا كان الجهاز يتيح استخدام اتصال أحادي الاتجاه (صحيح) أو ثنائي الاتجاه (خطأ). اضبط هذه السمة على "صحيح" إذا تعذّر على الجهاز الرد على طلب QUERY أو حالة التقرير لهذه السمة. |
أمثلة
الجهاز به موقّت مدته ساعتان.
{ "maxTimerLimitSec": 7200 }
حالة الجهاز STATES
ويمكن للأجهزة التي تتضمّن هذه السمة الإبلاغ عن الحالات
التالية كجزء من عملية QUERY
. لمزيد من المعلومات حول التعامل مع إجراءات QUERY
، يُرجى الاطّلاع على تنفيذ الإجراء.
الولايات | النوع | الوصف |
---|---|---|
timerRemainingSec |
عدد صحيح |
مطلوبة. الوقت الحالي المتبقي بالثواني أو -1 أو [0، |
timerPaused |
منطقي |
True في حال وجود موقِّت نشط ولكنه متوقف مؤقتًا حاليًا. |
أمثلة
ما الوقت المتبقي على موقّت الجهاز؟ (ليس قيد التشغيل).
{ "timerRemainingSec": -1 }
ما الوقت المتبقي على موقّت الجهاز؟ (قيد التشغيل).
{ "timerRemainingSec": 60 }
ما الوقت المتبقي على موقّت الجهاز؟ (متوقف مؤقتًا).
{ "timerRemainingSec": 30, "timerPaused": true }
مفاتيح COMMAND
قد تستجيب الأجهزة التي تتضمّن هذه السمة للأوامر
التالية كجزء من عملية EXECUTE
. لمزيد من المعلومات حول التعامل مع إجراءات EXECUTE
، يُرجى الاطّلاع على تنفيذ الإجراء.
action.devices.commands.TimerStart
بدء مؤقِّت جديد
المَعلمات
المَعلمات | النوع | الوصف |
---|---|---|
timerTimeSec |
عدد صحيح |
مطلوبة. مدة الموقّت بالثواني، يجب أن تكون في غضون [1، |
أمثلة
تشغيل موقّت الجهاز لمدة خمس دقائق.
{ "command": "action.devices.commands.TimerStart", "params": { "timerTimeSec": 300 } }
الأخطاء ذات الصلة
حدث خطأ أثناء بدء المؤقِّت.
القيم المسموح بها:
noTimerExists
timerValueOutOfRange
aboveMaximumTimerDuration
belowMinimumTimerDuration
action.devices.commands.TimerAdjust
اضبط مدة الموقّت.
المَعلمات
المَعلمات | النوع | الوصف |
---|---|---|
timerTimeSec |
عدد صحيح |
مطلوبة. ضبط موجب أو سالب للموقّت بالثواني، يجب أن يكون [ |
أمثلة
أضِف دقيقة واحدة إلى موقّت الجهاز.
{ "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