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