مرحبًا بك في "مركز مطوّري برامج Google Home"، وجهتك الجديدة لتعلّم كيفية تطوير إجراءات منزلية ذكية. ملاحظة: ستواصل إنشاء الإجراءات في وحدة تحكم الإجراءات.
تنظيم صفحاتك في مجموعات يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.

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

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

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

الجهاز ATTRIBUTES

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

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

مطلوبة.

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

commandOnlyTimer منطقي

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

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

أمثلة

الجهاز به موقّت مدته ساعتان.

{
  "maxTimerLimitSec": 7200
}

حالة الجهاز STATES

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

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

مطلوبة.

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

timerPaused منطقي

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

أمثلة

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

{
  "timerRemainingSec": -1
}

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

{
  "timerRemainingSec": 60
}

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

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

مفاتيح COMMAND

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

أخطاء الجهاز

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