สมาร์ทโฮมสลับสคีมาลักษณะเฉพาะ

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

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

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

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

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

Attributes	ประเภท	คำอธิบาย
availableToggles	อาร์เรย์	ต้องระบุ รายการปุ่มเปิด/ปิดที่ใช้ได้
[item, ...]	ออบเจ็กต์	ปุ่มสลับใช้งานได้
name	String	ต้องระบุ ชื่อภายในของปุ่มเปิด/ปิด ซึ่งจะใช้ในคำสั่งและสถานะ ข้อมูลนี้อาจไม่เหมาะกับผู้ใช้ และจะแชร์ในทุกภาษา
name_values	อาร์เรย์	ต้องระบุ คำพ้องความหมายของปุ่มเปิด/ปิดในแต่ละภาษาที่รองรับ
[item, ...]	ออบเจ็กต์	คำพ้องความหมายของการสลับในภาษาหนึ่งๆ
name_synonym	อาร์เรย์	ต้องระบุ คำพ้องความหมายของปุ่มเปิด/ปิด สตริงแรกในรายการนี้จะใช้เป็นชื่อ Canonical ของระดับในภาษานั้น
[item, ...]	String	ชื่อคำพ้องความหมาย
lang	String	ต้องระบุ รหัสภาษา (ISO 639-1) ดูภาษาที่รองรับ
commandOnlyToggles	บูลีน	(ค่าเริ่มต้น: false) ระบุว่าอุปกรณ์รองรับการสื่อสารแบบทางเดียว (จริง) หรือ 2 ทาง (เท็จ) ตั้งค่าแอตทริบิวต์นี้เป็น "จริง" หากอุปกรณ์ตอบสนองต่อ Intent ของ QUERY หรือสถานะรายงานสำหรับลักษณะนี้ไม่ได้
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 เพื่อเรียนรู้ ดูข้อมูลเพิ่มเติมเกี่ยวกับการจัดการ Intent QUERY ได้ที่ การจำหน่าย Intent

รัฐ	ประเภท	คำอธิบาย
currentToggleSettings	ออบเจ็กต์	ต้องระบุ คู่คีย์/ค่าที่มีปุ่มสลับ name ของอุปกรณ์เป็นคีย์ และสถานะปัจจุบันของอุปกรณ์
<string>	บูลีน	สถานะการสลับปัจจุบัน

ตัวอย่าง

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

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

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

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

• activate power freeze for the freezer
• 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 .

hi-IN

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

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

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

ดูรายการทั้งหมดของ ข้อผิดพลาดและข้อยกเว้น