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

action.devices.traits.Fill - این ویژگی برای دستگاه هایی اعمال می شود که از پر شدن پشتیبانی می کنند مانند وان حمام.

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

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

صفات تایپ کنید توضیحات
availableFillLevels شیء

سطوح مختلف پر کردن دستگاه را شرح می دهد.

levels آرایه

مورد نیاز.

فهرست اسامی سطوح و مترادف های خاص زبان.

[ item, ... ] شیء

نام سطح و مترادف های خاص زبان آن.

level_name رشته

مورد نیاز.

نام داخلی سطح این می تواند کاربر پسند نباشد و در همه زبان ها به اشتراک گذاشته شود.

level_values آرایه

مورد نیاز.

مترادف سطح در هر زبان پشتیبانی شده.

[ item, ... ] شیء

مترادف سطح در یک زبان معین.

level_synonym آرایه

مورد نیاز.

مترادف سطح. اولین رشته در این لیست به عنوان نام متعارف سطح در آن زبان استفاده می شود.

[ item, ... ] رشته

نام مترادف.

lang رشته

مورد نیاز.

کد زبان (ISO 639-1). زبان های پشتیبانی شده را ببینید.

ordered بولی

مورد نیاز.

اگر درست باشد، دستگاه دستور زبان اضافی را برای منطق افزایش یا کاهش، همانطور که توسط آرایه levels نشان داده شده است (به عنوان مثال، نیم سطح) کنترل می کند.

supportsFillPercent بولی

(پیش‌فرض: false )

اگر درست است، دستورات را برای تنظیم سطح به درصد بپذیرید.

نمونه ها

دستگاهی با قابلیت های اولیه پر کردن یا تخلیه که از سطوح پر شدن مجزا پشتیبانی نمی کند.

{}

دستگاهی که از سطوح پر گسسته پشتیبانی می کند.

{
  "availableFillLevels": {
    "levels": [
      {
        "level_name": "half_level",
        "level_values": [
          {
            "level_synonym": [
              "Half",
              "Half way",
              "One half"
            ],
            "lang": "en"
          }
        ]
      },
      {
        "level_name": "full_level",
        "level_values": [
          {
            "level_synonym": [
              "Full",
              "All the way",
              "Complete"
            ],
            "lang": "en"
          }
        ]
      }
    ],
    "ordered": true
  }
}

وضعیت دستگاه

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

ایالات تایپ کنید توضیحات
isFilled بولی

مورد نیاز.

درست است اگر دستگاه تا هر سطحی پر شده باشد. اگر دستگاه به طور کامل تخلیه شده باشد نادرست است.

currentFillLevel رشته

اگر ویژگی availableFillLevels تنظیم شده باشد، الزامی است. level_name فعلی را از ویژگی availableFillLevels که دستگاه در آن پر شده است نشان می دهد.

currentFillPercent شماره

اگر ویژگی supportsFillPercent تنظیم شده باشد، لازم است. درصد سطح پر شدن فعلی را نشان می دهد.

نمونه ها

آیا وان حمام پر شده است؟

{
  "isFilled": true
}

آیا وان حمام پر شده است؟ (با سطوح).

{
  "isFilled": true,
  "currentFillLevel": "half_level"
}

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

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

action.devices.commands.Fill

دستگاه را پر یا تخلیه کنید.

پارامترها

پارامترها تایپ کنید توضیحات
fill بولی

مورد نیاز.

درست برای پر کردن، نادرست برای تخلیه.

fillLevel رشته

level_name از ویژگی availableFillLevels برای تنظیم نشان می دهد. اگر مشخص نیست، آن را تا سطح پیش فرض پر کنید.

fillPercent شماره

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

نمونه ها

وان حمام را پر کنید.

{
  "command": "action.devices.commands.Fill",
  "params": {
    "fill": true
  }
}

وان حمام را تخلیه کنید.

{
  "command": "action.devices.commands.Fill",
  "params": {
    "fill": false
  }
}

وان حمام را تا نیمه پر کنید.

{
  "command": "action.devices.commands.Fill",
  "params": {
    "fill": true,
    "fillLevel": "half_level"
  }
}

سطح پر شدن وان حمام را یک بار افزایش دهید (برای true بودن صفت ordered لازم است).

{
  "command": "action.devices.commands.Fill",
  "params": {
    "fill": true,
    "fillLevel": "full_level"
  }
}

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

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