ยินดีต้อนรับสู่ Google Home Developer Center แหล่งใหม่เรียนรู้วิธีพัฒนาการดําเนินการในบ้านอัจฉริยะ หมายเหตุ: คุณจะสร้างการดําเนินการต่างๆ ต่อไปในคอนโซลการดําเนินการ
จัดทุกอย่างให้เป็นระเบียบอยู่เสมอด้วยคอลเล็กชัน บันทึกและจัดหมวดหมู่เนื้อหาตามค่ากำหนดของคุณ

สคีมาสลับกับสมาร์ทโฮม

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

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

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

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

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

แอตทริบิวต์ ประเภท คำอธิบาย
availableToggles อาร์เรย์

ต้องระบุ

รายการปุ่มสลับที่ใช้ได้

[item, ...] วัตถุ

ปุ่มสลับที่ใช้ได้

name สตริง

ต้องระบุ

ชื่อภายในของปุ่มสลับ ซึ่งจะใช้ในคําสั่งและสถานะ อาจไม่เป็นมิตรต่อผู้ใช้ และจะแชร์กับทุกภาษา

name_values อาร์เรย์

ต้องระบุ

คําพ้องความหมายของปุ่มสลับในแต่ละภาษาที่รองรับ

[item, ...] วัตถุ

คําพ้องความหมายของปุ่มสลับในภาษาหนึ่งๆ

name_synonym อาร์เรย์

ต้องระบุ

คําพ้องความหมายของปุ่มเปิด/ปิด ระบบจะใช้สตริงแรกในรายการนี้เป็นชื่อ Canonical ของระดับในภาษานั้น

[item, ...] สตริง

ชื่อคําพ้องความหมาย

lang สตริง

ต้องระบุ

รหัสภาษา (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 ได้ที่การดําเนินการตามความตั้งใจ

รัฐ ประเภท คำอธิบาย
currentToggleSettings วัตถุ

ต้องระบุ

คู่คีย์/ค่าที่มีปุ่มสลับ name ของอุปกรณ์เป็นคีย์ และสถานะปัจจุบันของค่าคือ

<string> บูลีน

ปุ่มเปิด/ปิดสถานะปัจจุบัน

ตัวอย่าง

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

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

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

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

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ühlschอ่านนโยบาย aus
  • stelle den Kühlschunk auf Power Cool

en-US

  • เปิดใช้งาน ตู้แช่แข็ง สําหรับ ตู้แช่แข็ง
  • ยกเลิก การเปิด/ปิดความเย็น สําหรับ ตู้เย็นในห้องครัว

es-ES

  • pon el enfriamiento rápido en laNevera
  • quita el enfriamiento rápido

fr-FR

  • Meets le Mode แหล่งพลังงานสุดเจ๋ง sur le réfrigérateur
  • โหมด Éteins le ปิดเครื่องฟรี du réfrigérateur .

อุปกรณ์ ERRORS

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