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

Matter    Device 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.1.1.14 และ 3.24.1.4
  2. เข้าสู่ระบบบัญชี Google ใน GHA

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

มี 2 วิธีในการติดตั้ง Google Home UI Automator, 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 โปรดกรอกแบบฟอร์มความคิดเห็น

รายงานปัญหา

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