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

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

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

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

سمات الجهاز

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

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

مطلوب:

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

commandOnlyTimer منطقي

(تلقائي: false)

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

أمثلة

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

{
  "maxTimerLimitSec": 7200
}

حالات الجهاز

قد تُبلِغ الكيانات التي تحمل هذه السمة عن الحالات التالية كجزء من عملية QUERY. للاطّلاع على مزيد من المعلومات حول التعامل مع عناصر intent في QUERY، يُرجى الاطّلاع على تنفيذ النية بالشراء.

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

مطلوب:

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

timerPaused منطقي

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

أمثلة

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

{
  "timerRemainingSec": -1
}

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

{
  "timerRemainingSec": 60
}

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

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

حوالات الجهاز

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

action.devices.commands.TimerStart

بدء موقّت جديد

المعلّمات

المعلّمات Type الوصف
timerTimeSec عدد صحيح

مطلوب:

مدة الموقّت بالثواني، يجب أن تكون ضمن [1, maxTimerLimitSec].

أمثلة

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

{
  "command": "action.devices.commands.TimerStart",
  "params": {
    "timerTimeSec": 300
  }
}

حدث خطأ أثناء بدء الموقّت.

القيم المسموح بها

noTimerExists
timerValueOutOfRange
aboveMaximumTimerDuration
belowMinimumTimerDuration

action.devices.commands.TimerAdjust

تعديل مدة الموقّت

المعلّمات

المعلّمات Type الوصف
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

إِيقَافُ الْمُوَقِّتْ مُؤَقَّتًا

المعلّمات

المعلّمات Type الوصف

ما من مواقع

أمثلة

إيقاف موقّت الجهاز مؤقتًا

{
  "command": "action.devices.commands.TimerPause",
  "params": {}
}

حدث خطأ أثناء إيقاف الموقّت مؤقتًا.

القيم المسموح بها

noTimerExists

action.devices.commands.TimerResume

استئناف الموقّت.

المعلّمات

المعلّمات Type الوصف

ما من مواقع

أمثلة

استأنف موقّت الجهاز.

{
  "command": "action.devices.commands.TimerResume",
  "params": {}
}

حدث خطأ أثناء استئناف الموقّت.

القيم المسموح بها

noTimerExists

action.devices.commands.TimerCancel

إلغاء الموقِّت.

المعلّمات

المعلّمات Type الوصف

ما من مواقع

أمثلة

إيقاف موقّت الجهاز

{
  "command": "action.devices.commands.TimerCancel",
  "params": {}
}

حدث خطأ أثناء إيقاف الموقّت.

القيم المسموح بها

noTimerExists

أخطاء الجهاز

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