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

แบบแผนโหมดอัจฉริยะในบ้าน

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

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

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

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

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

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

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

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

ต้องระบุ

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

[item, ...] ออบเจ็กต์

โหมดพร้อมใช้งาน

name สตริง

ต้องระบุ

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

name_values อาร์เรย์

ต้องระบุ

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

[item, ...] ออบเจ็กต์

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

name_synonym อาร์เรย์

ต้องระบุ

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

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

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

lang สตริง

ต้องระบุ

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

settings อาร์เรย์

ต้องระบุ

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

[item, ...] ออบเจ็กต์

การตั้งค่าที่สนับสนุน

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

setting_name สตริง

ต้องระบุ

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

setting_values อาร์เรย์

ต้องระบุ

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

[item, ...] ออบเจ็กต์

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

setting_synonym อาร์เรย์

ต้องระบุ

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

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

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

lang สตริง

ต้องระบุ

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

ordered บูลีน

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

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

commandOnlyModes บูลีน

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

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

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
}

อุปกรณ์ STATES

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

รัฐ Type คำอธิบาย
currentModeSettings ออบเจ็กต์

ต้องระบุ

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

<string> สตริง

ปัจจุบัน setting_name

ตัวอย่าง

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

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

อุปกรณ์ COMMANDS

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

action.devices.commands.SetModes

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

พารามิเตอร์

พารามิเตอร์ Type คำอธิบาย
updateModeSettings ออบเจ็กต์

ต้องระบุ

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

<string> สตริง

setting_name ใหม่

ตัวอย่าง

ตั้งค่าเป็น "โหลดขนาดใหญ่"

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

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

de-DE

  • Stelle den Staubsauger auf Ruhemodus

en-US

  • set the vacuum to energy saver mode

es-ES

  • pon la lavadora en modo frío

fr-FR

  • mets l'aspirateur en silencieux

hi-IN

  • वैक्यूम पर कार्पेट मोड लगाएं

it-IT

  • imposta l'aspirapolvere su silenzioso

ja-JP

  • 掃除機 静音 モードに設定して

ko-KR

  • 세탁기 세탁량 많음 으로 설정해

pt-BR

  • acionar a função autolimpeza do aspirador
  • ligar o modo de aquecimento

อุปกรณ์ ERRORS

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