โปรดทราบ โปรแกรมทดลองใช้สําหรับนักพัฒนาซอฟต์แวร์ใหม่จะเปิดตัวเร็วๆ นี้ สมัครที่นี่ และร่วมเป็นหนึ่งในคนกลุ่มแรกที่ได้ลองใช้เครื่องมือใหม่ๆ และแสดงความคิดเห็น

ชุดทดสอบ Google Home

Cloud-to-cloud    Local Home SDK

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 เครื่องที่แนบอยู่กับผู้ใช้ Agent

    3. หากคุณใช้ลักษณะเฉพาะของฉาก ให้เลือกลักษณะของฉาก

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

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

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

ตารางต่อไปนี้จะแสดงข้อความแสดงข้อผิดพลาดทั่วไปที่คุณอาจพบ และวิธีที่แนะนําในการแก้ไขปัญหา

ข้อความแสดงข้อผิดพลาด วิธีแก้ปัญหา
ไม่เคยใช้ 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. ไปที่หน้าแอปที่มีสิทธิ์เข้าถึงบัญชีของคุณเพื่อตรวจสอบสิทธิ์ต่อไปนี้สําหรับ "Test Suite for Smart Home"
    • ข้อมูลบัญชีพื้นฐาน
      1. ดูอีเมลหลักของบัญชี Google
      2. ดูข้อมูลส่วนตัว ซึ่งรวมถึงข้อมูลส่วนตัวใดๆ ที่คุณได้เผยแพร่ต่อสาธารณะ
    • การเข้าถึงเพิ่มเติม
      1. ใช้ Assistant: เข้าถึงบัญชี Google ของคุณได้กว้างขวาง
      2. ตรวจสอบและควบคุมอุปกรณ์ในบ้านอัจฉริยะใน Home Graph ของคุณ
    หากพบข้อผิดพลาดเกี่ยวกับสิทธิ์ ให้นําสิทธิ์เข้าถึงออกก่อน แล้วให้สิทธิ์เข้าถึงทั้งหมดในหน้าจอคํายินยอมเมื่อลงชื่อเข้าสู่ระบบอีกครั้ง

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

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

หากต้องการส่งผลการทดสอบและรับรองการดําเนินการในบ้านอัจฉริยะ ให้ทําตามขั้นตอนต่อไปนี้

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

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