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

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

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

سمات الجهاز

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

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

مطلوبة

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

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

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

أمثلة

الجهاز الذي يتضمّن موقّتًا بحدّ أقصى ساعتَين

{
  "maxTimerLimitSec": 7200
}

حالات الجهاز

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

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

مطلوبة

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

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

أمثلة

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

{
  "timerRemainingSec": -1
}

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

{
  "timerRemainingSec": 60
}

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

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

أوامر الجهاز

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

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

أخطاء الجهاز

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