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

สคีมาของ Smart Home RunCycle

action.devices.traits.RunCycle - ลักษณะเฉพาะนี้หมายถึงอุปกรณ์ที่มีระยะเวลาดําเนินการอยู่ซึ่งค้นหาได้

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

  • เครื่องอบผ้าของฉันมีรอบไหน
  • เครื่องล้างจานเหลือกี่รอบ
  • เครื่องอบผ้าทําหน้าที่อะไร
  • จะล้างรถเมื่อใด

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

อุปกรณ์ต่างๆ สามารถส่งคืนสิ่งที่คุณรู้ และการตอบสนองของ Assistant TTS จะสร้างคําตอบที่ดีที่สุดด้วยข้อมูลที่มีอยู่ (เช่น เครื่องล้างจานกําลังทํางานและจะเสร็จในประมาณ 20 นาที)

ปัจจุบัน RunCycle เป็นแบบอ่านอย่างเดียว ยังไม่มีคําสั่ง มีเฉพาะสถานะที่จะค้นหา ในอนาคตอาจมีกลไกสําหรับการเรียกใช้รอบใหม่หรือการข้ามวงจร (เหมาะสําหรับเครื่องรดน้ําต้นไม้ ที่ไม่ดีสําหรับเครื่องซักผ้า)

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

ไม่มี

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

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

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

ต้องระบุ

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

[item, ...] วัตถุ

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

currentCycle สตริง

ต้องระบุ

รอบปัจจุบันแสดงอยู่

nextCycle สตริง

ไม่บังคับ วงจรถัดไป

lang สตริง

ต้องระบุ

รหัสภาษาสําหรับชื่อวงจรที่ระบุ ดูภาษาที่รองรับ

currentTotalRemainingTime จำนวนเต็ม

ต้องระบุ

เวลาที่เหลือในการดําเนินการ หน่วยเป็นวินาที

currentCycleRemainingTime จำนวนเต็ม

ต้องระบุ

เวลาที่เหลือในรอบปัจจุบัน หน่วยเป็นวินาที

ตัวอย่าง

อุปกรณ์จะถูกล้างน้ําอีก 5 นาที และจะดําเนินการใน 20 นาที

{
  "currentRunCycle": [
    {
      "currentCycle": "rinse",
      "lang": "en"
    }
  ],
  "currentTotalRemainingTime": 1200,
  "currentCycleRemainingTime": 300
}

อุปกรณ์จะถูกล้างน้ําออกอีก 5 นาทีก่อนนําไปหมุน

{
  "currentRunCycle": [
    {
      "currentCycle": "rinse",
      "nextCycle": "spin",
      "lang": "en"
    }
  ],
  "currentTotalRemainingTime": 600,
  "currentCycleRemainingTime": 300
}

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

ไม่มี

การแจ้งเตือนของอุปกรณ์

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

ช่อง ประเภท คำอธิบาย
RunCycle

ต้องระบุ

เพย์โหลดการแจ้งเตือน

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

สำเร็จ

priority จำนวนเต็ม

ต้องระบุ

แสดงถึงระดับการแจ้งเตือน ค่าที่รองรับปัจจุบันคือ 0 ซึ่งบ่งชี้ว่าควรพูดการแจ้งเตือนดังกล่าว

status สตริง

ต้องระบุ

ผลการดําเนินการ

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

SUCCESS
currentCycleRemainingTime จำนวนเต็ม

ต้องระบุ

เวลาที่เหลือในรอบปัจจุบัน หน่วยเป็นวินาที

1 วัตถุ

ล้มเหลว

priority จำนวนเต็ม

ต้องระบุ

แสดงถึงระดับการแจ้งเตือน ค่าที่รองรับปัจจุบันคือ 0 ซึ่งบ่งชี้ว่าควรพูดการแจ้งเตือนดังกล่าว

status สตริง

ต้องระบุ

ผลการดําเนินการ

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

FAILURE
errorCode สตริง

ต้องระบุ

ค่านี้อาจเป็นรหัสข้อผิดพลาดสําหรับลักษณะนี้ เช่น deviceStuck

ตัวอย่าง

อุปกรณ์ทํางานเสร็จแล้ว

{
  "RunCycle": {
    "priority": 0,
    "status": "SUCCESS",
    "currentCycleRemainingTime": 0
  }
}

เกิดข้อผิดพลาดเกี่ยวกับรอบปัจจุบัน

{
  "RunCycle": {
    "priority": 0,
    "status": "FAILURE",
    "errorCode": "deviceStuck"
  }
}

อุปกรณ์ ERRORS

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