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

สคีมาของโหมดอัจฉริยะในบ้าน

action.devices.traits.Modes - ลักษณะเฉพาะนี้ครอบคลุมโหมดทั้งหมดและการตั้งค่าเฉพาะโหมดสําหรับอุปกรณ์

ลักษณะเฉพาะนี้จะอยู่ในอุปกรณ์ใดก็ตามที่มีโหมด "n-way" ที่กําหนดเอง โดยโหมดและการตั้งค่าของแต่ละโหมดจะไม่ซ้ํากันและไม่ซ้ํากันในอุปกรณ์แต่ละประเภท แต่ละโหมดมีการตั้งค่าที่เป็นไปได้หลายรายการ แต่สามารถเลือกได้ครั้งละ 1 เครื่อง ส่วนเครื่องอบผ้าจะอยู่ในโหมด "ที่ละเอียดอ่อน" "ปกติ" และ "หน้าที่หนัก" ไม่ได้พร้อมกัน การตั้งค่าที่สามารถเปิดหรือปิดได้ จะอยู่ในฟีเจอร์สลับ

เช่น เครื่องซักผ้ามีการตั้งค่าสําหรับขนาดและอุณหภูมิของผ้า ทั้ง 2 อย่างนี้ล้วนเป็นโหมดแยกจากกันเพราะแต่ละโหมดสามารถมีสถานะได้ทีละ 1 สถานะเท่านั้น ผู้ใช้สามารถตั้งโหมด เช่น อุณหภูมิได้ชัดเจนด้วยคําสั่ง เช่น ตั้งอุณหภูมิของเครื่องซักผ้าเป็น เย็น

บางโหมดเป็นแบบ "เรียงลําดับแล้ว" และยังปรับขึ้น/ลง เพิ่ม/ลดคํากริยาได้อีกด้วย เช่น ขนาดการโหลด (เล็ก กลาง ใหญ่) และอุณหภูมิมีลําดับที่ชัดเจน (โปรดทราบว่าอุณหภูมิไม่ใช่ตัวควบคุมอุณหภูมิจริงที่กําหนดให้เป็นตัวเลขเป้าหมาย เช่น อุปกรณ์อื่นๆ) แต่ประเภทการโหลด (อุณหภูมิ ปกติ ขนสัตว์ ฯลฯ) อาจไม่เกิดขึ้น

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

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

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

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

ต้องระบุ

รายการโหมดที่ใช้ได้

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

โหมดที่ใช้ได้

name สตริง

ต้องระบุ

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

name_values อาร์เรย์

ต้องระบุ

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

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

คําพ้องความหมายของโหมดในภาษาหนึ่งๆ

name_synonym อาร์เรย์

ต้องระบุ

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

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

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

lang สตริง

ต้องระบุ

รหัสภาษา (ISO 639-1) ดูภาษาที่รองรับ

settings อาร์เรย์

ต้องระบุ

การตั้งค่าที่รองรับสําหรับโหมดนี้

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

การตั้งค่าที่รองรับ

ต้องมีอย่างน้อย 2 รายการ

setting_name สตริง

ต้องระบุ

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

setting_values อาร์เรย์

ต้องระบุ

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

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

คําพ้องความหมายของการตั้งค่าในภาษาหนึ่งๆ

setting_synonym อาร์เรย์

ต้องระบุ

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

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

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

lang สตริง

ต้องระบุ

รหัสภาษา (ISO 639-1) ดูภาษาที่รองรับ

ordered บูลีน

(ค่าเริ่มต้น: false)

หากตั้งค่าเป็น "จริง" จะมีการใช้ไวยากรณ์เพิ่มเติมสําหรับตรรกะการเพิ่ม/ลดตามลําดับของอาร์เรย์การตั้งค่า (เพิ่มขึ้น)

commandOnlyModes บูลีน

(ค่าเริ่มต้น: false)

ระบุว่าอุปกรณ์รองรับการสื่อสารทางเดียว (จริง) หรือแบบ 2 ทาง (เท็จ) ตั้งค่าแอตทริบิวต์นี้เป็น "จริง" หากอุปกรณ์ตอบกลับ Intent ของ QUERY หรือสถานะรายงานสําหรับลักษณะนี้ไม่ได้

queryOnlyModes บูลีน

(ค่าเริ่มต้น: false)

