ทั่วไป
ถาม: เราควรใช้โครงสร้างพื้นฐานการจัดการคำสั่งซื้อแบบคลาวด์ต่อคลาวด์ที่ใดและในภาษาใด
ตอบ: ตราบใดที่รองรับ SSL (TLS) และ OAuth 2.0 เวอร์ชันล่าสุด คุณก็สามารถ ใช้โครงสร้างพื้นฐานบนแพลตฟอร์มและภาษาใดก็ได้ที่คุณเลือก เราขอแนะนำให้คุณติดตั้งใช้งานใกล้กับส่วนที่เหลือของโครงสร้างพื้นฐานให้มากที่สุด เพื่อปรับปรุงความน่าเชื่อถือและลดเวลาในการตอบสนองสำหรับการดำเนินการใน อุปกรณ์ของผู้ใช้จริง
ถาม: รหัสอุปกรณ์ต้องไม่ซ้ำกันไหม
ตอบ: รหัสต้องไม่ซ้ำกัน หากไม่มีรหัสที่ไม่ซ้ำกันในบริการของคุณ รหัสเหล่านั้นต้องไม่ซ้ำกันอย่างน้อยในระดับผู้ใช้ ลองนึกถึงผู้ใช้ที่มีบ้านหลายหลัง ซึ่งทั้ง 2 หลังมีการผสานรวมกับผู้ใช้รายเดียวกัน การขอให้ เปิดไฟในบ้านหลังหนึ่งไม่ควรทำให้ไฟที่มีรหัสเดียวกันใน บ้านอีกหลังเปิด
คำถาม: ชื่ออุปกรณ์ต้องไม่ซ้ำกันไหม
ตอบ: ชื่อไม่จำเป็นต้องไม่ซ้ำกัน แต่เมื่อเวลาผ่านไป เราอาจแนะนำให้ ผู้ใช้ปรับปรุงการตั้งชื่อที่ไม่ดีหลังจากการตั้งค่าเพื่อประสบการณ์ของผู้ใช้ที่ดีขึ้น
ต่อไปนี้คือคำแนะนำในการตั้งชื่ออย่างรวดเร็ว
- ชื่อควรเป็นสิ่งที่ผู้คนพูดได้จริง
- เรารู้จักสตริงย่อย ดังนั้นหากคุณมี "ไฟสีของ Acme" เราจะตอบคำถาม "ไฟของ Acme" ด้วย
- เราขอแนะนำให้ใช้ทั้งชื่อที่สื่อความหมายสำหรับผลิตภัณฑ์และชื่อที่ผู้ใช้กำหนดอย่างน้อย 1 ชื่อ
- ผู้ใช้ไม่จำเป็นต้องตั้งชื่อห้องให้หลอดไฟ เนื่องจากเรามีห้องสำหรับหลอดไฟอยู่แล้ว หลอดไฟควรมีชื่อที่ไม่ซ้ำกันในแต่ละห้อง แต่ผู้ใช้สามารถใช้คำที่เป็นพหูพจน์เพื่อสั่งการทุกอย่างได้เสมอ (เช่น หลอดไฟ 2 หลอดในโคมไฟติดผนังของออฟฟิศมีชื่อว่า "ไฟเหนือ" และ "ไฟตะวันออก" แต่สามารถสั่งการเป็น "ไฟ" ได้)
คำถาม: สถานะอุปกรณ์มีการอัปเดตบ่อยเพียงใด
ตอบ: ระบบจะเรียกสถานะชั่วคราวเมื่อมีการ QUERY หรือ EXECUTE ซึ่งเป็นการดำเนินการที่ผู้ใช้เริ่มต้น หากผู้ใช้ถามว่า "ไฟเปิดอยู่ไหม" หรือต้องการ เพิ่มความสว่างของไฟ เราจะต้องทำการค้นหาเพื่อดูสถานะปัจจุบัน
คำถาม: อัปเดต Home Graph โดยตรงด้วยสถานะปัจจุบันของอุปกรณ์ได้ไหม
ตอบ: ได้ ใช้การเรียก API ของ Report State
การลิงก์บัญชีและ OAuth
คำถาม: เราต้องลิงก์บัญชีไหม
ตอบ: ใช่ คุณต้องลิงก์บัญชีเพื่อเชื่อมต่ออุปกรณ์ของผู้ใช้กับบริการระบบคลาวด์ของผู้ให้บริการ
คำถาม: สำหรับ OAuth เราจะทำให้โทเค็นเพื่อการเข้าถึงหมดอายุทุกๆ 15.213 ชั่วโมง ซึ่งใช้ได้ไหม
ตอบ: ได้ แต่โปรดทดสอบโดยตั้งเวลาหมดอายุที่ค่อนข้างสั้น เช่น 10-20 นาที ไคลเอ็นต์ OAuth ของเราควรรีเฟรชโทเค็นตามที่จำเป็น และการทดสอบที่มี เวลาหมดอายุสั้นๆ จะพิสูจน์ได้ว่าการรีเฟรชโทเค็นทำงานได้
Intent
คำถาม: การซิงค์จะเกิดขึ้นเมื่อใด
ตอบ: การซิงค์จะเกิดขึ้นทันทีหลังจาก OAuth เสร็จสมบูรณ์ และหลังจากที่โทรหา Request Sync
ถาม: ทำไม SYNC จึงใช้งานไม่ได้
ตอบ: สาเหตุที่พบบ่อยที่ทำให้การอัปโหลดล้มเหลวมีดังนี้
คุณส่งประเภทอุปกรณ์ที่ไม่ถูกต้อง
- เช่น เราคาดหวัง
action.devices.types.LIGHTแต่คุณส่งaction.devices.types.Light
- เช่น เราคาดหวัง
คุณกำลังส่งประเภทอุปกรณ์ที่ไม่รองรับ
- เช่น คุณส่ง
action.devices.types.FLASHLIGHTซึ่งเป็นสิ่งที่เราไม่รองรับ
- เช่น คุณส่ง
คุณส่งฟิลด์ที่ไม่ถูกต้อง/ไม่รองรับ
- เช่น คุณมีฟิลด์ที่ไม่อยู่ในข้อกำหนดของเรา
การตอบกลับ SYNC มีปัญหาการจัดรูปแบบอื่นๆ
- ตรวจสอบวงเล็บของคุณ
คุณกำลังพบปัญหาการลิงก์บัญชี
- โปรดยืนยันว่าคุณได้รับโทเค็นเพื่อการเข้าถึงที่ถูกต้องในส่วนหัว Auth ของคำขอ SYNC
คุณใช้เวลาตอบคำขอ SYNC นานเกินไป
- โปรดยืนยันว่าคุณตอบกลับคำขอ SYNC ภายใน 5 วินาที
ถาม: การตอบกลับว่า "รอดำเนินการ" ถือว่าใช้ได้ไหม
ตอบ: เราขอแนะนำให้ตอบกลับว่าสำเร็จ/ไม่สำเร็จ แทนที่จะเป็นรอดำเนินการ หากอุปกรณ์พร้อมใช้งานแบบเรียลไทม์ โปรดติดต่อเราหากคุณรู้สึกว่าต้องการคำตอบที่ "รอดำเนินการ" เนื่องจากเราทราบว่าอุปกรณ์บางอย่างที่ใช้พลังงานต่ำและไม่ใช่แบบเรียลไทม์อาจต้องใช้คำตอบที่รอดำเนินการและรูปแบบการดำเนินการแบบอะซิงโครนัส
การทดสอบและการส่ง
ถาม: เราตั้งค่าสภาพแวดล้อมระบบคลาวด์สำหรับการพัฒนาได้ไหม
ตอบ: ได้ คุณสามารถทดสอบสภาพแวดล้อมและการกำหนดค่าระบบคลาวด์ที่ยังไม่ได้เปิดตัว
คำถาม: Action ของฉันไม่ปรากฏในส่วนการควบคุมอุปกรณ์ในบ้านของแอป Google Home เกิดอะไรขึ้น
ตอบ: ยืนยันว่าคุณเป็นนักพัฒนาแอปสำหรับโปรเจ็กต์นี้
สถานะรายงาน
คำถาม: มีข้อกำหนดเบื้องต้นในการใช้ฟีเจอร์รายงานสถานะไหม
ตอบ: โปรเจ็กต์ต้องใช้ Smart Home API, รองรับ OAuth2 และต้องมี ลักษณะที่มีสถานะที่จะรายงาน
คำถาม: เราต้องรายงานสถานะในอุปกรณ์บ่อยแค่ไหน
ตอบ: Google สนใจสถานะการเปลี่ยนผ่านและสถานะสุดท้าย อย่างไรก็ตาม หากมีการเปลี่ยนแปลงสถานะหลายครั้งในระยะเวลาอันสั้น (เช่น ผู้ใช้ เปิดและปิดตู้เย็น 3 ครั้งใน 1 นาที หรือเลื่อนสวิตช์หรี่ไฟ) เรา ต้องการเพียงสถานะสุดท้ายที่รายงาน
คำถาม: ต้องส่งสถานะอุปกรณ์ทั้งหมดเมื่อโทรไปยัง Report State ไหม
ตอบ: ระบบไม่รองรับการอัปเดตสถานะบางส่วน ดังนั้นการเรียกใช้ Report State ควรมีข้อมูลทั้งหมดสำหรับลักษณะเฉพาะที่เฉพาะเจาะจงซึ่งได้รับการอัปเดตเสมอ หากลักษณะ 2 อย่างทำให้เกิดความไม่สอดคล้องกัน คุณควรรายงานลักษณะทั้ง 2 อย่างพร้อมกัน
คำถาม: Google สามารถค้นหาอุปกรณ์ของฉันเพื่อรับสถานะ (เช่น สำรวจอุปกรณ์) ได้ไหม
ตอบ: กลไกนี้เป็นกลไกสำรองที่เราไม่แนะนำ หากเราจำเป็นต้องกลับไปใช้การสำรวจอุปกรณ์ของผู้ใช้เหล่านั้นบ่อยๆ เราไม่สามารถรับประกันได้ว่าภาระงานเพิ่มเติมจะเป็นอย่างไร ความจำเป็นนี้มาจากแพลตฟอร์มภาพแบบใหม่ นอกเหนือจากปัญหาการโหลดที่ไม่รู้จักแล้ว ยังทำให้ผู้ใช้ได้รับประสบการณ์การใช้งานที่แย่ลงด้วย เรา เชื่อว่าReport Stateเป็นสิ่งสำคัญสำหรับแพลตฟอร์ม
คำถาม: ลักษณะใดบ้างที่รองรับสถานะรายงานในขณะนี้
ตอบ: รองรับลักษณะสาธารณะทั้งหมดที่มีสถานะเชื่อมโยง นอกจากนี้ ควรรายงานการเปลี่ยนแปลง สถานะออนไลน์ของอุปกรณ์ด้วย
โปรดทราบว่าฉากไม่มีสถานะ อย่างไรก็ตาม การดำเนินการดังกล่าวอาจส่งผลให้สถานะของอุปกรณ์มีการเปลี่ยนแปลง หากอุปกรณ์ใดใน Google Home Graph มีการ เปลี่ยนสถานะ คุณจะต้องรายงานกลับ
คำถาม: "รายงานสถานะ" ต้องส่งการประทับเวลาไหม
คำตอบ: เราไม่จำเป็นต้องใช้การประทับเวลา สถานะล่าสุดที่ส่งจะลบล้างการเรียกก่อนหน้า
คำถาม: ฉันต้องรายงานรัฐแยกต่างหากไหมหากส่งรัฐใน Query และ/หรือ Execute อยู่แล้ว
ตอบ: Home Graph จะจัดเก็บเฉพาะสถานะที่ส่งผ่าน Report State สถานะที่ส่งกลับมาเป็นการตอบสนองต่อความตั้งใจ EXECUTE และ QUERY จะใช้สำหรับการตอบกลับด้วยคำพูดต่อผู้ใช้เท่านั้นและจะไม่จัดเก็บ ด้วยเหตุนี้ จึงควรเรียกใช้ Report State แม้ว่าสถานะใหม่ของอุปกรณ์จะแสดงเป็นคำตอบ สำหรับ Intent EXECUTE หรือ QUERY แล้วก็ตาม
ถาม: การไม่ใช้ฟีเจอร์รายงานสถานะให้เสร็จสมบูรณ์ภายในกำหนดเวลาที่ระบุจะมีผลอย่างไร
ตอบ: การดำเนินการนี้จะส่งผลให้ประสบการณ์ของผู้ใช้แย่ลง เช่น ใน Google Home app (GHA)และแพลตฟอร์มภาพ ซึ่งหมายความว่าระบบจะส่ง Intent QUERY จำนวนมาก เพื่อสำรวจสถานะ และเราไม่สามารถรับประกันได้ว่าการดำเนินการนี้จะ สอดคล้องกับภาระงานเพิ่มเติมในระบบคลาวด์ของพาร์ทเนอร์
คำถาม: ฉันจะทดสอบการติดตั้งใช้งานสถานะรายงานได้อย่างไร
ตอบ: ใช้โปรแกรมดูกราฟบ้าน ซึ่งเป็นเครื่องมือทดสอบแบบบริการตนเองที่จะแสดงสถานะอุปกรณ์ปัจจุบันที่จัดเก็บไว้ใน Home Graph
ถาม: เราใช้ requestId แบบสุ่มสำหรับสถานะรายงานได้ไหม
ตอบ: เราขอแนะนำให้พาร์ทเนอร์ใช้ requestId เดียวกันกับที่ได้รับจากคำขอ EXECUTE หาก Report State ทริกเกอร์โดยคำขอ EXECUTE ไม่เช่นนั้น คุณก็ใช้ requestId แบบสุ่มได้
คำถาม: หากผู้ใช้มีอุปกรณ์หลายเครื่องและอุปกรณ์เครื่องใดเครื่องหนึ่งมีการเปลี่ยนแปลงสถานะ เราต้องรายงานสถานะล่าสุดของอุปกรณ์ทั้งหมดไหม
ตอบ: ไม่ คุณต้องรายงานสถานะของอุปกรณ์นั้นๆ เท่านั้น
แนวทางปฏิบัติแนะนำ
ถาม: เวลาในการตอบสนองที่ยอมรับได้คือเท่าใด
ตอบ: เวลาในการตอบสนองที่ต่ำกว่า 200 มิลลิวินาทีถือว่าดีที่สุด และเวลาในการตอบสนองระหว่าง 2-5 วินาทีถือว่าใช้ได้ หากเวลาในการตอบสนองอยู่ที่ประมาณ 5 วินาที โปรดติดต่อเรา
คำถาม: ฉันจะทำอย่างไรให้ลำโพงที่สั่งงานด้วยเสียงตอบสนองอย่างถูกต้องเมื่อออฟไลน์
ตอบ: แสดงสถานะออฟไลน์สำหรับอุปกรณ์ที่ออฟไลน์ เราจะแสดงข้อความ "ไม่พร้อมใช้งาน ในขณะนี้" เป็น TTS สำหรับข้อผิดพลาดนี้ ดูข้อมูลเพิ่มเติมได้ที่ข้อผิดพลาดและข้อยกเว้น