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

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

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

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

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

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

نمونه ها

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

{
  "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": {
    "sterilization_toggle": true,
    "energysaving_toggle": false
  }
}

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

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

action.devices.commands.SetToggles

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

پارامترها

نمونه ها

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

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

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

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

نمونه گفته ها

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