เครื่องมือสร้าง UI ของ Google Home อัตโนมัติ

Matter

Google Home UI Automator ช่วยให้คุณทำให้ Google Home app (GHA) เป็นอัตโนมัติได้เพื่อทดสอบการคอมมิชชัน การเลิกคอมมิชชัน Matter หรือทำการทดสอบการถดถอย (Regression Test) กับการคอมมิชชันของคุณ

ภาพนี้แสดงวิธีจับคู่อุปกรณ์ Matter กับ Google Home

สิ่งที่ต้องมีก่อน

หากต้องการใช้ Google Home UI Automator คุณต้องเตรียมสิ่งต่อไปนี้ให้พร้อม

Python 3

เราขอแนะนําให้ใช้สภาพแวดล้อม Python 3 เพื่อเรียกใช้สคริปต์ Google Home UI Automator ต้องใช้ python 3.11 ขึ้นไป

โทรศัพท์ Android

  1. เปิดโหมดการแก้ไขข้อบกพร่องของผู้ใช้ในโทรศัพท์ Android ดูหัวข้อเปิดใช้ตัวเลือกสำหรับนักพัฒนาแอปเพื่อเปิดการตั้งค่าการแก้ไขข้อบกพร่อง
  2. เชื่อมต่อโทรศัพท์ Android กับคอมพิวเตอร์

แอป Google Home

  1. ติดตั้ง GHA ในโทรศัพท์ Android ตรวจสอบว่าเวอร์ชันของ GHA คือ 3.1.1.14 และ 3.32.126.2
  2. เข้าสู่ระบบบัญชี Google ใน GHA

ติดตั้ง Google Home UI Automator

การติดตั้ง Google Home UI Automator ทำได้ 2 วิธี คือ PyPI หรือจากซอร์สโค้ด เราขอแนะนำให้ติดตั้งด้วย PyPI

pip install google-home-ui-automator

สร้างจากซอร์สโค้ด

หากต้องการสร้างจากซอร์สโค้ด ให้ทำตามขั้นตอนต่อไปนี้ในเทอร์มินัล

  1. โคลนที่เก็บนี้:

    git clone https://testsuite-smarthome-matter.googlesource.com/ui-automator
    
  2. ไปที่ที่เก็บที่โคลน:

    cd ui-automator
    
  3. เรียกใช้คำสั่งต่อไปนี้

    pip install .
    

จัดเตรียมอุปกรณ์ Matter

หากต้องการคอมมิชชันอุปกรณ์ Matter ให้ป้อนคำสั่งต่อไปนี้

ui-automator --commission DEVICE_NAME,PAIRING_CODE,ROOM_NAME [--google_account GOOGLE_ACCOUNT]
ค่าอินพุต คำอธิบาย ตัวอย่าง
DEVICE_NAME เลือกอุปกรณ์ Matter เครื่องแล้ว m5stack
PAIRING_CODE รหัสการจับคู่ของอุปกรณ์ Matter 34970112332
ROOM_NAME ห้องที่กำหนด Office
GOOGLE_ACCOUNT บัญชีที่จะใช้ใน GHA test@gmail.com

ภาพนี้แสดงวิธีจับคู่อุปกรณ์ Matter กับ Google Home

เลิกใช้งานอุปกรณ์ Matter

หากต้องการเลิกใช้งานอุปกรณ์ Matter ให้ป้อนคำสั่งต่อไปนี้

ui-automator --decommission DEVICE_NAME [--google_account GOOGLE_ACCOUNT]
ค่าอินพุต คำอธิบาย ตัวอย่าง
DEVICE_NAME แสดงชื่อของอุปกรณ์ Matter ที่คอมมิชชันใน GHA m5stack
GOOGLE_ACCOUNT บัญชีที่จะใช้ใน GHA test@gmail.com
รูปภาพนี้แสดงไอคอนสำหรับการแสดงความคิดเห็นและการรายงานปัญหาใน Google Home Playground

ทำการทดสอบการถดถอย

หากต้องการทำการทดสอบการถดถอย ให้ป้อนโค้ดต่อไปนี้ คุณต้องใส่แฟล็ก --regtest และ --commission เพื่อทำการทดสอบการถดถอย

ui-automator --commission DEVICE_NAME,PAIRING_CODE,ROOM_NAME --regtest [--repeat REPEAT_TIMES] [--hub HUB_VERSION] [--dut MODEL,TYPE,PROTOCOL] [--fw DEVICE_FIRMWARE] [--google_account GOOGLE_ACCOUNT]
ค่าอินพุต คำอธิบาย ตัวอย่าง
DEVICE_NAME เลือกอุปกรณ์ Matter เครื่องแล้ว m5stack
PAIRING_CODE รหัสการจับคู่ของอุปกรณ์ Matter 34970112332
ROOM_NAME ห้องที่กำหนด Office
GOOGLE_ACCOUNT บัญชีที่จะใช้ใน GHA test@gmail.com

การทดสอบการถดถอยรองรับเฉพาะวงจรการทดสอบระบบและการเลิกใช้งานเท่านั้น โดยค่าเริ่มต้น การทดสอบการถดถอยจะทำงานจนกว่าผู้ใช้จะใช้แป้นพิมพ์เพื่อหยุดกระบวนการ

คุณสามารถเพิ่มสิ่งต่อไปนี้เพื่อให้ได้ผลการทดสอบที่ละเอียดยิ่งขึ้น

ค่า ค่าอินพุต คำอธิบาย ตัวอย่าง
--repeat REPEAT_TIMES ทำการทดสอบการถดถอยในเวลาที่จำกัดและทำซ้ำๆ 5
--hub HUB_VERSION เวอร์ชันฮับสำหรับควบคุมอุปกรณ์ใน GHA 15.20221210.3.1
--dut อุปกรณ์ที่อยู่ระหว่างการทดสอบ
MODEL รุ่นอุปกรณ์ X123123
TYPE ประเภทอุปกรณ์ LIGHT
PROTOCOL โปรโตคอลของอุปกรณ์ MATTER
--fw DEVICE_FIRMWARE เฟิร์มแวร์ของอุปกรณ์ 2.2.0

รูปภาพนี้แสดงสรุปการทดสอบการถดถอย

ความคิดเห็น

หากต้องการส่งความคิดเห็นหรือข้อเสนอแนะเกี่ยวกับวิธีปรับปรุงประสบการณ์การใช้งาน Google Home UI Automator โปรดกรอกแบบฟอร์มความคิดเห็น

รายงานปัญหา

รายงานปัญหาที่พบโดยใช้Issue Tracker