ต้องระบุ หากอุปกรณ์รองรับการดําเนินการค้นหาเท่านั้น แอตทริบิวต์นี้ระบุว่าค้นหาอุปกรณ์ได้เฉพาะข้อมูลสถานะเท่านั้น และไม่สามารถควบคุมได้

ตัวอย่าง

อุปกรณ์ที่มีโหมดและการตั้งค่าหลายรายการ

{
  "availableModes": [
    {
      "name": "load_mode",
      "name_values": [
        {
          "name_synonym": [
            "load",
            "size",
            "load size"
          ],
          "lang": "en"
        }
      ],
      "settings": [
        {
          "setting_name": "small_load",
          "setting_values": [
            {
              "setting_synonym": [
                "small",
                "half"
              ],
              "lang": "en"
            }
          ]
        },
        {
          "setting_name": "medium_load",
          "setting_values": [
            {
              "setting_synonym": [
                "medium",
                "normal"
              ],
              "lang": "en"
            }
          ]
        },
        {
          "setting_name": "large_load",
          "setting_values": [
            {
              "setting_synonym": [
                "large",
                "full"
              ],
              "lang": "en"
            }
          ]
        }
      ],
      "ordered": true
    },
    {
      "name": "temp_mode",
      "name_values": [
        {
          "name_synonym": [
            "temperature",
            "temp"
          ],
          "lang": "en"
        }
      ],
      "settings": [
        {
          "setting_name": "hot_temp",
          "setting_values": [
            {
              "setting_synonym": [
                "hot",
                "white"
              ],
              "lang": "en"
            }
          ]
        },
        {
          "setting_name": "warm_temp",
          "setting_values": [
            {
              "setting_synonym": [
                "warm",
                "color"
              ],
              "lang": "en"
            }
          ]
        },
        {
          "setting_name": "cold_temp",
          "setting_values": [
            {
              "setting_synonym": [
                "cold",
                "delicate"
              ],
              "lang": "en"
            }
          ]
        }
      ],
      "ordered": false
    }
  ]
}

อุปกรณ์ที่มีโหมดคําสั่งเท่านั้น

{
  "availableModes": [
    {
      "name": "light_mode",
      "name_values": [
        {
          "name_synonym": [
            "light",
            "lighting"
          ],
          "lang": "en"
        }
      ],
      "settings": [
        {
          "setting_name": "day_light",
          "setting_values": [
            {
              "setting_synonym": [
                "day",
                "bright"
              ],
              "lang": "en"
            }
          ]
        },
        {
          "setting_name": "night_light",
          "setting_values": [
            {
              "setting_synonym": [
                "night",
                "dark"
              ],
              "lang": "en"
            }
          ]
        },
        {
          "setting_name": "reading_light",
          "setting_values": [
            {
              "setting_synonym": [
                "reading",
                "ambiant"
              ],
              "lang": "en"
            }
          ]
        }
      ],
      "ordered": false
    }
  ],
  "commandOnlyModes": true,
  "queryOnlyModes": false
}

สถานะอุปกรณ์

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

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

ต้องระบุ

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

<string> สตริง

ปัจจุบัน setting_name

ตัวอย่าง

อุปกรณ์อยู่ในโหมดใด

{
  "currentModeSettings": {
    "load_mode": "small_load",
    "temp_mode": "cold_temp"
  }
}

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

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

action.devices.commands.SetModes

อัปเดตการตั้งค่าโหมด

พารามิเตอร์

พารามิเตอร์ ประเภท คำอธิบาย
updateModeSettings วัตถุ

ต้องระบุ

คู่คีย์/ค่าที่มีโหมด name ของอุปกรณ์เป็นคีย์และ setting_name ใหม่เป็นค่า

<string> สตริง

setting_name ใหม่

ตัวอย่าง

ตั้งค่าให้โหลดขนาดใหญ่

{
  "command": "action.devices.commands.SetModes",
  "params": {
    "updateModeSettings": {
      "load_mode": "large_load"
    }
  }
}

ตัวอย่างเสียงพูด

de-DE

  • เซนต์ den Staubsauger auf Ruhemodus

en-US

  • ตั้งค่า เครื่องดูดฝุ่น ไปยัง โหมดประหยัดพลังงาน โหมดประหยัดพลังงาน

es-ES

  • pon la lavadora en modo frío

fr-FR

  • พบกับ l'aspirateur en silencieux

อุปกรณ์ ERRORS

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