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

Matter    Device SDK

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

รูปภาพนี้แสดงวิธีจับคู่อุปกรณ์ 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.25.1.4
  2. เข้าสู่ระบบบัญชี Google ใน GHA

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

การติดตั้ง 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
ค่าอินพุต คำอธิบาย ตัวอย่าง
DEVICE_NAME อุปกรณ์ Matter ที่เลือก m5stack
PAIRING_CODE รหัสการจับคู่ของอุปกรณ์ Matter 34970112332
ROOM_NAME ห้องที่กําหนด Office

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

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

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

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

เรียกใช้การทดสอบแบบถดถอย

ป้อนรหัสต่อไปนี้เพื่อทำการทดสอบรีเกรชัน คุณต้องใส่ Flag --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]

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

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

ค่า ค่าอินพุต คำอธิบาย ตัวอย่าง
--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

รายงานปัญหา

รายงานปัญหาที่พบโดยใช้เครื่องมือติดตามปัญหา