ชุดทดสอบ Google Home

ระบบที่เชื่อมต่อระหว่างระบบคลาวด์    Local Home SDK

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

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

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

    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_> มาก่อนหรือถูกปิดใช้ ตรวจสอบว่าคุณได้เปิดใช้ 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. กรอกข้อมูลในช่องที่ต้องกรอกทั้งหมด แล้วคลิกส่ง