Google Home Test Suite เป็นเว็บแอปพลิเคชันที่ช่วยให้คุณ ทดสอบการดำเนินการสำหรับสมาร์ทโฮมด้วยตนเองได้ Test Suite จะสร้างและเรียกใช้กรณีทดสอบโดยอัตโนมัติตามอุปกรณ์และลักษณะ ที่เชื่อมโยงกับบัญชีของคุณ เมื่อทำการทดสอบเสร็จแล้ว คุณจะดูผลการทดสอบได้
หากต้องการใช้ Test Suite และส่งผลการทดสอบไปยัง Google เพื่อขอการรับรอง โปรดดูข้อมูลในหน้า ทดสอบและแชร์การดำเนินการสำหรับสมาร์ทโฮม Test Suite เวอร์ชันนี้ออกแบบมาเพื่อTest Suiteการพัฒนาและการประกันคุณภาพโดยเฉพาะ
การทดสอบที่ Test Suite ดำเนินการ ได้แก่ แต่ไม่ จำกัดเพียงการทดสอบต่อไปนี้
ตรวจสอบว่าได้มีการติดตั้งใช้งาน Report State และ Request Sync สำหรับอุปกรณ์และลักษณะของคุณแล้ว
ยืนยันว่าได้มีการติดตั้งใช้งาน Intent QUERY สำหรับอุปกรณ์แล้ว และผลลัพธ์ตรงกับผลลัพธ์ของ Report State
คุณสามารถเปิดใช้เครื่องมือ Test Suite ได้โดยคลิกปุ่ม ด้านล่าง
ทดสอบการดำเนินการด้วยตนเอง
ส่วนต่อไปนี้จะอธิบายวิธีเรียกใช้ Test Suite ใน อุปกรณ์และโปรเจ็กต์การดำเนินการสำหรับสมาร์ทโฮม Test Suite กำหนดให้คุณต้องลงชื่อเข้าใช้เพื่อให้สามารถตรวจสอบอุปกรณ์ใน Google Home Graph และส่งคำสั่งไปยัง Google Assistant ได้โดยตรง
หากต้องการทดสอบการดำเนินการด้วยตนเอง ให้ทำตามขั้นตอนต่อไปนี้
- เปิด Test Suite ในเว็บเบราว์เซอร์
ลงชื่อเข้าใช้ Google โดยใช้ปุ่มที่มุมขวาบน
กำหนดค่ารายละเอียดโปรเจ็กต์ โดยทำดังนี้
- ป้อนตัวระบุโปรเจ็กต์สำหรับการดำเนินการสำหรับสมาร์ทโฮมในช่องรหัสโปรเจ็กต์
- คลิกถัดไป
กำหนดค่าการตั้งค่าการทดสอบ โดยทำดังนี้
- หากต้องการรับรองการผสานรวม Cloud-to-cloud ให้คงค่าเริ่มต้นของ การหมดเวลา Report State/Request Sync ไว้ อย่างไรก็ตาม สำหรับการทดสอบ คุณสามารถเปลี่ยนค่าการหมดเวลาได้หากเอเจนต์ใช้เวลานานขึ้นในการรายงานสถานะไปยัง Home Graph
หากต้องการรับรองการผสานรวมCloud-to-cloud ให้ตรวจสอบว่าได้เปิดใช้ตัวเลือกทดสอบ Request Sync ไว้แล้ว โดยระหว่างการทดสอบ ระบบจะแจ้งให้คุณเพิ่ม อัปเดต หรือนำอุปกรณ์ออก และตรวจสอบว่ารายการอุปกรณ์มีการเปลี่ยนแปลงใน Home Graph หรือไม่ การดำเนินการเปลี่ยนแปลงจะเกิดขึ้นผ่านการผสานรวมที่คุณกำลังทดสอบ การผสานรวมที่อยู่ระหว่างการทดสอบต้องมีอุปกรณ์อย่างน้อย 1 เครื่องแนบอยู่กับผู้ใช้เอเจนต์เสมอ
หากใช้ลักษณะ Scene ให้เลือก ทดสอบลักษณะ Scene
หากเรียกใช้ชุดโปรแกรมทดสอบสำหรับอุปกรณ์ Local Home ให้เลือกรองรับ Local Home SDK
- เลือกการตอบสนองในเครื่อง หรือการตั้งค่าที่ราบรื่น
- คลิกรองรับการค้นหาในเครื่อง หากอุปกรณ์จัดการ Intent QUERY ในเครื่องได้
เรียกใช้การทดสอบ และดูผลลัพธ์โดยทำดังนี้
- คลิกถัดไป เพื่อเริ่มเรียกใช้การทดสอบ อินเทอร์เฟซจะแสดงอุปกรณ์และลักษณะที่กำลังทดสอบ
ดูหน้าผลลัพธ์และตัวอย่างข้อมูลที่ส่ง โดยทำดังนี้
- เมื่อการทดสอบเสร็จสมบูรณ์แล้ว ให้คลิกถัดไป เพื่อดูผลลัพธ์
ผลการทดสอบจะแสดงจำนวนการทดสอบที่ผ่านและไม่ผ่าน รวมถึงคะแนนสุดท้ายที่ระบุเปอร์เซ็นต์การผ่าน
การทดสอบการตรวจสอบการลิงก์บัญชี
การลิงก์บัญชีมีบทบาทสำคัญในระบบนิเวศของสมาร์ทโฮมของ Google การทดสอบการตรวจสอบการลิงก์บัญชี ใน Test Suite จะตรวจสอบบริการ OAuth เพื่อหา ปัญหาที่อาจเกิดขึ้น
การทดสอบการตรวจสอบการลิงก์บัญชีประกอบด้วยการทดสอบเพื่อตรวจสอบโทเค็นเพื่อการเข้าถึง และ โทเค็นการรีเฟรช ดังนี้
การทดสอบการตรวจสอบโทเค็นเพื่อการเข้าถึง
ระบบจะทดสอบโทเค็นเพื่อการเข้าถึงที่ส่งคืนจากปลายทางการแลกเปลี่ยนโทเค็นเพื่อให้แน่ใจว่าโทเค็นมีรูปแบบที่ถูกต้องและส่งคืนพร้อมกับโทเค็นการรีเฟรชที่ถูกต้อง
| รายการทดสอบ | คำอธิบาย |
|---|---|
| ตรวจสอบว่าโทเค็นเพื่อการเข้าถึงอยู่ในรูปแบบ JWT หรือไม่ | การลิงก์บัญชี Google ไม่แนะนำให้ใช้โทเค็นเพื่อการเข้าถึงในรูปแบบ JWT หากพบรูปแบบ JWT ระบบจะแสดงประกาศเตือนต่อไปนี้
The access token seems to be JWT, this is not good. Because it
unnecessarily exposes information about partner implementation and we
recommend opaque symmetric encrypted access token.
|
| ตรวจสอบว่าโทเค็นเพื่อการเข้าถึงที่หมดอายุได้มีโทเค็นการรีเฟรชหรือไม่ | คุณต้องระบุโทเค็นการรีเฟรชเมื่อโทเค็นเพื่อการเข้าถึงหมดอายุได้ การทดสอบนี้จะล้มเหลวหากไม่พบโทเค็นการรีเฟรช |
การทดสอบการตรวจสอบโทเค็นการรีเฟรช
ระบบจะทดสอบโทเค็นการรีเฟรชเพื่อให้แน่ใจว่าปลายทางการแลกเปลี่ยนโทเค็นแลกเปลี่ยนโทเค็นการรีเฟรชเป็นโทเค็นเพื่อการเข้าถึงใหม่ได้อย่างถูกต้อง
| รายการทดสอบ | คำอธิบาย |
|---|---|
| โทเค็นการรีเฟรชที่มีโทเค็นการรีเฟรชไม่ถูกต้อง และตรวจสอบการตอบกลับของพาร์ทเนอร์ | เซิร์ฟเวอร์ควรแสดงข้อผิดพลาด HTTP 400 Bad Request พร้อม
{"error": "invalid_grant"} สำหรับคำขอโทเค็นการรีเฟรชที่ไม่ถูกต้อง
หากการตอบกลับไม่ตรงกับ "รหัสหรือข้อความแสดงข้อผิดพลาด" กรณีทดสอบนี้
จะล้มเหลว โปรดไปที่
แลกเปลี่ยนโทเค็นการรีเฟรชเป็นโทเค็นเพื่อการเข้าถึง เพื่อดูข้อมูลเพิ่มเติม |
| ทดสอบว่าโทเค็นเพื่อการเข้าถึงได้รับการอัปเดตหลังจากการรีเฟรชโทเค็นหรือไม่ | ระบบควรส่งคืนโทเค็นเพื่อการเข้าถึงใหม่เพื่อตอบสนองต่อคำขอโทเค็นการรีเฟรช หากเซิร์ฟเวอร์ส่งโทเค็นเพื่อการเข้าถึงเดียวกัน กรณีทดสอบจะ ล้มเหลว |
| ตรวจสอบว่าโทเค็นเพื่อการเข้าถึงที่ยังไม่หมดอายุยังคงใช้งานได้หรือไม่ | ระบบจะแสดงเวลาหมดอายุของโทเค็นเพื่อการเข้าถึง |
| ตรวจสอบว่าโทเค็นการรีเฟรชมีการหมุนเวียนระหว่างการรีเฟรชหรือไม่ | เราจะตรวจสอบว่าโทเค็นการรีเฟรชมีการเปลี่ยนแปลงหลังจากคำขอโทเค็นการรีเฟรชหรือไม่ หาก โทเค็นการรีเฟรชมีการเปลี่ยนแปลง เซิร์ฟเวอร์ควรทำให้โทเค็นการรีเฟรชเก่าไม่ถูกต้องหลังจากมีการใช้โทเค็นการรีเฟรชใหม่แล้วเท่านั้น เพื่อป้องกันสภาวะการแข่งขัน ที่อาจทำให้การลิงก์บัญชีของผู้ใช้หยุดทำงาน การทดสอบจะล้มเหลวหากคุณ ทำให้โทเค็นการรีเฟรชเก่าไม่ถูกต้องก่อนที่จะมีการใช้โทเค็นใหม่ |
ข้อความแสดงข้อผิดพลาด
ตารางต่อไปนี้แสดงข้อความแสดงข้อผิดพลาดที่พบบ่อยบางรายการที่คุณอาจพบและวิธีแก้ปัญหาที่แนะนำ
| ข้อความแสดงข้อผิดพลาด | วิธีแก้ปัญหา |
|---|---|
| ไม่เคยใช้ HomeGraph API ในโปรเจ็กต์ <_id_> มาก่อนหรือ ถูกปิดใช้ | ตรวจสอบว่าคุณได้เปิดใช้ HomeGraph API แล้ว |
| ไม่พบเอนทิตีที่ขอ | ตรวจสอบว่า agentUserId ของคุณถูกต้องและลิงก์กับ
บริการแล้ว |
ตรวจสอบว่าคุณมีสิทธิ์ Error getting module data: getModuleData error: Http failure response for https://hometestsuiteproxy-pa.googleapis.com/v1/module:get: 403 OK 403 |
|
ส่งผลการทดสอบ
ผลการทดสอบของ Test Suite ต้องผ่านการทดสอบ 100% ก่อนที่จะ ส่งเพื่อขอการรับรอง หากมีลักษณะที่ต้องมีการทดสอบด้วยตนเอง คุณควรเรียกใช้เครื่องมือ Test Suite และแนบผลลัพธ์แม้ว่าการทดสอบจะยังไม่ผ่าน 100% ก็ตาม
หากต้องการส่งผลการทดสอบและรับรองCloud-to-cloud การผสานรวม ให้ทำตามขั้นตอนต่อไปนี้
- หลังจากได้รับผลการทดสอบและพร้อมที่จะรับรองการผสานรวม Cloud-to-cloud แล้ว ให้คลิก ส่ง ในเครื่องมือ Test Suite
- ไปที่ Google Home Developer Console > Cloud-to-cloud > รับรอง
- เลือกการผสานรวมที่ต้องการรับรอง
- ป้อนรหัสผลลัพธ์ Test Suiteในส่วนเอกสารประกอบ
กรอกข้อมูลในช่องที่ต้องกรอกทั้งหมด แล้วคลิกส่ง