ชุดทดสอบ Google Home

Cloud-to-cloud    Local Home SDK

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 ใน อุปกรณ์และโปรเจ็กต์การทำงานของสมาร์ทโฮม Test Suite กำหนดให้คุณต้องลงชื่อเข้าใช้เพื่อให้สามารถตรวจสอบอุปกรณ์ใน Google Home Graph และส่งคำสั่งไปยัง Google Assistant ได้โดยตรง

หากต้องการทดสอบการทำงานด้วยตนเอง ให้ทำตามขั้นตอนต่อไปนี้

  1. เปิด Test Suite ในเว็บเบราว์เซอร์

  2. ลงชื่อเข้าใช้ Google โดยใช้ปุ่มที่มุมขวาบน

  3. กำหนดค่ารายละเอียดโปรเจ็กต์ โดยทำดังนี้

    1. ป้อนตัวระบุโปรเจ็กต์สำหรับการทำงานของสมาร์ทโฮมในช่องรหัสโปรเจ็กต์
    2. คลิกถัดไป

  4. กำหนดค่าการตั้งค่าการทดสอบ โดยทำดังนี้

    1. หากต้องการรับรองการผสานรวม Cloud-to-cloud ให้คงค่าเริ่มต้นของ การหมดเวลา Report State/Request Sync ไว้ อย่างไรก็ตาม สำหรับการทดสอบ คุณสามารถเปลี่ยนค่าการหมดเวลาได้หากเอเจนต์ใช้เวลานานขึ้นในการรายงานสถานะไปยัง Home Graph

    2. หากต้องการรับรองการผสานรวม Cloud-to-cloud ให้ตรวจสอบว่าได้เปิดใช้ตัวเลือก Test Request Sync ไว้แล้ว โดยในระหว่างการทดสอบ ระบบจะแจ้งให้คุณเพิ่ม อัปเดต หรือนำอุปกรณ์ออก และตรวจสอบว่ารายการอุปกรณ์มีการเปลี่ยนแปลงใน Home Graph หรือไม่ การดำเนินการเปลี่ยนแปลงจะเกิดขึ้นผ่านการผสานรวมที่คุณกำลังทดสอบ การผสานรวมที่อยู่ระหว่างการทดสอบต้องมีอุปกรณ์อย่างน้อย 1 เครื่องแนบอยู่กับผู้ใช้เอเจนต์เสมอ

    3. หากใช้ลักษณะ Scene ให้เลือก ทดสอบลักษณะ Scene

    4. หากเรียกใช้ Test Suite สำหรับอุปกรณ์ Local Home ให้เลือกรองรับ Local Home SDK

      1. เลือกการตอบสนองในเครื่อง หรือการตั้งค่าที่ราบรื่น
      2. คลิกรองรับการค้นหาในเครื่อง หากอุปกรณ์จัดการ Intent QUERY ในเครื่องได้

  5. เรียกใช้การทดสอบ และดูผลลัพธ์โดยทำดังนี้

    1. คลิกถัดไป เพื่อเริ่มเรียกใช้การทดสอบ อินเทอร์เฟซจะแสดงอุปกรณ์และลักษณะที่กำลังทดสอบ

  6. ดูหน้าผลลัพธ์และตัวอย่างข้อมูลที่ส่ง โดยทำดังนี้

    1. เมื่อการทดสอบเสร็จสมบูรณ์แล้ว ให้คลิกถัดไป เพื่อดูผลลัพธ์

ผลการทดสอบจะแสดงจำนวนการทดสอบที่ผ่านและไม่ผ่าน รวมถึงคะแนนสุดท้ายที่ระบุเปอร์เซ็นต์การทดสอบที่ผ่าน

การทดสอบการตรวจสอบการลิงก์บัญชี

การลิงก์บัญชีมีบทบาท สำคัญในระบบนิเวศสมาร์ทโฮมของ 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"} สำหรับคำขอโทเค็นการรีเฟรชที่ไม่ถูกต้อง หากการตอบกลับไม่ตรงกับ "รหัสหรือข้อความแสดงข้อผิดพลาด" กรณีทดสอบนี้ จะล้มเหลว โปรดไปที่ แลกเปลี่ยนโทเค็นการรีเฟรชเป็นโทเค็นเพื่อการเข้าถึง เพื่อดูข้อมูลเพิ่มเติม
ทดสอบว่าโทเค็นเพื่อการเข้าถึงได้รับการอัปเดตหลังจากการรีเฟรชโทเค็นหรือไม่ ระบบควรส่งคืนโทเค็นเพื่อการเข้าถึงใหม่เพื่อตอบสนองต่อคำขอโทเค็นการรีเฟรช หากเซิร์ฟเวอร์ส่งโทเค็นเพื่อการเข้าถึงเดียวกัน กรณีทดสอบจะ ล้มเหลว
ตรวจสอบว่าโทเค็นเพื่อการเข้าถึงที่ยังไม่หมดอายุยังคงใช้ได้หรือไม่ ระบบจะแสดงเวลาหมดอายุของโทเค็นเพื่อการเข้าถึง
ตรวจสอบว่าโทเค็นการรีเฟรชมีการหมุนเวียนระหว่างการรีเฟรชหรือไม่ เราจะตรวจสอบว่าโทเค็นการรีเฟรชมีการเปลี่ยนแปลงหลังจากคำขอโทเค็นการรีเฟรชหรือไม่ หาก โทเค็นการรีเฟรชมีการเปลี่ยนแปลง เซิร์ฟเวอร์ควรทำให้โทเค็นการรีเฟรชเก่าไม่ถูกต้องหลังจากมีการใช้โทเค็นการรีเฟรชใหม่แล้วเท่านั้น เพื่อป้องกันสภาวะการแข่งขัน ที่อาจทำให้การลิงก์บัญชีของผู้ใช้หยุดทำงาน การทดสอบจะล้มเหลวหากคุณ ทำให้โทเค็นการรีเฟรชเก่าไม่ถูกต้องก่อนที่จะมีการใช้โทเค็นใหม่

