ความตั้งใจ

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

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

ต่อไปนี้คือ Intent smart home ที่รองรับ

ซิงค์

ระบบใช้ Intent action.devices.SYNC เพื่อขอรายการ อุปกรณ์ smart home เครื่องที่ผู้ใช้ได้เชื่อมต่อและ พร้อมให้ใช้งาน

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

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

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

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

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

QUERY

ระบบใช้ Intent action.devices.QUERY เพื่อค้นหาสถานะปัจจุบัน จากอุปกรณ์ smart home เครื่อง

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

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

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

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

ดำเนินการ

มีการใช้ Intent action.devices.EXECUTE เพื่อระบุคำสั่ง เพื่อดำเนินการในอุปกรณ์ smart home เครื่อง

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

วันที่ แผนผังโฟลว์ของความตั้งใจ EXECUTE
รูปที่ 5: ความตั้งใจ EXECUTE

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

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

ก่อนหน้า
ประเภทและลักษณะเฉพาะของอุปกรณ์
ถัดไป
การดำเนินการตามคำสั่งซื้อ