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

action.devices.traits.Timer - تشير سمة "الموقّت" إلى موقّت على الجهاز.

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

سمات الجهاز

يمكن للأجهزة التي تحتوي على هذه السمة الإبلاغ عن السمات التالية كجزء من عملية SYNC. للاطّلاع على مزيد من المعلومات عن معالجة أهداف SYNC، يمكنك الاطّلاع على تلبية الأهداف.

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

مطلوبة

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

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

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

أمثلة

تم ضبط موقّت لمدة ساعتين على الجهاز.

{
  "maxTimerLimitSec": 7200
}

حالات الجهاز

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

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

مطلوبة

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

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

أمثلة

ما هو مقدار الوقت المتبقي لاستخدام موقّت الجهاز؟ (غير قيد التشغيل)

{
  "timerRemainingSec": -1
}

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

{
  "timerRemainingSec": 60
}

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

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

أوامر الجهاز

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

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

أخطاء الجهاز

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