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

ความตั้งใจ

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

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

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

ความตั้งใจ smart home ที่รองรับมีดังนี้

ซิงค์

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

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

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

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

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

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

QUERY

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

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

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

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

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

ปฏิบัติ

Intent ของ action.devices.EXECUTE ใช้เพื่อให้คําสั่งทํางานในอุปกรณ์ smart home เครื่อง

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

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

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

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