طرحواره ویژگی خانه هوشمند را پر کنید

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

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

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

ویژگی‌ها نوع توضیحات
availableFillLevels شیء

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

levels آرایه

الزامی است.

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

[ item, ... ] شیء

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

level_name رشته

الزامی است.

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

level_values آرایه

الزامی است.

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

[ item, ... ] شیء

مترادف‌های سطح در یک زبان معین. حداقل یک مورد با مقدار lang برابر با en برای ارائه جایگزین زبان مورد نیاز است.

level_synonym آرایه

الزامی است.

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

[ item, ... ] رشته

نام مترادف. حداقل یک آیتم با مقدار lang برابر با en برای ارائه جایگزین زبان مورد نیاز است.

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 بولی

الزامی است.

اگر دستگاه تا هر سطحی پر شده باشد، درست (true) و اگر دستگاه کاملاً تخلیه شده باشد، نادرست (false) است.

currentFillLevel رشته

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

currentFillPercent شماره

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

مقدار باید بین 0 تا 100 باشد.

مثال‌ها

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

{
  "isFilled": true
}

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

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

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

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

action.devices.commands.Fill

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

پارامترها

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

الزامی است.

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

fillLevel رشته

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

fillPercent شماره

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

مقدار باید بین 0 تا 100 باشد.

مثال‌ها

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

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

سطح پر شدن وان حمام را یک واحد افزایش می‌دهد (الزام دارد که ویژگی ordered attribute) برابر با true باشد).

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

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

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