ข้อความแสดงข้อผิดพลาด

ตารางต่อไปนี้แสดงข้อความแสดงข้อผิดพลาดที่พบบ่อยซึ่งคุณอาจพบและวิธีแก้ปัญหาที่แนะนำ

ข้อความแสดงข้อผิดพลาด วิธีแก้ปัญหา
API ของ HomeGraph ไม่เคยใช้ในโปรเจ็กต์ <_id_> มาก่อนหรือ ถูกปิดใช้ ตรวจสอบว่าคุณได้เปิดใช้ API ของ HomeGraph แล้ว
ไม่พบเอนทิตีที่ขอ ตรวจสอบว่า agentUserId ของคุณถูกต้องและลิงก์กับ บริการแล้ว

ตรวจสอบว่าคุณมีสิทธิ์ resourcemanager.projects.get ในโปรเจ็กต์ ${your project id} และได้ให้สิทธิ์ทั้งหมดในหน้าจอขอความยินยอมแล้ว

Error getting module data: getModuleData error: Http failure response for https://hometestsuiteproxy-pa.googleapis.com/v1/module:get: 403 OK 403
  1. ทำตามวิธีการที่หัวข้อแก้ปัญหา เกี่ยวกับสิทธิ์ IAM เพื่อตรวจสอบว่าบัญชีของคุณมี resourcemanager.projects.get สำหรับโปรเจ็กต์
  2. ไปที่หน้าแอปที่มีสิทธิ์เข้าถึงบัญชีของคุณเพื่อตรวจสอบสิทธิ์ต่อไปนี้สำหรับ "Test Suite สำหรับสมาร์ทโฮม":
    • ข้อมูลบัญชีทั่วไป
      1. ดูอีเมลหลักของบัญชี Google
      2. ดูข้อมูลส่วนบุคคล ซึ่งรวมถึงข้อมูลส่วนบุคคลใดๆ ที่คุณได้ เผยแพร่ต่อสาธารณะด้วย
    • การเข้าถึงเพิ่มเติม
      1. ใช้ Assistant: สิทธิ์เข้าถึง บัญชี Google แบบกว้าง
      2. ตรวจสอบและควบคุมอุปกรณ์ในบ้านอัจฉริยะใน Home Graph
    หากได้รับข้อผิดพลาดเกี่ยวกับสิทธิ์ ให้นำสิทธิ์เข้าถึงออกก่อน แล้วให้สิทธิ์ทั้งหมดใน หน้าจอขอความยินยอมเมื่อลงชื่อเข้าใช้อีกครั้ง

ส่งผลการทดสอบ

ผลการทดสอบของ Test Suite ต้องผ่านการทดสอบ 100% ก่อนที่จะ ส่งเพื่อขอการรับรอง หากมีลักษณะที่ต้องทำการทดสอบด้วยตนเอง คุณควรเรียกใช้เครื่องมือ Test Suite และแนบผลลัพธ์แม้ว่าการทดสอบจะยังไม่ผ่าน 100% ก็ตาม

หากต้องการส่งผลการทดสอบและรับรองCloud-to-cloud การผสานรวม ให้ทำตามขั้นตอนต่อไปนี้

  1. หลังจากได้รับผลการทดสอบและพร้อมที่จะรับรองการผสานรวม Cloud-to-cloud แล้ว ให้คลิก ส่ง ในเครื่องมือ Test Suite
  2. ไปที่ Google Home Developer Console > Cloud-to-cloud > รับรอง
  3. เลือกการผสานรวมที่ต้องการรับรอง
  4. ป้อนรหัสผลลัพธ์ Test Suiteในส่วนเอกสารประกอบ

  5. กรอกข้อมูลในช่องที่ต้องกรอกทั้งหมด แล้วคลิกส่ง