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

สคีมาของอุณหภูมิอัจฉริยะในบ้าน

action.devices.traits.TemperatureSetting - ลักษณะเฉพาะนี้ครอบคลุมการจัดการทั้งจุดอุณหภูมิและโหมด

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

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

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

ต้องระบุ

อธิบายโหมดตัวควบคุมอุณหภูมิที่อุปกรณ์นี้รองรับได้

รองรับการใช้งานอย่างใดอย่างหนึ่งต่อไปนี้
0 สตริง

เลิกใช้งานแล้ว

รายการโหมดที่อุปกรณ์นี้รองรับและคั่นด้วยคอมมา การผสานรวมใหม่ควรใช้แบบฟอร์ม Array ของแอตทริบิวต์นี้

1 อาร์เรย์

รายการโหมดที่อุปกรณ์นี้รองรับ

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

ชื่อโหมดที่รองรับ

ค่าที่รองรับมีดังต่อไปนี้

off
ปิดใช้การทําความร้อน/ทําความเย็น
heat
อุปกรณ์รองรับการทําความร้อน
cool
อุปกรณ์รองรับการทําความเย็น
on
คืนค่าโหมดก่อนหน้าของอุปกรณ์ โหมด on จะไม่ปรากฏในหน้าจอการเลือกโหมด เนื่องจากโหมด on ออกแบบมาให้ใช้กู้คืนโหมดก่อนหน้าของอุปกรณ์
heatcool
คงเป้าหมายการทําความร้อน/ทําความเย็นเป็นช่วง
auto
โหมดอัตโนมัติที่มีอุณหภูมิที่ตั้งไว้ตามตารางเวลาหรือพฤติกรรมที่เรียนรู้
fan-only
พัดลมทํางานโดยไม่มีความร้อน/ทําความเย็น
purifier
โหมดฟอกอากาศ
eco
โหมดประหยัดพลังงาน
dry
โหมดแห้ง
thermostatTemperatureRange วัตถุ

มีค่าแบบลอย 2 ค่าซึ่งระบุช่วงอุณหภูมิที่รองรับสําหรับอุปกรณ์นี้ (องศาเซลเซียส)

minThresholdCelsius Number

ต้องระบุ

เกณฑ์ขั้นต่ําของช่วงอุณหภูมิ

maxThresholdCelsius Number

ต้องระบุ

เกณฑ์สูงสุดของช่วงอุณหภูมิ

thermostatTemperatureUnit สตริง

ต้องระบุ

หน่วยแสดงผลที่อุปกรณ์ตั้งไว้โดยค่าเริ่มต้น Google จะรายงานข้อมูลอุณหภูมิโดยใช้หน่วยแสดงผล

ค่าที่รองรับมีดังต่อไปนี้

C
F
bufferRangeCelsius Number

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

ระบุออฟเซ็ตขั้นต่ําระหว่างจุดทําความร้อน • ทําความเย็นในหน่วย องศาเซลเซียส หากรองรับโหมด heatcool

commandOnlyTemperatureSetting บูลีน

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

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

queryOnlyTemperatureSetting บูลีน

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

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

ตัวอย่าง

ตัวควบคุมอุณหภูมิที่รองรับการทําความร้อนและความเย็นแบบแยกต่างหาก

{
  "availableThermostatModes": [
    "off",
    "heat",
    "cool",
    "on"
  ],
  "thermostatTemperatureUnit": "F"
}

อุปกรณ์ตัวควบคุมอุณหภูมิเท่านั้น

{
  "availableThermostatModes": [
    "off",
    "heat",
    "cool",
    "on"
  ],
  "thermostatTemperatureUnit": "C",
  "commandOnlyTemperatureSetting": true,
  "queryOnlyTemperatureSetting": false
}

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

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

รัฐ ประเภท คำอธิบาย
activeThermostatMode สตริง

โหมดใช้งานของอุปกรณ์ในปัจจุบันจากรายการ availableThermostatModes หากไม่มีโหมดที่ทํางานอยู่ในขณะนี้ ให้ตั้งค่าเป็น none

ค่าที่รองรับมีดังต่อไปนี้

