สคีมาลักษณะของปุ่มเปิด/ปิดสมาร์ทโฮม

action.devices.traits.Toggles - ลักษณะนี้เป็นของอุปกรณ์ที่มีการตั้งค่าซึ่งอยู่ได้เพียง 1 ใน 2 สถานะเท่านั้น

การตั้งค่าเหล่านี้อาจแสดงปุ่มจริงที่มีสถานะเปิด/ปิดหรือทำงาน/ไม่ทำงาน ช่องทําเครื่องหมายใน HTML หรือองค์ประกอบอื่นๆ ที่เปิด/ปิดใช้โดยเฉพาะ หากการตั้งค่ามีสถานะมากกว่า 2 สถานะ หรือมีสถานะที่ไม่มีการเลือกตัวเลือกแบบไบนารีใดเลย การแสดงค่าดังกล่าวเป็นModesลักษณะ ซึ่งเทียบเท่ากับหน้าปัดแบบหลายสถานะ ปุ่มตัวเลือก (ปุ่มจริงหรือ HTML) หรือสถานะไบนารีที่ไม่ได้ระบุว่าเปิด/ปิดอย่างชัดเจน (เช่น "AM/FM" หรือ "ร้อน/เย็น") จะเหมาะกว่า

ลักษณะนี้ครอบคลุมสวิตช์แต่ละรายการอย่างน้อย 1 รายการที่ผู้ใช้ตั้งค่าได้ โดยทั่วไปแล้ว ปุ่มเปิด/ปิดเหล่านี้ควรใช้กับฟังก์ชันการทำงานที่ไม่ได้ลิงก์กับลักษณะการทํางานอื่นๆ ของอุปกรณ์ ลักษณะการทำงานที่ลิงก์ เช่น การเปิดหรือปิดอุปกรณ์ ควรใช้ลักษณะที่เฉพาะเจาะจงมากขึ้น (เช่น thermostatMode ในลักษณะ TemperatureSetting)

แอตทริบิวต์อุปกรณ์

อุปกรณ์ที่มีลักษณะนี้อาจรายงานแอตทริบิวต์ต่อไปนี้เป็นส่วนหนึ่งของการดำเนินการ SYNC ดูข้อมูลเพิ่มเติมเกี่ยวกับการจัดการ Intent SYNC ได้ที่การดำเนินการตาม Intent

ตัวอย่าง

อุปกรณ์ที่มีปุ่มเปิด/ปิดหลายปุ่ม

{
  "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 ดูข้อมูลเพิ่มเติมเกี่ยวกับการจัดการ Intent QUERY ได้ที่การดำเนินการตาม Intent

ตัวอย่าง

การฆ่าเชื้อเปิดอยู่ไหม

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

คำสั่งของอุปกรณ์

อุปกรณ์ที่มีลักษณะนี้อาจตอบสนองต่อคําสั่งต่อไปนี้ซึ่งเป็นส่วนหนึ่งของการดำเนินการ EXECUTE ดูข้อมูลเพิ่มเติมเกี่ยวกับการจัดการ Intent EXECUTE ได้ที่การดำเนินการตาม 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
    }
  }
}

ตัวอย่างคำพูด

ข้อผิดพลาดของอุปกรณ์