طرحواره ویژگی 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" } }