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

action.devices.traits.Toggles - این ویژگی متعلق به هر دستگاهی با تنظیماتی است که فقط در یکی از دو حالت وجود دارد.

این تنظیمات می‌توانند یک دکمه فیزیکی با حالت روشن/خاموش یا فعال/غیرفعال، یک چک باکس در HTML یا هر نوع عنصر فعال/غیرفعال شده دیگر را نشان دهند. اگر تنظیم بیش از دو حالت داشته باشد یا حالتی داشته باشد که هیچ یک از گزینه های باینری انتخاب نشده باشد، بهتر است به عنوان یک ویژگی Modes نشان داده شود که معادل شماره گیری چند حالته، دکمه های رادیویی (فیزیکی یا HTML) یا باینری است. حالت هایی که به صراحت روشن/خاموش نیستند (به عنوان مثال، "AM/FM" یا "گرم/سرد").

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

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

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

صفات	تایپ کنید	توضیحات
availableToggles	آرایه	مورد نیاز. لیست ضامن های موجود
[ item, ... ]	شیء	تغییر وضعیت موجود
name	رشته	مورد نیاز. نام داخلی ضامن، که در دستورات و حالت ها استفاده خواهد شد. این می تواند کاربر پسند نباشد و در همه زبان ها به اشتراک گذاشته شود.
name_values	آرایه	مورد نیاز. مترادف ضامن در هر زبان پشتیبانی شده.
[ item, ... ]	شیء	مترادف ضامن در یک زبان معین.
name_synonym	آرایه	مورد نیاز. مترادف ضامن. اولین رشته در این لیست به عنوان نام متعارف سطح در آن زبان استفاده می شود.
[ item, ... ]	رشته	نام مترادف.
lang	رشته	مورد نیاز. کد زبان (ISO 639-1). زبان های پشتیبانی شده را ببینید.
commandOnlyToggles	بولی	(پیش‌فرض: false ) نشان می دهد که آیا دستگاه از ارتباط یک طرفه (درست) یا دو طرفه (کاذب) پشتیبانی می کند. اگر دستگاه نمی تواند به یک هدف QUERY یا وضعیت گزارش برای این ویژگی پاسخ دهد، این ویژگی را روی true تنظیم کنید.
queryOnlyToggles	بولی	(پیش‌فرض: false ) اگر دستگاه از اجرای فقط پرس و جو پشتیبانی می کند، لازم است. این ویژگی نشان می‌دهد که آیا دستگاه فقط برای اطلاعات وضعیت قابل جستجو است و نمی‌توان آن را کنترل کرد.

نمونه ها

دستگاه با چند کلید.

{
  "availableToggles": [
    {
      "name": "sterilization_toggle",
      "name_values": [
        {
          "name_synonym": [
            "Clean",
            "Bio clean"
          ],
          "lang": "en"
        }
      ]
    },
    {
      "name": "energysaving_toggle",
      "name_values": [
        {
          "name_synonym": [
            "Energy saving",
            "Eco"
          ],
          "lang": "en"
        }
      ]
    }
  ]
}

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

{
  "availableToggles": [
    {
      "name": "filter_toggle",
      "name_values": [
        {
          "name_synonym": [
            "Filtered",
            "Filter"
          ],
          "lang": "en"
        }
      ]
    }
  ],
  "commandOnlyToggles": true
}

دستگاه با کلیدهای فقط پرس و جو.

{
  "availableToggles": [
    {
      "name": "filter_toggle",
      "name_values": [
        {
          "name_synonym": [
            "Filtered",
            "Filter"
          ],
          "lang": "en"
        }
      ]
    }
  ],
  "queryOnlyToggles": true
}

وضعیت دستگاه

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

ایالات	تایپ کنید	توضیحات
currentToggleSettings	شیء	مورد نیاز. جفت کلید/مقدار با name کلید دستگاه به عنوان کلید و وضعیت فعلی به عنوان مقدار.
<string>	بولی	وضعیت جابجایی فعلی

نمونه ها

آیا عقیم سازی شروع شده است؟

{
  "currentToggleSettings": {
    "sterilization_toggle": true,
    "energysaving_toggle": false
  }
}

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

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

action.devices.commands.SetToggles

یک وضعیت تغییر وضعیت داده شده را تنظیم کنید.

پارامترها

پارامترها	تایپ کنید	توضیحات
updateToggleSettings	شیء	مورد نیاز. جفت کلید/مقدار با name کلید دستگاه به عنوان کلید و حالت جدید به عنوان مقدار.
<string>	بولی	وضعیت تغییر وضعیت جدید

نمونه ها

صرفه جویی در انرژی را روشن کنید.

{
  "command": "action.devices.commands.SetToggles",
  "params": {
    "updateToggleSettings": {
      "energysaving_toggle": true
    }
  }
}

فیلتر را خاموش کنید

{
  "command": "action.devices.commands.SetToggles",
  "params": {
    "updateToggleSettings": {
      "filter_toggle": false
    }
  }
}

نمونه گفته ها

de-DE

• Bitte schalte Power Cool am Kühlschrank aus
• stelle den Kühlschrank auf Power Cool

en-US

• power freeze for the freezer activate
• cancel power cool for the kitchen fridge

es-ES

• pon el enfriamiento rápido en la nevera
• quita el enfriamiento rápido

fr-FR

• mets le mode power cool sur le réfrigérateur
• Éteins le mode power freeze du réfrigérateur .

سلام ورود

• रेफ़्रिजरेटर का पावर कूल मोड बंद कर दो
• रेफ़्रिजरेटर में पावर कूल मोड चालू करो

it-IT

• disattiva il power freeze del freezer
• imposta la funzione power freeze del surgelatore

ja-JP

• 冷蔵庫の急速冷凍つけて
• 冷蔵庫の急速冷凍を切ってくれる

ko-KR

• 냉장고 급속 냉장 해제해
• 냉장고 모드 급속 냉장 으로 바꿔

nl-NL

• Zet de power cool uit op de koelkast
• zet de koelkast op superkoelen

pt-BR

• Ativa a função power freeze no congelador .
• Desativa o bloqueio infantil do forno .
• desligar o power cool da geladeira
• iniciar o modo power freeze do freezer

sv-SE

• Stäng av power cool i kylskåpet
• sätt på power freeze på frysen

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

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