ชุดทดสอบ Google Home

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

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

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

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

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

  • ตรวจสอบว่าเจตนา QUERY ได้ถูกนำไปใช้กับอุปกรณ์ของคุณแล้ว และผลลัพธ์ตรงกับผลลัพธ์ของสถานะรายงาน

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

เปิดตัว Test Suite

ทดสอบการกระทำของคุณด้วยตนเอง

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

หากต้องการทดสอบการกระทำของคุณด้วยตนเอง ให้ทำตามขั้นตอนเหล่านี้:

  1. ในเว็บเบราว์เซอร์ของคุณ ให้เปิด Test Suite

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

  3. กำหนดค่ารายละเอียดโครงการ:

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

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

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

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

    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. กรอกข้อมูลในช่องที่ต้องกรอกทั้งหมด แล้วคลิกส่ง