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

สคีมาของจุดเริ่มต้นในบ้านอัจฉริยะ

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

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

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

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

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

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

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

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

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

availableZones อาร์เรย์

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

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

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

ตัวอย่าง

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

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

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

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

รัฐ ประเภท คำอธิบาย
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 ได้ที่การดําเนินการตามความตั้งใจ

action.devices.commands.StartStop

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

พารามิเตอร์

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

ต้องระบุ

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

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 บูลีน

ต้องระบุ

จริงสําหรับหยุดชั่วคราว, เท็จ, เลิกหยุดชั่วคราว

ตัวอย่าง

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

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

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

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

unpausableState

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

de-DE

  • Bitte starte den Staubsauger im Wohnzimmer .
  • Geschirrspüler wieder anstellen
  • Staubsauger abschalten
  • Staubsauger pausieren
  • bitte starte die Waschmaschine

en-US

  • I need my roomba to start running in the den
  • pause the dryer now
  • start the dryer now
  • stop the dishwasher
  • unpause the dishwasher

es-ES

  • parar la lavadora
  • pon el aspirador en el dormitorio principal
  • pon el lavavajillas en pausa
  • quiero usar el friegaplatos
  • vuelve a encender la aspiradora

fr-FR

  • Allumer l'aspirateur dans le salon .
  • Continuer l'aspirateur .
  • arrête l'aspirateur
  • lance la machine à laver
  • mets l'aspirateur en pause

hi-IN

  • कमरे में वैक्यूम चलाओगी
  • डिशवॉशर को कुछ देर रोको
  • वैक्यूम को अनपॉज़ करो
  • वैक्यूम को चालू कर दो
  • वैक्यूम को बंद कर दो

it-IT

  • Mi accendi l'aspirapolvere in cucina ?
  • fa' partire aspirapolvere
  • fai ripartire l'aspirapolvere
  • metti in pausa l'aspirapolvere
  • stoppa l'aspirapolvere

ja-JP

  • お掃除ロボット リビング で動かして
  • 台所の食洗機 を一時停止してください
  • 掃除機 を停止して
  • 掃除機 を再開してください
  • 洗濯機 をスタートさせて

ko-KR

  • 거실 에서 청소기 돌려
  • 세탁기 좀 돌려 줘
  • 식기 세척기 다시 시작해
  • 청소기 일시 정지
  • 청소기 작동 멈춰 줘

nl-NL

  • De schoonmaakrobot inschakelen in de keuken .
  • hervat de stofzuiger
  • pauzeer de stofzuiger
  • start mijn stofzuiger
  • stop de stofzuiger

pt-BR

  • Inicia o aspersor no jardim
  • Iniciar o aspirador de pó na sala .
  • iniciar a máquina de lavar
  • parar a pausa na máquina de lavar roupa
  • parar o aspirador de pó
  • pausar o aspirador de pó

sv-SE

  • Kör igång sprinklern gräsmattan .
  • kör igång dammsugaren igen
  • pausa dammsugaren
  • starta tvättmaskinen
  • stoppa dammsugaren

อุปกรณ์ ERRORS

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