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

สคีมาของ Smart TemperatureControl Trait

action.devices.traits.TemperatureControl - ลักษณะสําหรับอุปกรณ์ (นอกเหนือจากตัวควบคุมอุณหภูมิ) ที่รองรับการควบคุมอุณหภูมิภายในหรือรอบๆ อุปกรณ์

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

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

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

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

ต้องระบุ

ช่วงอุณหภูมิที่รองรับของอุปกรณ์

minThresholdCelsius Number

ต้องระบุ

อุณหภูมิต่ําสุดสําหรับช่วง เป็น องศาเซลเซียส

maxThresholdCelsius Number

ต้องระบุ

อุณหภูมิสูงสุดสําหรับช่วง เป็น องศาเซลเซียส

temperatureStepCelsius Number

ระบุขั้นตอนของอุณหภูมิที่สัมพันธ์กัน นี่คือระยะเวลาการปรับค่าใช้จ่ายขั้นต่ําที่อุปกรณ์รองรับ หากไม่ระบุ ระบบจะคํานวณขั้นตอนที่เกี่ยวข้องเป็นเปอร์เซ็นต์ของ temperatureRange

temperatureUnitForUX สตริง

ต้องระบุ

หน่วยอุณหภูมิที่ใช้ในการตอบกลับผู้ใช้

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

C
F
commandOnlyTemperatureControl บูลีน

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

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

queryOnlyTemperatureControl บูลีน

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

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

ตัวอย่าง

อุปกรณ์รองรับการควบคุมระหว่าง 150 ถึง 500 องศาฟาเรนไฮต์ เพิ่มขึ้น 5 องศา

{
  "temperatureRange": {
    "minThresholdCelsius": 65.5,
    "maxThresholdCelsius": 260
  },
  "temperatureStepCelsius": 2.778,
  "temperatureUnitForUX": "F"
}

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

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

รัฐ ประเภท คำอธิบาย
temperatureSetpointCelsius Number

อุณหภูมิที่กําหนดในปัจจุบัน โดยมีหน่วยเป็น องศาเซลเซียส ต้องอยู่ใน temperatureRange ต้องระบุหากตั้งค่า queryOnlyTemperatureControl เป็น false

temperatureAmbientCelsius Number

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

ตัวอย่าง

อุปกรณ์มีการตั้งค่าอุณหภูมิเท่าใด

{
  "temperatureSetpointCelsius": 150
}

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

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

action.devices.commands.SetTemperature

ตั้งค่าอุณหภูมิเป็นค่าที่ต้องการ

พารามิเตอร์

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

ต้องระบุ

อุณหภูมิเพื่อตั้งค่าเป็น องศาเซลเซียส ต้องอยู่ใน temperatureRange

ตัวอย่าง

ตั้งค่าอุปกรณ์เป็น 350 องศาเซลเซียส

{
  "command": "action.devices.commands.SetTemperature",
  "params": {
    "temperature": 176.67
  }
}

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

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

alreadyAtMax
alreadyAtMin
valueOutOfRange

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

de-DE

  • Erhöhe die Temperatur des Ofens
  • Stelle die Temperatur des Ofens auf 425 Grad

en-US

  • I want the temperature of the oven higher
  • set the oven to 400

es-ES

  • pon la temperatura del horno a 180 grados
  • sube la temperatura del horno

fr-FR

  • Mets la température du four à 180 degrés .
  • augmente la température du four

hi-IN

  • ओवन का तापमान 425 डिग्री पर करें

it-IT

  • Alza la temperatura del forno
  • metti il forno a 200 gradi

ja-JP

  • オーブン の温度を 425度 に設定して
  • オーブン の温度を上げて

ko-KR

  • 오븐 온도 180 도로 맞춰
  • 오븐 온도 좀 높여 줄래

nl-NL

  • stel de oven in op 220 graden
  • verhoog de temperatuur van de oven

pt-BR

  • ajuste a temperatura do forno para 180 graus
  • aumenta a temperatura do forno
  • aumentar a temperatura do forno
  • define a temperatura do termostato nos 22 graus

sv-SE

  • höj temperaturen i ugnen
  • sätt ugnen 100 grader

อุปกรณ์ ERRORS

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