ชุดทดสอบ Google Home

ระบบคลาวด์ต่อคลาวด์    Local Home SDK

Google Home Test Suite เป็นเว็บแอปพลิเคชันที่ช่วยให้คุณ ทดสอบด้วยตนเองสำหรับ Action สมาร์ทโฮม Test Suite สร้างและเรียกใช้กรณีทดสอบโดยอัตโนมัติตามอุปกรณ์และลักษณะ ที่เชื่อมโยงกับบัญชีของคุณ เมื่อทำการทดสอบเสร็จแล้ว คุณจะดูผลการทดสอบได้

หากต้องการใช้ Test Suite และส่งผลการทดสอบให้ Google เพื่อรับการรับรอง โปรดดูข้อมูลในหน้าทดสอบและแชร์การดำเนินการในสมาร์ทโฮม Test Suite เวอร์ชันนี้มีไว้สำหรับการพัฒนาและการรับประกันคุณภาพโดยเฉพาะ

การทดสอบที่ดำเนินการโดย Test Suite รวมถึงแต่ไม่จำกัดเพียงรายการต่อไปนี้

  • ตรวจสอบว่าได้ใช้สถานะรายงานและ ซิงค์คำขอสำหรับอุปกรณ์และลักษณะ ของคุณแล้ว

  • ยืนยันว่ามีการใช้ Intent QUERY สำหรับอุปกรณ์และผลลัพธ์ตรงกับผลลัพธ์ของ Report State

คุณเปิดใช้เครื่องมือ Test Suite ได้โดยคลิกปุ่มด้านล่าง

เปิดตัว Test Suite

ทดสอบ Action ด้วยตนเอง

ส่วนต่อไปนี้จะอธิบายวิธีเรียกใช้ Test Suite ใน อุปกรณ์และโปรเจ็กต์การทำงานของสมาร์ทโฮม Test Suite กำหนดให้คุณต้องลงชื่อเข้าใช้เพื่อให้ตรวจสอบอุปกรณ์ใน Google Home Graphและส่งคำสั่งไปยัง Google Assistantได้โดยตรง

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

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

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

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

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

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

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

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

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

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

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

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

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

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

เกิดข้อผิดพลาดในการรับข้อมูลโมดูล: ข้อผิดพลาด getModuleData: การตอบสนองที่ล้มเหลวของ Http สำหรับ https://hometestsuiteproxy-pa.googleapis.com/v1/module:get: 403 OK 403
  1. ทำตามวิธีการในแก้ปัญหา สิทธิ์ IAM เพื่อให้แน่ใจว่าบัญชีของคุณมี resourcemanager.projects.get สิทธิ์สำหรับโปรเจ็กต์
  2. ไปที่หน้าแอปที่มีสิทธิ์เข้าถึงบัญชีของคุณเพื่อตรวจสอบ สิทธิ์ต่อไปนี้สำหรับ "ชุดทดสอบสำหรับสมาร์ทโฮม"
    • ข้อมูลบัญชีพื้นฐาน
      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. กรอกข้อมูลในช่องที่ต้องกรอกทั้งหมด แล้วคลิกส่ง