none
ไม่มีโหมดแอ็กทีฟ
off
ปิดใช้การทําความร้อน/ทําความเย็น
heat
อุปกรณ์รองรับการทําความร้อน
cool
อุปกรณ์รองรับการทําความเย็น
on
คืนค่าโหมดก่อนหน้าของอุปกรณ์ โหมด on จะไม่ปรากฏในหน้าจอการเลือกโหมด เนื่องจากโหมด on ออกแบบมาให้ใช้กู้คืนโหมดก่อนหน้าของอุปกรณ์
heatcool
คงเป้าหมายการทําความร้อน/ทําความเย็นเป็นช่วง
auto
โหมดอัตโนมัติที่มีอุณหภูมิที่ตั้งไว้ตามตารางเวลาหรือพฤติกรรมที่เรียนรู้
fan-only
พัดลมทํางานโดยไม่มีความร้อน/ทําความเย็น
purifier
โหมดฟอกอากาศ
eco
โหมดประหยัดพลังงาน
dry
โหมดแห้ง
targetTempReachedEstimateUnixTimestampSec จำนวนเต็ม

การประทับเวลาที่บอกเวลาโดยประมาณเมื่อถึงอุณหภูมิเป้าหมาย

thermostatHumidityAmbient Number

แสดงระดับความชื้นโดยรอบที่เกี่ยวข้องหากอุปกรณ์รองรับ

มีสิ่งใดสิ่งหนึ่งต่อไปนี้
0 วัตถุ

สถานะสําหรับจุดคงที่

thermostatMode สตริง

ต้องระบุ

โหมดปัจจุบันของอุปกรณ์จากรายการ availableThermostatModes

ค่าที่รองรับมีดังต่อไปนี้

none
ไม่มีโหมดแอ็กทีฟ
off
ปิดใช้การทําความร้อน/ทําความเย็น
heat
อุปกรณ์รองรับการทําความร้อน
cool
อุปกรณ์รองรับการทําความเย็น
on
คืนค่าโหมดก่อนหน้าของอุปกรณ์
heatcool
คงเป้าหมายการทําความร้อน/ทําความเย็นเป็นช่วง
auto
โหมดอัตโนมัติที่มีอุณหภูมิที่ตั้งไว้ตามตารางเวลาหรือพฤติกรรมที่เรียนรู้
fan-only
พัดลมทํางานโดยไม่มีความร้อน/ทําความเย็น
purifier
โหมดฟอกอากาศ
eco
โหมดประหยัดพลังงาน
dry
โหมดแห้ง
thermostatTemperatureAmbient Number

ต้องระบุ

อุณหภูมิที่สังเกตการณ์ปัจจุบันในหน่วย องศาเซลเซียส

thermostatTemperatureSetpoint Number

ต้องระบุ

อุณหภูมิปัจจุบันที่ตั้งค่าเป็นจุด (เป้าหมายเดียว) องศาเซลเซียส

1 วัตถุ

สถานะสําหรับช่วงคะแนนที่ตั้งไว้

thermostatMode สตริง

ต้องระบุ

โหมดปัจจุบันของอุปกรณ์จากรายการ availableThermostatModes

ค่าที่รองรับมีดังต่อไปนี้

none
ไม่มีโหมดแอ็กทีฟ
off
ปิดใช้การทําความร้อน/ทําความเย็น
heat
อุปกรณ์รองรับการทําความร้อน
cool
อุปกรณ์รองรับการทําความเย็น
on
คืนค่าโหมดก่อนหน้าของอุปกรณ์
heatcool
คงเป้าหมายการทําความร้อน/ทําความเย็นเป็นช่วง
auto
โหมดอัตโนมัติที่มีอุณหภูมิที่ตั้งไว้ตามตารางเวลาหรือพฤติกรรมที่เรียนรู้
fan-only
พัดลมทํางานโดยไม่มีความร้อน/ทําความเย็น
purifier
โหมดฟอกอากาศ
eco
โหมดประหยัดพลังงาน
dry
โหมดแห้ง
thermostatTemperatureAmbient Number

ต้องระบุ

อุณหภูมิที่สังเกตการณ์ปัจจุบันในหน่วย องศาเซลเซียส

thermostatTemperatureSetpointHigh Number

ต้องระบุ

จุดสูงปัจจุบันหากอยู่ในโหมด heatcool สําหรับช่วง

thermostatTemperatureSetpointLow Number

ต้องระบุ

จุดต่ําปัจจุบันหากอยู่ในโหมด heatcool สําหรับช่วง

ตัวอย่าง

อุณหภูมิของอุปกรณ์ปัจจุบันอยู่ที่เท่าไร

{
  "activeThermostatMode": "cool",
  "thermostatMode": "cool",
  "thermostatTemperatureSetpoint": 23,
  "thermostatTemperatureAmbient": 25.1
}

