ชุดทดสอบ Google Home

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

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

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

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

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

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

    4. หากคุณเรียกใช้ชุดทดสอบสำหรับอุปกรณ์ Home ให้เลือกรองรับ SDK ของ Home

      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} และให้สิทธิ์ทั้งหมดในหน้าจอขอความยินยอมแล้ว

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

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