ชุดทดสอบ Google Home

ระบบคลาวด์    SDK ของ Local Home

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

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

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

  • ยืนยันว่า Intent QUERY มีผลกับอุปกรณ์ของคุณ และผลลัพธ์ตรงกับผลลัพธ์ของสถานะรายงาน

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

เปิดใช้งาน Test Suite

ทดสอบการดำเนินการด้วยตนเอง

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

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

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

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

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

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

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

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

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

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

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

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

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

หากต้องการส่งผลการทดสอบและรับรองการดำเนินการของสมาร์ทโฮม ให้ทำตามขั้นตอนต่อไปนี้

  1. หลังจากได้รับผลตรวจและพร้อมรับรอง การดำเนินการหน้าแรก ให้คลิกส่งในเครื่องมือ Test Suite
  2. คลิกปุ่มดาวน์โหลดผลการทดสอบเพื่อดูผลการทดสอบ
  3. คลิกไปที่แบบฟอร์มการส่งเพื่อส่งผลการทดสอบไปยัง Google

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