อุณหภูมิของอุปกรณ์ปัจจุบันอยู่ที่เท่าไร

{
  "activeThermostatMode": "none",
  "thermostatMode": "heatcool",
  "thermostatTemperatureSetpointHigh": 26,
  "thermostatTemperatureSetpointLow": 22,
  "thermostatTemperatureAmbient": 25.1
}

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

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

action.devices.commands.ThermostatTemperatureSetpoint

ตั้งค่าอุณหภูมิเป้าหมายสําหรับอุปกรณ์ตัวควบคุมอุณหภูมิ

พารามิเตอร์

พารามิเตอร์ ประเภท คำอธิบาย
thermostatTemperatureSetpoint Number

ต้องระบุ

อุณหภูมิที่กําหนดเป็นเป้าหมาย รองรับทศนิยมสูงสุด 1 ตําแหน่ง

ตัวอย่าง

ตั้งอุณหภูมิของอุปกรณ์เป็น 22 องศา

{
  "command": "action.devices.commands.ThermostatTemperatureSetpoint",
  "params": {
    "thermostatTemperatureSetpoint": 22
  }
}

เกิดข้อผิดพลาดขณะตั้งอุณหภูมิเป้าหมาย

ค่าที่รองรับมีดังต่อไปนี้

alreadyAtMax
alreadyAtMin
targetAlreadyReached
valueOutOfRange

action.devices.commands.ThermostatTemperatureSetRange

ตั้งค่าช่วงอุณหภูมิเป้าหมายสําหรับอุปกรณ์ตัวควบคุมอุณหภูมิ

คําสั่งนี้ต้องใช้แอตทริบิวต์ต่อไปนี้
{
  "availableThermostatModes": [
    "heatcool"
  ]
}

พารามิเตอร์

พารามิเตอร์ ประเภท คำอธิบาย
thermostatTemperatureSetpointHigh Number

ต้องระบุ

การกําหนดเป้าหมายสูงสําหรับช่วง ต้องรองรับโหมด heatcool

thermostatTemperatureSetpointLow Number

ต้องระบุ

คะแนนเป้าหมายต่ําสําหรับช่วง ต้องรองรับโหมด heatcool

ตัวอย่าง

ตั้งอุณหภูมิไว้ระหว่าง 22 ถึง 26 องศา

{
  "command": "action.devices.commands.ThermostatTemperatureSetRange",
  "params": {
    "thermostatTemperatureSetpointHigh": 26,
    "thermostatTemperatureSetpointLow": 22
  }
}

เกิดข้อผิดพลาดในการตั้งค่าช่วงเป้าหมาย

ค่าที่รองรับมีดังต่อไปนี้

alreadyAtMax
alreadyAtMin
lockedToRange
rangeTooClose
targetAlreadyReached
valueOutOfRange

action.devices.commands.ThermostatSetMode

ตั้งค่าโหมดการทํางานเป้าหมายสําหรับอุปกรณ์ตัวควบคุมอุณหภูมิ

พารามิเตอร์

พารามิเตอร์ ประเภท คำอธิบาย
thermostatMode สตริง

ต้องระบุ

โหมดเป้าหมายจากรายการ availableThermostatModes

ค่าที่รองรับมีดังต่อไปนี้

off
ปิดใช้การทําความร้อน/ทําความเย็น
heat
อุปกรณ์รองรับการทําความร้อน
cool
อุปกรณ์รองรับการทําความเย็น
on
คืนค่าโหมดก่อนหน้าของอุปกรณ์
heatcool
คงเป้าหมายการทําความร้อน/ทําความเย็นเป็นช่วง
auto
โหมดอัตโนมัติที่มีอุณหภูมิที่ตั้งไว้ตามตารางเวลาหรือพฤติกรรมที่เรียนรู้
fan-only
พัดลมทํางานโดยไม่มีความร้อน/ทําความเย็น
purifier
โหมดฟอกอากาศ
eco
โหมดประหยัดพลังงาน
dry
โหมดแห้ง

ตัวอย่าง

ตั้งค่าอุปกรณ์ให้อยู่ในโหมดทําความร้อน • ทําความเย็น

{
  "command": "action.devices.commands.ThermostatSetMode",
  "params": {
    "thermostatMode": "heatcool"
  }
}

เกิดข้อผิดพลาดขณะตั้งค่าโหมดเป้าหมาย

ค่าที่รองรับมีดังต่อไปนี้

