مخطط سمة موقّت المنزل المزوّد بأجهزة ذكية

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

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

ATTRIBUTES للجهاز

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

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

يجب ملء هذا الحقل.

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

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

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

أمثلة

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

{
  "maxTimerLimitSec": 7200
}

حالة الجهاز

يجوز للكيانات التي تستخدم هذه السمة الإبلاغ عما يلي: كجزء من عملية QUERY. للتعلّم مزيد من المعلومات عن التعامل مع QUERY هدفًا. اطّلِع على تحقيق النية بالشراء:

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

يجب ملء هذا الحقل.

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

True في حالة وجود مؤقت نشط ولكنه متوقف مؤقتًا في الوقت الحالي.

أمثلة

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

{
  "timerRemainingSec": -1
}

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

{
  "timerRemainingSec": 60
}

ما هو مقدار الوقت المتبقي لاستخدام موقّت الجهاز؟ (متوقّف مؤقتًا)

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

CommandS للجهاز

قد تستجيب الأجهزة التي تتضمن هذه السمة لما يلي: الأوامر كجزء من عملية 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

أخطاء الجهاز

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