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

ความตั้งใจ

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

Intent ของบ้านอัจฉริยะเป็นออบเจ็กต์การรับส่งข้อความแบบง่ายที่อธิบายว่าการดําเนินการสมาร์ทโฮมควรทําอย่างไร เช่น เปิดไฟหรือแคสต์เสียงไปยังลําโพง

Intent ของบ้านอัจฉริยะทั้งหมดจะอยู่ในเนมสเปซ action.devices และคุณต้องดําเนินการตามคําสั่งซื้อ เมื่อใดก็ตามที่ Google Assistant ส่งความตั้งใจที่จะดําเนินการตามคําสั่งซื้อ ระบบจะส่งโทเค็นการเข้าถึง OAuth 2 ของบุคคลที่สามในส่วนหัวการให้สิทธิ์

Intent ของบ้านอัจฉริยะที่รองรับมีดังนี้

ซิงค์

Intent ของ action.devices.SYNC จะใช้เพื่อขอรายการอุปกรณ์ในบ้านอัจฉริยะที่ผู้ใช้เชื่อมต่อและพร้อมใช้งาน

เมื่อผู้ใช้ตั้งค่าอุปกรณ์ด้วยแอป Google Home ระบบจะตรวจสอบสิทธิ์กับโครงสร้างพื้นฐานของระบบคลาวด์ด้วย จากนั้น Assistant จะได้รับโทเค็น OAuth2 ในขั้นตอนนี้ Google Assistant จะส่ง Intent ของ action.devices.SYNC ไปยังคําสั่งซื้อเพื่อเรียกรายการอุปกรณ์และความสามารถของผู้ใช้จากโครงสร้างพื้นฐานของระบบคลาวด์

รูปนี้แสดงการโต้ตอบระหว่างโครงสร้างพื้นฐานของ Google และโครงสร้างพื้นฐานของพาร์ทเนอร์ จากโครงสร้างพื้นฐานของ Google จะมีรายชื่อพาร์ทเนอร์ที่พร้อมใช้งานกับแอปไคลเอ็นต์ Assistant แล้วดําเนินการในโครงสร้างพื้นฐานของพาร์ทเนอร์เพื่อดําเนินการตรวจสอบสิทธิ์ OAuth ให้เสร็จสมบูรณ์ การตรวจสอบสิทธิ์ OAuth ทางฝั่งพาร์ทเนอร์คือ WebView การตั้งค่าพาร์ทเนอร์, OAuth WebView, การตั้งค่าและข้อกําหนดที่ไม่บังคับ และบริการระบบคลาวด์ของพาร์ทเนอร์ โครงสร้างพื้นฐานของพาร์ทเนอร์ แล้วจะส่งข้อมูลเข้าสู่ระบบ OAuth ไปยังแอปไคลเอ็นต์ Assistant บริการระบบคลาวด์ของพาร์ทเนอร์จะส่งอุปกรณ์และความสามารถที่มีอยู่ไปยังบริการ Assistant ซึ่งจะจัดเก็บข้อมูลไว้ในกราฟหน้าแรก
รูปที่ 1: การโต้ตอบระหว่าง Google และโครงสร้างพื้นฐานของพาร์ทเนอร์

เพื่อหลีกเลี่ยงการยกเลิกการลิงก์และการลิงก์บัญชีของผู้ใช้ใหม่ คุณซิงค์คําขอไปยัง Google Assistant ได้ การดําเนินการนี้จะส่ง Intent ของ action.devices.SYNC ไปยังคําสั่งซื้อ เพื่อซิงค์รายการอุปกรณ์และความสามารถ ดูข้อมูลเพิ่มเติมที่ใช้การซิงค์คําขอ

แผนภาพโฟลว์ของ Intent ของ SYNC
รูปที่ 2: ความตั้งใจของ SYNC

ในระหว่างการตั้งค่าการจําหน่ายในพื้นที่ แพลตฟอร์ม Home Home จะตรวจสอบการตอบกลับ SYNC จากการดําเนินการตามการดําเนินการของระบบคลาวด์ของการดําเนินการสมาร์ทโฮม หากต้องการดูข้อมูลเพิ่มเติมเกี่ยวกับวิธีแก้ไขคําตอบด้วย SYNC เพื่อรองรับการดําเนินการตามคําสั่งซื้อในพื้นที่ โปรดดูการอัปเดต SYNC ใน Cloud Fulfillment

QUERY

Intent ของ action.devices.QUERY มีไว้เพื่อค้นหาสถานะปัจจุบันของอุปกรณ์ในบ้านอัจฉริยะ

เมื่อผู้ใช้กําลังค้นหาสถานะอุปกรณ์ หากต้องการตอบคําถามอย่างเช่น Ok Google ไฟดวงไหนที่เปิดในห้องครัว Google Assistant จะส่งความตั้งใจ action.devices.QUERY ไปยังการดําเนินการตามคําสั่งซื้อ

แผนภาพโฟลว์ของ Intent ของ QUERY
รูปที่ 3: ความตั้งใจของ QUERY

เพื่อให้ผู้ใช้ได้รับประสบการณ์ที่ดีที่สุด คุณควรใช้สถานะรายงานเพื่อรายงานสถานะปัจจุบันของอุปกรณ์ของผู้ใช้ไปยัง Home Graph โดยตรง ตัวอย่างเช่น บอกให้ Google Assistant รู้ว่าผู้ใช้เปิดหลอดไฟอัจฉริยะกับสวิตช์ไฟจริงไหม

การรายงานสถานะอุปกรณ์โดยใช้สถานะรายงาน
รูปที่ 4: รายงานสถานะอุปกรณ์

ออกแรง

Intent ของ action.devices.EXECUTE ใช้เพื่อใช้คําสั่ง เพื่อเรียกใช้ในอุปกรณ์ในบ้านอัจฉริยะ

เมื่อผู้ใช้ส่งคําสั่งไปยังอุปกรณ์ที่มี Google Assistant การดําเนินการตามคําสั่งซื้อจะบรรลุaction.devices.EXECUTEตามเจตนาของคุณ ซึ่งจะอธิบายการดําเนินการและอุปกรณ์ที่จะดําเนินการได้ ผู้ใช้ดําเนินการในอุปกรณ์ที่มีคําสั่งได้ เช่น Ok Google เปิดไฟห้องนั่งเล่น

แผนภาพโฟลว์ของ Intent ของ EXECUTE
รูปที่ 5: ความตั้งใจดําเนินการ

ยกเลิกการเชื่อมต่อ

Intent ของ action.devices.DISCONNECT จะทริกเกอร์เพื่อให้คุณทราบเมื่อผู้ใช้ยกเลิกการลิงก์บัญชีแอปจาก Google Assistant หลังจากรับ Intent ของ action.devices.DISCONNECT แล้ว คุณไม่ควรรายงานสถานะของอุปกรณ์ของผู้ใช้รายนี้