مخطط ميزة "موقّت المنزل الذكي"

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

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

سمات الجهاز

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

السمات	Type	الوصف
maxTimerLimitSec	عدد صحيح	مطلوب: يشير هذا الخيار إلى أطول إعداد متاح للموقّت على الجهاز، ويتم قياسه بالثواني.
commandOnlyTimer	منطقي	(تلقائي: false) تشير إلى ما إذا كان الجهاز يتيح استخدام الاتصال الأحادي (صحيح) أو الثنائي (خطأ). اضبط هذه السمة على "صحيح" إذا تعذّر على الجهاز استجابة هدف QUERY أو حالة التقرير لهذه السمة.

أمثلة

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

{
  "maxTimerLimitSec": 7200
}

حالات الجهاز

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

الولايات	Type	الوصف
timerRemainingSec	عدد صحيح	مطلوب: الوقت الحالي متبقٍ في الثواني أو -1 أو [0، maxTimerLimitSec]. اضبط القيمة على -1 للإشارة إلى عدم تشغيل أي موقّت.
timerPaused	منطقي	صحيح إذا كان هناك موقّت نشط ولكنه متوقّف مؤقتًا في الوقت الحالي.

أمثلة

ما هي الوقت المتبقّي على موقّت الجهاز؟ (ليس قيد التشغيل).

{
  "timerRemainingSec": -1
}

ما هي الوقت المتبقّي على موقّت الجهاز؟ (قيد التشغيل)

{
  "timerRemainingSec": 60
}

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

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

حوالات الجهاز

قد تستجيب الأجهزة التي تستخدم هذه السمة للأوامر التالية كجزء من عملية EXECUTE. للاطّلاع على مزيد من المعلومات حول التعامل مع عناصر intent في EXECUTE، يُرجى الاطّلاع على تنفيذ النية بالشراء.

action.devices.commands.TimerStart

بدء موقّت جديد

المعلّمات

المعلّمات	Type	الوصف
timerTimeSec	عدد صحيح	مطلوب: مدة الموقّت بالثواني، يجب أن تكون ضمن [1, maxTimerLimitSec].

أمثلة

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

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

أخطاء ذات صلة

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

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

noTimerExists

timerValueOutOfRange

aboveMaximumTimerDuration

belowMinimumTimerDuration

action.devices.commands.TimerAdjust

تعديل مدة الموقّت

المعلّمات

المعلّمات	Type	الوصف
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

إِيقَافُ الْمُوَقِّتْ مُؤَقَّتًا

المعلّمات

المعلّمات	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

أخطاء الجهاز

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