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

สคีมา Smart Start Start Trait

action.devices.traits.StartStop - ลักษณะเฉพาะนี้เป็นของอุปกรณ์ที่รองรับการทํางานและเริ่มหยุด

การเริ่มต้นและการหยุดอุปกรณ์จะมีฟังก์ชันการทํางานคล้ายกับการเปิดและปิดอุปกรณ์ เช่น เครื่องซักผ้าบางโปรแกรม จะเปิดและแก้ไขการตั้งค่าได้ก่อนเริ่มทํางานจริง

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

อุปกรณ์บางอย่างอาจรองรับการทํางานในบางโซน เช่น สปริงเกอร์อาจมีโซนรดน้ําหลายจุด และรองรับความสามารถในการสเปรย์น้ําเฉพาะโซน ในขณะที่เครื่องดูดฝุ่นอาจรองรับการทําความสะอาดห้องใดห้องหนึ่ง

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

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

แอตทริบิวต์ ประเภท คำอธิบาย
pausable บูลีน

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

ระบุว่าจะหยุดชั่วคราวอุปกรณ์ระหว่างการดําเนินการหรือไม่

availableZones อาร์เรย์

ระบุชื่อโซนที่รองรับ สตริงต้องแปลตามที่ผู้ใช้กําหนด รายการนี้ไม่ใช่รายการพิเศษ ผู้ใช้สามารถรายงานชื่อที่ต้องการได้

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

ชื่อโซนที่รองรับอุปกรณ์เริ่มต้น

ตัวอย่าง

อุปกรณ์ที่หยุดชั่วคราวหรือรองรับการทํางานได้ในหลายโซน

{
  "pausable": true,
  "availableZones": [
    "kitchen",
    "living room",
    "office",
    "bedroom"
  ]
}

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

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

รัฐ ประเภท คำอธิบาย
isRunning บูลีน

ต้องระบุ

ระบุว่าอุปกรณ์กําลังทํางานอยู่หรือไม่

isPaused บูลีน

ระบุว่าอุปกรณ์หยุดชั่วคราวอย่างชัดแจ้งหรือไม่ หากค่าเป็น "จริง" หมายความว่า isRunning เป็นเท็จ แต่เข้าใช้งานต่อได้

activeZones อาร์เรย์

ระบุโซนที่อุปกรณ์ทํางานอยู่จากรายการ availableZones

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

ชื่อโซน

ตัวอย่าง

อุปกรณ์หยุดชั่วคราวไหม

{
  "isRunning": false,
  "isPaused": true
}

อุปกรณ์หยุดชั่วคราวไหม

{
  "isRunning": true,
  "isPaused": false
}

อุปกรณ์ทํางานอยู่ไหม

{
  "isRunning": true,
  "isPaused": false,
  "activeZones": [
    "kitchen",
    "living room"
  ]
}

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

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

action.devices.commands.StartStop

เริ่มหรือหยุดอุปกรณ์

พารามิเตอร์

พารามิเตอร์ ประเภท คำอธิบาย
start บูลีน

ต้องระบุ

True เพื่อเริ่มการทํางานของอุปกรณ์, False เพื่อหยุด

zone สตริง

ระบุโซนที่จะเริ่มต้นทํางาน

multipleZones อาร์เรย์

ระบุโซนอย่างน้อย 2 โซนที่จะเริ่มทํางาน จะตั้งค่าแทน zone parameter.

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

ชื่อโซนสําหรับเริ่มต้นอุปกรณ์

ตัวอย่าง

เริ่มต้นอุปกรณ์

{
  "command": "action.devices.commands.StartStop",
  "params": {
    "start": true
  }
}

หยุดอุปกรณ์

{
  "command": "action.devices.commands.StartStop",
  "params": {
    "start": false
  }
}

เริ่มต้นอุปกรณ์ในสํานักงาน

{
  "command": "action.devices.commands.StartStop",
  "params": {
    "start": true,
    "zone": "office"
  }
}

เปิดอุปกรณ์ในห้องครัว ห้องรับประทานอาหาร และห้องนั่งเล่น

{
  "command": "action.devices.commands.StartStop",
  "params": {
    "start": true,
    "multipleZones": [
      "kitchen",
      "dining room",
      "living room"
    ]
  }
}

action.devices.commands.PauseUnpause

หยุดชั่วคราวหรือยกเลิกการหยุดการทํางานของอุปกรณ์

คําสั่งนี้จําเป็นต้องมีแอตทริบิวต์ต่อไปนี้
{
  "pausable": true
}

พารามิเตอร์

พารามิเตอร์ ประเภท คำอธิบาย
pause บูลีน

ต้องระบุ

True เพื่อหยุดชั่วคราว มีค่าเท็จเป็นเลิกหยุดชั่วคราว

ตัวอย่าง

หยุดอุปกรณ์ชั่วคราว

{
  "command": "action.devices.commands.PauseUnpause",
  "params": {
    "pause": true
  }
}

ผู้ใช้พยายามหยุดอุปกรณ์ชั่วคราว แต่อุปกรณ์อยู่ในสถานะบางอย่างที่ไม่สามารถหยุดไว้ชั่วคราวได้

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

unpausableState

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

de-DE

  • Bitte Starte den Staubsauger im Wohnzimmer
  • Geschirrspüler มันฝรั่ง Wiser Anstellen
  • Staubsauger บทคัดย่อ
  • Staubsauger pausieren
  • Bitte Starte die Waschmaschine

en-US

  • ฉันต้องการ ห้องของฉัน เพื่อเริ่มทํางานใน ห้องทํางาน
  • หยุดชั่วคราว เครื่องอบผ้า เดี๋ยวนี้
  • เริ่มต้น เครื่องอบผ้า เดี๋ยวนี้
  • หยุด เครื่องล้างจาน
  • ยกเลิกการหยุดชั่วคราว เครื่องล้างจาน

es-ES

  • Parar la lavadora
  • pon el aspirador en el dormitorio Principal
  • pon el lavavajillas en pausa
  • Quero Usar El Friegaplatos
  • เติมพลังให้ตัวคนเดียว la aspiradora

fr-FR

  • Allumer l'aspirateur dans le salon
  • ดําเนินการต่อ l'aspirateur
  • arrête l'aspirateur
  • แลนซ์ la machine à laver
  • ตรงตามความต้องการ l'aspirateur enหยุดชั่วคราว

อุปกรณ์ ERRORS

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