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

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

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

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