طرحواره ویژگی RunCycle خانه هوشمند
action.devices.traits.RunCycle
- این ویژگی هر دستگاهی را نشان می دهد که مدت زمان کارکرد آن ادامه دارد و می توان آن را پرس و جو کرد.
دستگاههایی مانند این تعداد کل چرخههای خود را در شروع کار گزارش میکنند و هر چرخه دستگاه در حال حاضر در حال کار است. این به کاربر اجازه می دهد تا درخواست هایی مانند موارد زیر را انجام دهد:
- خشک کن من در چه چرخه ای است؟
- ماشین ظرفشویی چند چرخه باقی مانده است؟
- خشک کن چه کار می کند؟
- شستشو چه زمانی انجام می شود؟
برخی از دستگاهها دارای مدت زمان در قالب غیر چرخهای هستند. هر دستگاهی که برای مدت زمان مشخصی کار می کند می تواند زمان باقی مانده خود را بدون چرخه گزارش دهد. این همچنین مواردی را که ممکن است چرخه ها هماهنگ نباشند (به عنوان مثال، ماشین ظرفشویی ممکن است همیشه از همه چرخه ها استفاده نکند) رسیدگی می کند. به عنوان مثال یک کاربر می تواند بپرسد که خلاء من چقدر دیگر کار می کند؟ که مقدار زمان را بر حسب واحد متناسب با زمان باقیمانده برمی گرداند. این همچنین در مورد دستگاه های ذکر شده در بالا صدق می کند. لباس های من چقدر دیگر خشک می شوند؟ مدت زمان را در چند دقیقه برمی گرداند.
دستگاهها میتوانند آنچه را که میدانند برگردانند و پاسخ Assistant TTS بهترین پاسخ را با دادههای موجود تشکیل میدهد (به عنوان مثال، ماشین ظرفشویی در حال کار است و در حدود 20 دقیقه تکمیل میشود. )
RunCycle در حال حاضر یک ویژگی فقط خواندنی است - هیچ دستوری ندارد، فقط حالت هایی برای پرس و جو دارد. در آینده، ممکن است مکانیسمهایی برای اجرای مجدد چرخهها یا پرش چرخهها (مناسب برای آبپاشها، بد برای ماشینهای لباسشویی) وجود داشته باشد.
ویژگی های دستگاه
هیچ یک.
وضعیت دستگاه
دستگاههای دارای این ویژگی ممکن است وضعیتهای زیر را به عنوان بخشی از عملیات QUERY
گزارش کنند. برای کسب اطلاعات بیشتر در مورد مدیریت QUERY
، به تحقق هدف مراجعه کنید.
ایالت ها | تایپ کنید | شرح |
---|---|---|
currentRunCycle | آرایه | ضروری. شامل مترادف های چرخه جاری در هر زبان پشتیبانی شده است. |
[ item, ... ] | هدف - شی | نام های مترادف چرخه. |
currentCycle | رشته | ضروری. چرخه فعلی در حال انجام است. |
nextCycle | رشته | اختیاری. چرخه بعدی برای اجرا |
lang | رشته | ضروری. کد زبان برای نام چرخه داده شده. به زبان های پشتیبانی شده مراجعه کنید. |
currentTotalRemainingTime | عدد صحیح | ضروری. زمان باقی مانده در عملیات، در ثانیه. |
currentCycleRemainingTime | عدد صحیح | ضروری. زمان باقی مانده در چرخه فعلی، بر حسب ثانیه. |
مثال ها
دستگاه به مدت 5 دقیقه دیگر در آبکشی است و 20 دقیقه دیگر انجام می شود.
{ "currentRunCycle": [ { "currentCycle": "rinse", "lang": "en" } ], "currentTotalRemainingTime": 1200, "currentCycleRemainingTime": 300 }
قبل از حرکت به چرخش، دستگاه به مدت 5 دقیقه دیگر در آبکشی است.
{ "currentRunCycle": [ { "currentCycle": "rinse", "nextCycle": "spin", "lang": "en" } ], "currentTotalRemainingTime": 600, "currentCycleRemainingTime": 300 }
دستورات دستگاه
هیچ یک.
اطلاعیه های دستگاه
دستگاههای دارای این ویژگی ممکن است بار اعلان زیر را به عنوان بخشی از تغییر وضعیت دستگاه برگردانند. برای کسب اطلاعات بیشتر در مورد اجرای اعلانها، به اطلاعیهها برای اقدامات خانه هوشمند مراجعه کنید.
زمینه های | تایپ کنید | شرح |
---|---|---|
RunCycle | ضروری. بار اعلان. | |
یکی از موارد زیر را پشتیبانی می کند: | ||
0 | هدف - شی | موفقیت |
priority | عدد صحیح | ضروری. سطح اعلان را نشان می دهد. مقدار پشتیبانی شده در حال حاضر 0 است، که نشان می دهد اعلان باید با صدای بلند گفته شود. |
status | رشته | ضروری. نتیجه عملیات. مقادیر پشتیبانی شده:
|
currentCycleRemainingTime | عدد صحیح | ضروری. زمان باقی مانده در چرخه فعلی، بر حسب ثانیه. |
1 | هدف - شی | شکست |
priority | عدد صحیح | ضروری. سطح اعلان را نشان می دهد. مقدار پشتیبانی شده در حال حاضر 0 است، که نشان می دهد اعلان باید با صدای بلند گفته شود. |
status | رشته | ضروری. نتیجه عملیات. مقادیر پشتیبانی شده:
|
errorCode | رشته | ضروری. مقدار می تواند هر کد خطایی برای این ویژگی باشد، به عنوان مثال، |
مثال ها
کارکرد دستگاه به پایان رسیده است.
{ "RunCycle": { "priority": 0, "status": "SUCCESS", "currentCycleRemainingTime": 0 } }
در تکمیل چرخه فعلی خطایی روی داد.
{ "RunCycle": { "priority": 0, "status": "FAILURE", "errorCode": "deviceStuck" } }