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

สคีมาแบบสลับเปิด/ปิดอัจฉริยะ

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

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

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

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

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

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

ต้องระบุ

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

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

ปุ่มเปิด/ปิด

name สตริง

ต้องระบุ

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

name_values อาร์เรย์

ต้องระบุ

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

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

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

name_synonym อาร์เรย์

ต้องระบุ

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

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

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

lang สตริง

ต้องระบุ

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

commandOnlyToggles บูลีน

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

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

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
}

อุปกรณ์ STATES

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

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

ต้องระบุ

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

<string> บูลีน

สถานะปุ่มสลับปัจจุบัน

ตัวอย่าง

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

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

อุปกรณ์ COMMANDS

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

action.devices.commands.SetToggles

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

พารามิเตอร์

พารามิเตอร์ Type คำอธิบาย
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 frysen

อุปกรณ์ ERRORS

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