inAutoMode
inAwayMode
inDryMode
inEcoMode
inFanOnlyMode
inHeatOrCool
inHumidifierMode
inOffMode
inPurifierMode

action.devices.commands.TemperatureRelative

ปรับอุณหภูมิเป้าหมายที่สัมพันธ์กับสถานะปัจจุบัน

คําสั่งนี้ต้องใช้แอตทริบิวต์ต่อไปนี้
{
  "commandOnlyTemperatureSetting": true
}

พารามิเตอร์

เพย์โหลดมีองค์ประกอบอย่างใดอย่างหนึ่งต่อไปนี้

ปรับตามองศา

พารามิเตอร์ ประเภท คำอธิบาย
thermostatTemperatureRelativeDegree Number

ต้องระบุ

จํานวนองศาที่เปลี่ยนแปลงอุณหภูมิที่แน่นอน (เช่น "ลด 5 องศา")

ปรับตามน้ําหนัก

พารามิเตอร์ ประเภท คำอธิบาย
thermostatTemperatureRelativeWeight จำนวนเต็ม

ต้องระบุ

ข้อมูลนี้บ่งชี้ว่ามีการเปลี่ยนแปลงอุณหภูมิที่ไม่ชัดเจนจากปริมาณเล็กน้อย ("ลดลงเล็กน้อย") เป็นปริมาณมาก ("อุ่นกว่ามาก")

ตัวอย่าง

เพิ่มอุณหภูมิ 5 องศา

{
  "command": "action.devices.commands.TemperatureRelative",
  "params": {
    "thermostatTemperatureRelativeDegree": 5
  }
}

ลดอุณหภูมิลงมาก

{
  "command": "action.devices.commands.TemperatureRelative",
  "params": {
    "thermostatTemperatureRelativeWeight": -5
  }
}

เกิดข้อผิดพลาดในการปรับอุณหภูมิ

ค่าที่รองรับมีดังต่อไปนี้

alreadyAtMax
alreadyAtMin
valueOutOfRange

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

de-DE

  • Heizmodus อัมจิน
  • Mach den Heizmodus aus
  • ชัลท์ den Heizmodus vom Thermostat aus
  • Temperatur auf 20 bis 25 Grad einstellen
  • ตัวควบคุมอุณหภูมิ auf 20 bis 25 Grad stellen
  • Thermostat im Schlafzimmer kälter stellen
  • Wohnzimmer auf Kühlen umstellen
  • bitte dreh das Thermostat ein bisschen อัญมณี
  • bitte dreh das Thermostat etwas höher
  • bitte mach es im Wohnzimmer kühler
  • bitte mach es ใน der Küche etwas kälter
  • bitte stell das Thermostat 5 Grad wärmer ein
  • bitte stell das Thermostat auf 21 Grad für Kühlen ein
  • bitte stell das Thermostat auf 30 Grad
  • bitte stell die Temperatur im Schlafzimmer auf 20 Grad
  • Dreh das Thermostat wärmer bitte
  • Dreh die Temperatur im Schlafzimmer etwas Nach Oben
  • dreh die Temperatur um 5 Grad นักวิ่ง
  • Ereröhe bitte die Temperatur im Bad
  • Ereröhe die Temperaturum 2 คะแนน
  • mach es im Wohnzimmer 2 Grad wärmer
  • senke die Temperatur im Wohnzimmer um 5 Grad
  • stell bitte das Thermostat auf Kühlen
  • stell das Thermostat 5 Grad kälter ein
  • stell die Kühlung auf 20 Grad ein

