طرحواره ویژگی حالت های خانه هوشمند

action.devices.traits.Modes - این ویژگی تمام حالت های موجود و تنظیمات خاص حالت را برای یک دستگاه پوشش می دهد.

این ویژگی به هر دستگاهی با تعداد دلخواه حالت "n-way" تعلق دارد که در آن حالت ها و تنظیمات برای هر حالت دلخواه و منحصر به هر دستگاه یا نوع دستگاه است. هر حالت دارای چندین تنظیمات ممکن است، اما تنها یکی را می توان در یک زمان انتخاب کرد. یک خشک کن نمی تواند به طور همزمان در حالت "ظریف"، "عادی" و "وظیفه سنگین" باشد. تنظیمی که به سادگی می تواند روشن یا خاموش شود به ویژگی Toggles تعلق دارد.

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

برخی از حالت‌ها "مرتب" هستند و همچنین می‌توان آنها را با حروف بالا/پایین، افزایش/کاهش تنظیم کرد. برای مثال، اندازه بار (کوچک، متوسط، بزرگ) و دما به وضوح مرتب شده است (توجه داشته باشید که دما مانند سایر دستگاه‌ها یک ترموستات واقعی با هدف عددی نیست)، اما نوع بار (ظریف، معمولی، پشمی و غیره) ممکن است نباشد.

این ویژگی یک یا چند حالت فردی را پوشش می دهد که کاربران می توانند تنظیم کنند. به طور کلی، این حالت‌ها باید برای عملکردی استفاده شوند که ارتباطی با سایر رفتار دستگاه ندارد. رفتار مرتبط، مانند روشن یا خاموش کردن خود دستگاه، باید از ویژگی های خاص تری استفاده کند (به عنوان مثال، thermostatMode در صفت TemperatureSetting ).

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

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

صفات تایپ کنید توضیحات
availableModes آرایه

مورد نیاز.

لیست حالت های موجود

[ item, ... ] شیء

حالت موجود

name رشته

مورد نیاز.

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

name_values آرایه

مورد نیاز.

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

[ item, ... ] شیء

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

name_synonym آرایه

مورد نیاز.

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

[ item, ... ] رشته

نام مترادف.

lang رشته

مورد نیاز.

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

settings آرایه

مورد نیاز.

تنظیمات پشتیبانی شده برای این حالت

[ item, ... ] شیء

تنظیم پشتیبانی شده

حداقل به 2 مورد نیاز دارد.

setting_name رشته

مورد نیاز.

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

setting_values آرایه

مورد نیاز.

مترادف تنظیمات در هر زبان پشتیبانی شده.

[ item, ... ] شیء

مترادف تنظیمات در یک زبان معین.

setting_synonym آرایه

مورد نیاز.

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

[ item, ... ] رشته

نام مترادف.

lang رشته

مورد نیاز.

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

ordered بولی

(پیش‌فرض: false )

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

commandOnlyModes بولی

(پیش‌فرض: false )

نشان می دهد که آیا دستگاه از ارتباط یک طرفه (درست) یا دو طرفه (کاذب) پشتیبانی می کند. اگر دستگاه نمی تواند به یک هدف QUERY یا وضعیت گزارش برای این ویژگی پاسخ دهد، این ویژگی را روی true تنظیم کنید.

queryOnlyModes بولی

(پیش‌فرض: false )

اگر دستگاه از اجرای فقط پرس و جو پشتیبانی می کند، لازم است. این ویژگی نشان می‌دهد که آیا دستگاه فقط برای اطلاعات وضعیت قابل جستجو است و نمی‌توان آن را کنترل کرد.

نمونه ها

دستگاه با چند حالت و تنظیمات.

