مخطط سمة "المؤقّت" في الأجهزة الذكية

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

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

سمات الجهاز

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

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

مطلوبة.

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

القيمة الدنيا: 1.
commandOnlyTimer قيمة منطقية

(الإعداد التلقائي: false)

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

أمثلة

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

{
  "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].

القيمة الدنيا: 1.

أمثلة

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

{
  "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

أخطاء الجهاز

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