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

กรณี    SDK ของอุปกรณ์

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

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

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

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

งูหลาม 3

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

โทรศัพท์ Android

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

แอป Google Home

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

ติดตั้งตัวสร้าง UI อัตโนมัติของ Google Home

คุณติดตั้ง Google Home UI Automator, PyPI หรือจากซอร์สโค้ดได้ 2 วิธี เราขอแนะนำให้ติดตั้งด้วย 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 โปรดกรอกแบบฟอร์มความคิดเห็น

รายงานปัญหา

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