{
  "availableModes": [
    {
      "name": "load_mode",
      "name_values": [
        {
          "name_synonym": [
            "Load",
            "Size",
            "Load size"
          ],
          "lang": "en"
        }
      ],
      "settings": [
        {
          "setting_name": "small_load",
          "setting_values": [
            {
              "setting_synonym": [
                "Small",
                "Half"
              ],
              "lang": "en"
            }
          ]
        },
        {
          "setting_name": "medium_load",
          "setting_values": [
            {
              "setting_synonym": [
                "Medium",
                "Normal"
              ],
              "lang": "en"
            }
          ]
        },
        {
          "setting_name": "large_load",
          "setting_values": [
            {
              "setting_synonym": [
                "Large",
                "Full"
              ],
              "lang": "en"
            }
          ]
        }
      ],
      "ordered": true
    },
    {
      "name": "temp_mode",
      "name_values": [
        {
          "name_synonym": [
            "Temperature",
            "Temp"
          ],
          "lang": "en"
        }
      ],
      "settings": [
        {
          "setting_name": "hot_temp",
          "setting_values": [
            {
              "setting_synonym": [
                "Hot",
                "White"
              ],
              "lang": "en"
            }
          ]
        },
        {
          "setting_name": "warm_temp",
          "setting_values": [
            {
              "setting_synonym": [
                "Warm",
                "Color"
              ],
              "lang": "en"
            }
          ]
        },
        {
          "setting_name": "cold_temp",
          "setting_values": [
            {
              "setting_synonym": [
                "Cold",
                "Delicate"
              ],
              "lang": "en"
            }
          ]
        }
      ],
      "ordered": false
    }
  ]
}

دستگاهی با حالت‌های فقط فرمان.

{
  "availableModes": [
    {
      "name": "light_mode",
      "name_values": [
        {
          "name_synonym": [
            "Light",
            "Lighting"
          ],
          "lang": "en"
        }
      ],
      "settings": [
        {
          "setting_name": "day_light",
          "setting_values": [
            {
              "setting_synonym": [
                "Day",
                "Bright"
              ],
              "lang": "en"
            }
          ]
        },
        {
          "setting_name": "night_light",
          "setting_values": [
            {
              "setting_synonym": [
                "Night",
                "Dark"
              ],
              "lang": "en"
            }
          ]
        },
        {
          "setting_name": "reading_light",
          "setting_values": [
            {
              "setting_synonym": [
                "Reading",
                "Ambiant"
              ],
              "lang": "en"
            }
          ]
        }
      ],
      "ordered": false
    }
  ],
  "commandOnlyModes": true,
  "queryOnlyModes": false
}

وضعیت دستگاه

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

ایالات تایپ کنید توضیحات
currentModeSettings شیء

مورد نیاز.

کلید/مقدار با name حالت دستگاه به عنوان کلید، و setting_name فعلی به عنوان مقدار جفت شود.

<string> رشته

setting_name فعلی.

نمونه ها

دستگاه در چه حالتی است؟

{
  "currentModeSettings": {
    "load_mode": "small_load",
    "temp_mode": "cold_temp"
  }
}

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

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

action.devices.commands.SetModes

تنظیمات حالت را به روز کنید.

پارامترها

پارامترها تایپ کنید توضیحات
updateModeSettings شیء

مورد نیاز.

کلید/مقدار با name حالت دستگاه به عنوان کلید، و setting_name جدید به عنوان مقدار جفت شود.

<string> رشته

setting_name جدید.

نمونه ها

روی بار بزرگ تنظیم کنید.

{
  "command": "action.devices.commands.SetModes",
  "params": {
    "updateModeSettings": {
      "load_mode": "large_load"
    }
  }
}

نمونه گفته ها

de-DE

  • Stelle den Staubsauger auf Ruhemodus

en-US

  • the vacuum to mode energy saver set

es-ES

  • pon la lavadora en modo frío

fr-FR

  • mets l'aspirateur en silencieux

سلام ورود

  • वैक्यूम पर कार्पेट मोड लगाएं

it-IT

  • imposta l'aspirapolvere su silenzioso

ja-JP

  • 掃除機静音モードに設定して

ko-KR

  • 세탁기 세탁량 많음 으로 설정해

pt-BR

  • acionar a função autolimpeza do aspirador
  • ligar o modo de aquecimento

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

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