به Google Home Developer Center، مقصد جدیدی برای یادگیری نحوه توسعه اقدامات خانه هوشمند خوش آمدید. توجه: به ساخت کنش‌ها در کنسول Actions ادامه خواهید داد.
با مجموعه‌ها، منظم بمانید ذخیره و دسته‌بندی محتوا براساس اولویت‌های شما.

طرح صفت تایمر خانه هوشمند

action.devices.traits.Timer - ویژگی Timer نشان دهنده یک تایمر در یک دستگاه است.

به عنوان مثال، یک کنترلر آبپاش هوشمند یا کلید چراغ هوشمند ممکن است یک تایمر داخلی داشته باشد. از این ویژگی می توان برای کنترل یک تایمر داخلی روی دستگاه ها استفاده کرد، مانند شروع یک تایمر جدید و همچنین توقف و لغو تایمر در حال اجرا، و پرسیدن اینکه چقدر زمان باقی مانده است.

ویژگی های دستگاه

دستگاه های دارای این ویژگی ممکن است ویژگی های زیر را به عنوان بخشی از عملیات SYNC گزارش کنند. برای کسب اطلاعات بیشتر در مورد مدیریت SYNC ، به تحقق هدف مراجعه کنید.

ویژگی های تایپ کنید شرح
maxTimerLimitSec عدد صحیح

ضروری.

طولانی ترین تنظیم تایمر موجود در دستگاه را نشان می دهد که در ثانیه اندازه گیری می شود.

commandOnlyTimer بولی

(پیش‌فرض: false )

نشان می دهد که آیا دستگاه از ارتباط یک طرفه (درست) یا دو طرفه (کاذب) پشتیبانی می کند. اگر دستگاه نمی تواند به یک هدف QUERY یا وضعیت گزارش برای این ویژگی پاسخ دهد، این ویژگی را روی true تنظیم کنید.

مثال ها

دستگاه با محدودیت تایمر دو ساعته.

{
  "maxTimerLimitSec": 7200
}

وضعیت دستگاه

دستگاه‌های دارای این ویژگی ممکن است وضعیت‌های زیر را به عنوان بخشی از عملیات QUERY گزارش کنند. برای کسب اطلاعات بیشتر در مورد مدیریت QUERY ، به تحقق هدف مراجعه کنید.

ایالت ها تایپ کنید شرح
timerRemainingSec عدد صحیح

ضروری.

زمان فعلی باقی مانده بر حسب ثانیه، -1 یا [0، maxTimerLimitSec ]. برای نشان دادن اینکه تایمر در حال اجرا نیست، -1 را تنظیم کنید.

timerPaused بولی

درست است اگر تایمر فعال وجود داشته باشد اما در حال حاضر متوقف شده باشد.

مثال ها

چقدر زمان روی تایمر دستگاه باقی مانده است؟ (در حال اجرا نیست).

{
  "timerRemainingSec": -1
}

چقدر زمان روی تایمر دستگاه باقی مانده است؟ (دویدن).

{
  "timerRemainingSec": 60
}

چقدر زمان روی تایمر دستگاه باقی مانده است؟ (مکث شد).

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

دستورات دستگاه

دستگاه های دارای این ویژگی ممکن است به دستورات زیر به عنوان بخشی از عملیات EXECUTE پاسخ دهند. برای کسب اطلاعات بیشتر در مورد مدیریت EXECUTE intent ها، به اجرای Intent مراجعه کنید.

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

خطاهای دستگاه

لیست کامل خطاها و استثناها را ببینید.