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

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"
  }
}

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

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