مخطّط سمة الموقّت في المنزل الذكي
action.devices.traits.Timer
- تشير سمة "الموقّت" إلى موقّت على الجهاز.
على سبيل المثال، قد يحتوي جهاز التحكّم الذكي في نظام الرش أو مفتاح التبديل الذكي للإضاءة على موقّت مدمج. يمكن استخدام هذه السمة للتحكّم في موقّت مدمج على الأجهزة، مثل بدء موقّت جديد وإيقاف موقّت قيد التشغيل مؤقتًا وإلغائه، وكذلك الاستفسار عن الوقت المتبقّي.
سمات الجهاز
يمكن للأجهزة التي تحتوي على هذه السمة الإبلاغ عن السمات التالية كجزء من عملية SYNC
. للاطّلاع على مزيد من المعلومات عن معالجة أهداف SYNC
، يمكنك الاطّلاع على تلبية الأهداف.
السمات | النوع | الوصف |
---|---|---|
maxTimerLimitSec |
عدد صحيح |
مطلوبة يشير إلى أطول مدة للموقّت المتاحة على الجهاز، ويتم قياسها بالثواني. |
commandOnlyTimer |
صحيح/خطأ |
(القيمة التلقائية: يشير إلى ما إذا كان الجهاز يتيح استخدام اتّصال أحادي الاتجاه (صحيح) أو اتّصال ثنائي الاتجاه (خطأ). اضبط هذه السمة على "صحيح" إذا لم يتمكّن الجهاز من الاستجابة لطلب QUERY أو الإبلاغ عن حالة هذه السمة. |
أمثلة
تم ضبط موقّت لمدة ساعتين على الجهاز.
{ "maxTimerLimitSec": 7200 }
حالات الجهاز
يمكن أن تُبلغ الكيانات التي تتضمّن هذه السمة عن الحالات التالية
كجزء من عملية QUERY
. لمزيد من المعلومات حول كيفية التعامل مع نية QUERY
، يمكنك الاطّلاع على التنفيذ حسب نية العميل.
الولايات | النوع | الوصف |
---|---|---|
timerRemainingSec |
عدد صحيح |
مطلوبة الوقت المتبقّي الحالي بالثواني أو -1 أو [0, |
timerPaused |
منطقي |
صحيح إذا كان هناك موقّت نشط ولكنّه متوقف مؤقتًا حاليًا. |
أمثلة
ما هو مقدار الوقت المتبقي لاستخدام موقّت الجهاز؟ (غير قيد التشغيل)
{ "timerRemainingSec": -1 }
كم من الوقت المتبقّي في الموقّت على الجهاز؟ (قيد التنفيذ).
{ "timerRemainingSec": 60 }
كم من الوقت المتبقّي في الموقّت على الجهاز؟ (متوقف مؤقتًا).
{ "timerRemainingSec": 30, "timerPaused": true }
أوامر الجهاز
قد تستجيب الأجهزة التي تتضمّن هذه السمة للأوامر التالية
كجزء من عملية 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