en-US

  • ปิด โหมดทําความร้อน
  • เปลี่ยน ตัวควบคุมอุณหภูมิ ทําความร้อน • ระหว่าง 70 ถึง 80
  • เปลี่ยนเป็นโหมด สิ่งแวดล้อม โหมด
  • ทําความเย็นใน ห้องนั่งเล่น
  • ทําความเย็น บ้าน เล็กน้อย
  • เพิ่มอุณหภูมิใน ตัวควบคุมอุณหภูมิ
  • ตัวควบคุมอุณหภูมิ ความร้อน เวลา 78
  • ทําให้ 2 องศา ร้อนขึ้น
  • ทําให้เย็นลงโดย 2 องศา
  • ทําให้ ตัวควบคุมอุณหภูมิ ร้อนขึ้น เล็กน้อย
  • เปิดโหมด ทําความเย็น โหมด
  • ใส่ ตัวควบคุมอุณหภูมิ เปิดอยู่ ทําความเย็น
  • เพิ่มอุณหภูมิ ชั้นล่าง ตาม 2 องศา
  • เพิ่มอุณหภูมิใน ตัวควบคุมอุณหภูมิ ตาม 5 องศา
  • ตั้งค่า 70 องศา ใน ตัวควบคุมอุณหภูมิ
  • ตั้งค่า โหมดทําความร้อน • เป็นโหมด ระหว่าง 62 ถึง 79 องศา
  • ตั้งอุณหภูมิของฉัน 80 องศา
  • ตั้งค่า ทําความร้อน เป็น 72
  • ตั้งอุณหภูมิเป็น ทําความเย็น ที่ 70
  • ตั้งค่า ตัวควบคุมอุณหภูมิ ที่ 70 ในโหมด ทําความเย็น โหมด
  • ปิด 5 องศา เปิด ตัวควบคุมอุณหภูมิ
  • ปิด ห้องนั่งเล่น อุณหภูมิ 2 องศา
  • ปิด ตัวควบคุมอุณหภูมิ โหมดทําความร้อน
  • เลี้ยว ตัวควบคุมอุณหภูมิ เล็กน้อย ต่ํากว่า
  • เลี้ยว ตัวควบคุมอุณหภูมิ ด้านล่าง
  • อุ่นเครื่อง ห้องนั่งเล่น
  • บรรยากาศอบอุ่น ห้องนั่งเล่น เล็กน้อย

es-ES

  • 25 Graos de frío en la cocina
  • Ajustar el termostato เทรด 21 y 26 Gross
  • Ajustar la temperatura 21 ปี 27 ปี 27
  • Activar El และ Modo Calefacción
  • apagar el aire acondicionado del termostato
  • aumenta 10 Grosos la temperatura del horno
  • aumenta la temperatura de la cocina
  • baja algo la calefacción
  • baja la temperatura 5 grados
  • baja la temperatura del termostato
  • configurar el modo calefacción
  • disminuye la temperatura de la cocina un poco
  • Hace Demasiado Calor Aquí
  • ฉัน ajustas a 25 grados el modo แคลอรี่
  • ฉัน gustaría ajustar el termostato del salón a 25 Grosos con la calefacción
  • pon a 20 Gross la temperatura
  • pon en modo calefacción el termostato de la cocina
  • pon la temperatura de la cocina a 20 Grosos
  • puedes subir un poco la temperatura en el salón
  • Quero bajar el Nest 5 Groso
  • Quero el modo aire acondicionado a 25 Grosos
  • Qutar el modo frío del baño
  • Sube 5 grados en la cocina
  • Sube la calefacción
  • Súbeme el termostato del salón un poquito
  • Súbeme más la temperatura 10 Grosos

fr-FR

  • โหมด Allumer le chaud .
  • Mets en Mode chaud
  • Mets la température entre 21 et 23 degrés
  • Mets la température à 17 degrés
  • Mets le Mode froid du thermostat à 19 องศา .
  • โหมด Mettre le froid à 19 degrés .
  • Mettre le Thermostat entre 70 et 80 degrés .
  • โหมด Régler le chaud du ตัวควบคุมอุณหภูมิ à 22 องศา .
  • โหมด Régler le chaud à 22 degrés .
  • Augmente la température de ดีเจ 2 แห่ง
  • Augmente un peu la température dans la chambre
  • baisse la température de la chambre
  • basse le Thermostat
  • baisse un peu la température dans อาหารลา
  • baisse un peu ตัวควบคุมอุณหภูมิ
  • baisser ตัวควบคุมอุณหภูมิ lele de 5 องศา
  • โหมดสัตว์เลี้ยง chaud
  • desends la température de 3 องศา
  • désactiver le Mode frais du ตัวควบคุมอุณหภูมิ
  • ต้องเป็นไปตาม le Thermostat en Mode frais
  • ตรงตามมาตรฐาน ตัวควบคุมอุณหภูมิ à 10 องศา
  • Meettre degrés 2 แห่ง de moins dans อาหารลา
  • Mont la température de la chambre
  • monte la température de la salle de bain de 3 ปริญญา
  • Monte LE Thermostat
  • monte ตัวควบคุมอุณหภูมิ de ปริญญา 2 ข้อ
  • monte un peu ตัวควบคุมอุณหภูมิ lele
  • Éteins le Mode chaud du ตัวควบคุมอุณหภูมิ

อุปกรณ์ ERRORS

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