การแก้ไขข้อบกพร่องการผสานรวมกรณี

1. ก่อนเริ่มต้น

Matter มอบประสบการณ์การตั้งค่าและการควบคุมอุปกรณ์ข้ามแพลตฟอร์มที่ราบรื่นให้แก่ผู้ใช้ปลายทาง โดยสาเหตุหลักมาจากระบบนิเวศหลายอย่างที่ทำงานร่วมกันอยู่เบื้องหลัง ระบบแก้ปัญหาเช่นนี้มักจะเป็นปัญหาสำหรับนักพัฒนาซอฟต์แวร์รายใหม่ๆ เราจึงพัฒนาชุดเครื่องมือและเทคนิคต่างๆ ที่จะช่วยให้ชีวิตของคุณง่ายขึ้นในฐานะนักพัฒนาซอฟต์แวร์ Matter ด้วย Google Home

โค้ดแล็บนี้ครอบคลุมคอมโพเนนต์หลัก 3 อย่างของ Matter สําหรับระบบเหล่านี้แต่ละระบบ Google มีชุดข้อมูลวิเคราะห์การแก้ปัญหาสําหรับนักพัฒนาแอปที่รวบรวมจากโทรศัพท์และฮับ

การจัดเตรียม การดำเนินการ การอัปเดต OTA

ในฐานะนักพัฒนาแอป การช่วยลดปัญหาที่คุณพบได้ตลอดรอบการพัฒนาอุปกรณ์ถือเป็นสิ่งสำคัญอย่างยิ่ง เมื่อเปิดตัวโปรเจ็กต์แล้ว คุณต้องตรวจสอบแนวโน้มปัญหาของอุปกรณ์ที่ใช้งานจริงในลักษณะรวม และแก้ไขผ่านอัปเดตซอฟต์แวร์ โค้ดแล็บนี้ครอบคลุมเทคนิคที่คุณใช้ได้กับทั้ง 2 วัตถุประสงค์

ข้อกำหนดเบื้องต้น

  • ดำเนินการตามคำแนะนำในการเริ่มต้นใช้งาน Matter ให้เสร็จสมบูรณ์ด้วยโปรเจ็กต์ Matter และการตั้งค่าอุปกรณ์ที่ใช้งานได้
  • มีโทรศัพท์ Android ที่เชื่อมต่อกับเวิร์กสเตชันได้ (สำหรับบันทึก ADB)

สิ่งที่คุณจะได้เรียนรู้

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

2. ดูข้อมูลวิเคราะห์ของ Google Home

การตรวจสอบประสิทธิภาพเป็นสิ่งสำคัญสำหรับการผสานรวมกับระบบนิเวศของ Google Home อย่างประสบความสำเร็จ เรามีชุดเครื่องมือตรวจสอบสำหรับนักพัฒนาแอปสมาร์ทโฮมใน Google Cloud Platform คุณสามารถใช้เครื่องมือเหล่านี้เพื่อวัดประสิทธิภาพของโปรเจ็กต์

เข้าถึงเมตริกโปรเจ็กต์

  • ขั้นตอนแรกในการเข้าถึงข้อมูลคือการตรวจสอบหน้าแดชบอร์ดของ Google Home โดยเข้าสู่ระบบ Google Cloud Console แล้วไปที่การดําเนินการ > การตรวจสอบ > หน้าแดชบอร์ด

แดชบอร์ดที่มีให้ใช้งานในโปรเจ็กต์มีจํานวนมาก (รวมถึงผลิตภัณฑ์ GCP อื่นๆ) แดชบอร์ดที่ให้บริการสําหรับสมาร์ทโฮมจะมีคํานำหน้า Google Home Analytics

แดชบอร์ด Analytics ของ Google Home

ปัจจุบันเรามีแดชบอร์ดทั่วไปที่ครอบคลุมทั้งโปรเจ็กต์ รวมถึงแดชบอร์ดสำหรับการผสานรวมที่เฉพาะเจาะจง (ระบบคลาวด์ อุปกรณ์ภายใน Matter) หรือประเภทอุปกรณ์ (กล้อง) แดชบอร์ดเหล่านี้จะมีข้อมูลก็ต่อเมื่อคุณมีการผสานรวมของประเภทนั้นๆ พร้อมกับโปรเจ็กต์ที่ทำงานซึ่งดำเนินการตามคำขอเท่านั้น

เมื่อเปิดหน้าแดชบอร์ดเหล่านี้ คุณจะเห็นชุดแผนภูมิที่มีลักษณะดังต่อไปนี้

รายละเอียดอัตราความสำเร็จ เวลาในการตอบสนอง และประเภทอุปกรณ์

แดชบอร์ดของ Google Home มีแผนภูมิต่างๆ ที่แสดงรายละเอียดเหตุการณ์ที่เชื่อมโยงกับโปรเจ็กต์ของคุณ แดชบอร์ดการผสานรวมแต่ละรายการจะแสดงแผนภูมิที่แสดงจำนวนคำขอทั้งหมดที่โปรเจ็กต์จัดการ แผนภูมิแสดงอัตราความสำเร็จของการผสานรวมประเภทนั้น และแผนภูมิหลายรายการที่แสดงประเภทอุปกรณ์และลักษณะที่เกี่ยวข้อง นอกจากนี้ Matter ยังมีชุดแผนภูมิที่ติดตามความสําเร็จของการจัดเตรียมใช้งาน รวมถึงการเปิดตัวการอัปเดตในอุปกรณ์

โปรดทราบว่ามุมมองเริ่มต้นที่มีแผนภูมิที่คุณเห็นในแดชบอร์ด Google Home Analytics เป็นเพียงมุมมองที่เราสร้างขึ้นสำหรับโปรเจ็กต์ของคุณโดยใช้ข้อมูลเมตริกสมาร์ทโฮม นอกจากนี้ คุณยังใช้เครื่องมือสํารวจเมตริกเพื่อสร้างแผนภูมิของคุณเองจากเมตริกพื้นฐานเดียวกันและบันทึกไว้ในหน้าแดชบอร์ดที่กำหนดเองได้ด้วย

เข้าถึงบันทึกข้อผิดพลาด

เครื่องมือสำรวจบันทึกคือชุดเครื่องมือสำหรับทำงานกับบันทึกเหตุการณ์ที่สร้างขึ้นในโปรเจ็กต์ โดยเข้าถึงได้ใน คอนโซล Google Cloud โดยไปที่การดําเนินการ > การบันทึก > เครื่องมือสํารวจบันทึก

เมื่อเปิดเครื่องมือสำรวจบันทึก คุณจะเห็นมุมมองดังต่อไปนี้

เครื่องมือสำรวจบันทึก

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

3. แก้ไขข้อบกพร่องในการเตรียมใช้งาน

เมตริกประเภทแรกที่เรามาดูกันเกี่ยวข้องกับเหตุการณ์การจัดเตรียมใช้งาน Matter การใช้งานหมายถึงชุดขั้นตอนที่ผู้ใช้ต้องตั้งค่าอุปกรณ์ Matter เป็นครั้งแรก

ระหว่างการให้อุปกรณ์ใช้งาน ชุดการโต้ตอบจะเกิดขึ้นระหว่างอุปกรณ์ Matter, แอป Google Home และเนื้อผ้า Matter รูปภาพต่อไปนี้แสดงเหตุการณ์เหล่านี้บางส่วน

เหตุการณ์การจัดเตรียมใช้งาน Matter

คุณสามารถดูข้อมูลเพิ่มเติมเกี่ยวกับขั้นตอนเหล่านี้แต่ละขั้นตอนได้ในหน้าการเริ่มต้นใช้งานจาก Matter Primer ในส่วนนี้ เราจะกล่าวถึงเครื่องมือและเทคนิคในการดีบักปัญหาการใช้งาน

ใช้ ข้อมูลวิเคราะห์ Google Home

เราได้สร้างชุดเมตริกให้คุณตรวจสอบปัญหาเกี่ยวกับการเปิดใช้งานโดยติดตามเหตุการณ์และทำความเข้าใจว่าข้อผิดพลาดอาจเกิดขึ้นในระยะใด ซึ่งคุณจะดูได้ในแดชบอร์ดการผสานรวม Matter ตามที่เราได้อธิบายไว้ในส่วนก่อนหน้า

แผนภูมิในหน้าแดชบอร์ดนี้แสดงข้อมูลเกี่ยวกับการเตรียมอุปกรณ์

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

แผนภูมิจํานวนอุปกรณ์แสดงจํานวนความพยายามของผู้ใช้ในการเปิดใช้งานอุปกรณ์ในวันที่หนึ่งๆ อัตราความสำเร็จจะแสดงอัตราความสำเร็จที่รับรู้สําหรับเหตุการณ์เหล่านี้ในฝั่งของ Google การพยายามจัดเตรียมใช้งานแต่ละครั้งจะสร้างชุดเหตุการณ์ที่มีสถานะที่เกี่ยวข้อง เมื่อเกิดข้อผิดพลาดในสถานะใดสถานะหนึ่งเหล่านี้ ระบบจะบันทึกข้อผิดพลาดไว้ในแผนภูมิรายละเอียดข้อผิดพลาดด้วย

สถานะการจัดเตรียม

  • COMMISSIONING_STARTED
  • ONBOARDING_PAYLOAD_GENERATED
  • LOCAL_DISCOVERY_SUCCESSFUL
  • PASE_CONNECTION_SUCCESSFUL
  • NOC_ADDED_SUCCESSFULLY
  • COMMISSIONING_COMPLETE

หากต้องการดูเวอร์ชันโดยละเอียดของเหตุการณ์เหล่านี้ ให้ไปที่การดำเนินการ > การบันทึก > เครื่องมือสำรวจบันทึก หากต้องการกรองข้อผิดพลาดในการให้ค่าคอมมิชชัน ให้ค้นหา "clientUpdateLog" ร่วมกับ "severity>=ERROR" ในช่องข้อความค้นหา

บันทึกข้อผิดพลาดในการใช้งานสำหรับ Matter มีลักษณะดังนี้

{
  "insertId": "1a32ry0f6xpzzn",
  "jsonPayload": {
    "clientUpdateLog": {
      "MatterUpdate": {
        "reportedProductId": 55,
        "sessionId": "1584879052892229997",
        "reportedVendorId": 4800,
        "commissioningState": "GENERIC_COMMISSIONING_ERROR",
        "status": "GENERIC_ERROR"
      }
    }
  },
  "resource": {
    "type": "assistant_action_project",
    "labels": {
      "project_id": "<project-id>"
    }
  },
  "timestamp": "2023-03-01T07:09:55.216425297Z",
  "severity": "ERROR",
  "logName": "projects/<project-id>/logs/assistant_smarthome%2Fassistant_smarthome_logs",
  "receiveTimestamp": "2023-03-01T07:09:55.216425297Z"
}

นอกจากสถานะการทำให้ใช้งานได้และรหัสสถานะแล้ว บันทึกข้อผิดพลาดยังมีการประทับเวลาสำหรับข้อผิดพลาดที่บันทึกไว้ รวมถึงรหัสผลิตภัณฑ์ Matter ที่ช่วยให้คุณระบุได้ว่าผลิตภัณฑ์ใดทำให้เกิดข้อผิดพลาด ชุดบันทึกที่สร้างขึ้นจากการพยายามมอบหมายแบบเดียวกันนี้แชร์ sessionId

การใช้เมตริกจาก Google Home Analytics จะช่วยให้คุณทราบคร่าวๆ ว่าปัญหาอาจเกิดขึ้นในระยะใด ในการหาสาเหตุของปัญหาข้อผิดพลาดในการใช้งานอุปกรณ์ บางครั้งคุณอาจต้องแก้ไขข้อบกพร่องเพิ่มเติมโดยใช้บันทึกที่สร้างโดยอุปกรณ์เคลื่อนที่ที่ใช้ในกระบวนการจัดเตรียม ซึ่งคุณต้องใช้ Android Debug Bridge

ใช้ Android Debug Bridge (ADB)

อีกวิธีหนึ่งในการแก้ปัญหาการใช้งานก็คือการใช้เครื่องมือบรรทัดคำสั่ง Android Debug Bridge (ADB) เนื่องจากการจัดเตรียมอุปกรณ์จะดำเนินการระหว่างอุปกรณ์เคลื่อนที่กับอุปกรณ์ Matter เป็นหลัก คุณจึงใช้เครื่องมือ ADB เพื่อเข้าถึงบันทึกที่แอป Google Home สร้างขึ้นตลอดการจัดเตรียมอุปกรณ์ได้

ติดตั้งเครื่องมือแพลตฟอร์ม

ADB เป็นส่วนหนึ่งของเครื่องมือแพลตฟอร์ม Android SDK ซึ่งสามารถติดตั้งได้โดยใช้ Android Studio หรือผ่านเครื่องมือบรรทัดคำสั่ง sdkmanager

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

$ adb -- version

ซึ่งควรแสดงหมายเลขเวอร์ชันของยูทิลิตี ADB ที่ติดตั้งไว้โดยไม่มีข้อผิดพลาดใดๆ

เปิดใช้การแก้ไขข้อบกพร่อง USB

ขั้นตอนถัดไปคือการเปิดใช้การแก้ไขข้อบกพร่อง USB บนอุปกรณ์ Android

ก่อนอื่น ให้ทำตามขั้นตอนเพื่อเปิดใช้ตัวเลือกสำหรับนักพัฒนาแอปในอุปกรณ์ จากนั้นเปิดใช้การแก้ไขข้อบกพร่องผ่าน USB

ซึ่งจะช่วยให้ ADB เข้าถึงบันทึกที่สร้างขึ้นโดยแอปที่ทำงานอยู่ในอุปกรณ์ได้

เรียกดูรหัสอุปกรณ์

  1. เรียกใช้เซิร์ฟเวอร์ ADB ด้วยคำสั่งต่อไปนี้
$ adb start-server
  1. เชื่อมต่อโทรศัพท์กับคอมพิวเตอร์ที่ใช้เซิร์ฟเวอร์ ADB

คุณอาจได้รับข้อความเตือนในโทรศัพท์เกี่ยวกับการแก้ไขข้อบกพร่องผ่าน USB ซึ่งจะถามว่าคุณต้องการอนุญาตให้คอมพิวเตอร์เข้าถึงข้อมูลจากโทรศัพท์หรือไม่

ข้อความแจ้งการแก้ไขข้อบกพร่องผ่าน USB

  1. หากคุณได้รับข้อความเตือนนี้ ให้คลิกอนุญาต
  2. ออกคำสั่งรายการอุปกรณ์จากเทอร์มินัลเพื่อดูว่าคอมพิวเตอร์ของคุณสามารถเข้าถึงโทรศัพท์ผ่าน ADB ได้ไหม โดยใช้คำสั่งต่อไปนี้
$ adb devices

ซึ่งควรให้คำตอบที่คล้ายกับตัวอย่างต่อไปนี้

List of devices attached
<phone-id>    device

<phone-id> คือสตริงที่เป็นตัวอักษรและตัวเลขคละกันซึ่งระบุอุปกรณ์ของคุณโดยเฉพาะ

  1. จดค่า <phone-id> ไว้เพื่อใช้ในขั้นตอนถัดไป

รวบรวมข้อมูลระบบ

ขั้นตอนถัดไปคือตรวจสอบข้อมูลเวอร์ชันของแอปและระบบในอุปกรณ์

  • วิธีตรวจสอบเวอร์ชันระบบปฏิบัติการ Android
$ adb -s <phone-id> shell getprop ro.build.version.release
  • วิธีตรวจสอบเวอร์ชันของแอป Google Home
$ adb -s <phone-id> shell dumpsys package com.google.android.apps.chromecast.app | grep versionName
  • วิธีตรวจสอบเวอร์ชันของบริการ Google Play
$ adb -s <phone-id> shell dumpsys package com.google.android.gms | grep "versionName"
  • วิธีตรวจสอบว่าคุณมีโมดูลควบคุม Home / Matter ผ่านบริการ Google Play หรือไม่
$ adb -s <phone-id> shell dumpsys activity provider com.google.android.gms.chimera.container.GmsModuleProvider | grep "com.google.android.gms.home"

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

รวบรวมบันทึกข้อผิดพลาด

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

  1. เรียกใช้คำสั่งต่อไปนี้โดยระบุ <phone-id> รวมถึง <file-name> ซึ่งจะเก็บบันทึกลงในคอมพิวเตอร์ (เช่น debug_file.txt)
$ adb -s <phone-id> logcat > <file-name>

ซึ่งจะเริ่มต้นกระบวนการบันทึกทันที ระบบจะสร้างไฟล์ที่มีชื่อที่ระบุหากยังไม่มี และเพิ่มบันทึกจากโทรศัพท์ลงในไฟล์หลังจากเหตุการณ์แต่ละรายการ

ดำเนินการตามขั้นตอนการเตรียมใช้งานกับอุปกรณ์ Matter

  1. เมื่อพบข้อผิดพลาดที่ต้องการแก้ไขข้อบกพร่อง ให้หยุดการบันทึกโดยกด Control+C ในหน้าต่างเทอร์มินัลที่ทำงานอยู่

ตอนนี้บันทึกของคุณควรจัดเก็บอยู่ในไฟล์บันทึก <file-name> เนื่องจากกระบวนการนี้จะบันทึกบันทึกจากกระบวนการที่ทำงานอยู่ทั้งหมดที่ติดตามในอุปกรณ์ จึงจะมีบันทึกจำนวนมากในไฟล์นี้ จึงควรใช้บันทึกเหล่านี้อยู่เสมอโดยค้นหารายการที่ต้องการ

วิเคราะห์บันทึกข้อผิดพลาด

กระบวนการจัดเตรียมจะดำเนินการผ่านระบบย่อยที่เรียกว่า MatterCommissioner ภายใน GHA

  1. มองหาข้อผิดพลาดที่เกิดจากระบบย่อย MatterCommissioner ด้วยคำสั่งต่อไปนี้ตามกลยุทธ์หลักที่ใช้เมื่อวิเคราะห์ข้อผิดพลาดในการจัดเตรียม
$ grep "MatterCommissioner" <file-name>

ซึ่งจะสร้างเอาต์พุตที่มีเหตุการณ์จากกระบวนการจัดเตรียม

  1. หากอุปกรณ์ Matter ใช้เทรด คุณยังค้นหาข้อผิดพลาดที่ระบบย่อยเทรดสร้างขึ้นได้ด้วยคำสั่งต่อไปนี้
$ grep -E "(ThreadNetworkManager|BorderAgentScannerImpl|ThreadBrSynchronizer)" <file-name>

เมื่อวิเคราะห์ไฟล์บันทึกที่สร้างขึ้นจากกระบวนการแก้ไขข้อบกพร่อง ADB ให้มองหารูปแบบบางอย่างด้วย ข้อผิดพลาดในการเปิดใช้งานจำนวนมากจะมีสตริง "commissioning failure" ในข้อความแสดงข้อผิดพลาด

  1. ค้นหาข้อความแจ้งความล้มเหลวในการเตรียมใช้งานด้วยคําสั่งต่อไปนี้
$ grep "SetupDevice" $phonelog | grep -A 20 "Commissioning failed"

4. แก้ไขข้อบกพร่องเกี่ยวกับการควบคุมอุปกรณ์

เมื่อผู้ใช้ตั้งค่าและจัดเตรียมอุปกรณ์ Matter ไว้ในระบบนิเวศของ Google Home แล้ว ก็จะออกคำสั่งผ่านเสียงได้โดยใช้ Google Assistant (เช่น "Ok Google เปิดไฟในห้องนั่งเล่น") หรือใช้ UI ในแอป Home หรืออุปกรณ์จอแสดงผล Google Nest

เนื่องจากข้อกำหนดการควบคุมระหว่างอุปกรณ์ปลายทางและ Google Hub ได้รับสื่อกลางโดย Matter จึงคาดว่าจะมีข้อผิดพลาดน้อยกว่าในฝั่งการควบคุมอุปกรณ์ อย่างไรก็ตาม เรามีเมตริกและบันทึกให้คุณแก้ไขข้อบกพร่องประเภทเหล่านี้ด้วย

ใช้เมตริก

ในแดชบอร์ดการผสานรวม Matter คุณจะเห็นเมตริกหลายรายการเกี่ยวกับการควบคุมอุปกรณ์ แผนภูมิ 3 รายการสําคัญสําหรับการประเมินประสิทธิภาพของอุปกรณ์ในพื้นที่มีดังนี้

แผนภูมิรายละเอียดความสําเร็จ เวลาในการตอบสนอง และข้อผิดพลาด

ในช่วงที่มีปัญหาเกี่ยวกับการควบคุม คุณมักจะเห็นแนวโน้มที่ลดลงของเปอร์เซ็นต์ความสําเร็จและแนวโน้มที่เพิ่มขึ้นของแผนภูมิรายละเอียดข้อผิดพลาด แผนภูมิรายละเอียดข้อผิดพลาดจะแสดงข้อผิดพลาดที่ Google Nest Hub บันทึกไว้เกี่ยวกับสาเหตุที่การควบคุมอุปกรณ์ไม่สำเร็จ

ใช้บันทึก

ปัญหาระบบควบคุมอุปกรณ์ Matter แต่ละรายการจะสร้างบันทึกข้อผิดพลาดในระบบด้วย คุณกรองข้อผิดพลาดเหล่านี้ออกจาก Logs Explorer ได้โดยค้นหา "executionLog"

บันทึกข้อผิดพลาดในการควบคุมอุปกรณ์ Matter จะมีลักษณะดังต่อไปนี้

{
  "insertId": "1a32ry0f6xpzzn",
  "jsonPayload": {
    "executionLog": {
      "executionResults": [
        {
          "executionType": "MATTER",
          "latencyMsec": "6000",
          "actionResults": [
            {
              "action": {
                "actionType": "ONOFF_OFF",
                "trait": "TRAIT_ON_OFF"
              },
              "status": {
                "externalDebugString": "No message was received before the deadline.",
                "statusType": "RESPONSE_TIMEOUT",
                "fallbackToCloud": false,
                "isSuccess": false
              },
              "device": {
                "deviceType": "OUTLET"
              }
            }
          ],
          "requestId": "1487232799486580805"
        }
      ]
    },
    "locale": "en-US"
  },
  "resource": {
    "type": "assistant_action_project",
    "labels": {
      "project_id": "<project-id>"
    }
  },
  "timestamp": "2023-03-01T15:47:27.311673018Z",
  "severity": "ERROR",
  "logName": "projects/<project-id>/logs/assistant_smarthome%2Fassistant_smarthome_logs",
  "receiveTimestamp": "2023-03-01T15:47:27.311673018Z"
}

บันทึกข้อผิดพลาดแต่ละรายการจะมีการประทับเวลา ประเภทอุปกรณ์ และลักษณะ รวมถึงข้อผิดพลาดที่เชื่อมโยงกับคําขอควบคุมใน statusType ข้อผิดพลาดด้านการควบคุมหลายรายการจะมี externalDebugString ซึ่งเป็นข้อความแสดงข้อผิดพลาดสั้นๆ ที่อธิบายว่าข้อผิดพลาดเกี่ยวกับอะไร

5. แก้ไขข้อบกพร่องของฟีเจอร์อื่นๆ

จนถึงตอนนี้คุณได้เรียนรู้วิธีจัดการปัญหาเกี่ยวกับการเตรียมอุปกรณ์ให้พร้อมใช้งานและการควบคุมสำหรับ Matter แล้ว นอกจากนี้ ระบบนิเวศยังมีฟีเจอร์อื่นๆ ที่คุณสามารถใช้เทคนิคที่เราแนะนำเพื่อให้การผสานรวมมีคุณภาพดี

ติดตามการอัปเดต OTA

เรามีชุดเมตริกที่แสดงเวอร์ชันฮาร์ดแวร์และซอฟต์แวร์ของอุปกรณ์ที่ใช้งานจริงเพื่อติดตามรุ่นของการอัปเดตแบบ OTA (Over-the-air) สำหรับอุปกรณ์ Matter ที่ Google Home เป็นผู้เผยแพร่

เมื่อคุณออกการอัปเดตจากคอนโซลแล้ว ให้ติดตามเมตริกต่อไปนี้

รายละเอียดซอฟต์แวร์และฮาร์ดแวร์

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

6. ขอความช่วยเหลือ

Google มีเครื่องมือและเอกสารประกอบสำหรับแก้ไขข้อบกพร่องเกี่ยวกับ Matter แต่เนื่องจากระบบนิเวศ Matter เป็นเรื่องใหม่ จึงจะมีปัญหาที่ทรัพยากรเหล่านี้ไม่ครอบคลุม ในกรณีเหล่านี้ คุณสามารถติดต่อเราหรือชุมชนเพื่อขอรับการสนับสนุนได้ทุกเมื่อ

ไปที่ช่องของนักพัฒนาแอป

ช่องนักพัฒนาแอป 3 ช่องที่ Google ตรวจสอบอยู่อย่างต่อเนื่องมีดังนี้

Stack Overflow, เครื่องมือติดตามปัญหา, ฟอรัมนักพัฒนาซอฟต์แวร์

แม้ว่าทีมเดียวกันจะเป็นผู้ตรวจสอบช่องทางเหล่านี้เป็นระยะๆ แต่ก็มีความแตกต่างที่สำคัญบางอย่างเกี่ยวกับเวลาในการใช้ช่องทางใดช่องทางหนึ่ง

  • Stack Overflow: โปรดติดต่อเราและชุมชนนักพัฒนาแอปสมาร์ทโฮมหากมีคำถามเกี่ยวกับการใช้งานหรือหากต้องการคำแนะนำ ช่องทางนี้เหมาะสำหรับการขอวิธีแก้ปัญหาหรือใช้ฟีเจอร์บางอย่าง
  • เครื่องมือติดตามข้อบกพร่อง: เป็นระบบเครื่องมือติดตามข้อบกพร่องอย่างเป็นทางการที่ Google เป็นผู้ดำเนินการ ซึ่งผู้ใช้ภายนอกสามารถรายงานข้อผิดพลาดในระบบนิเวศได้ โดยจะมีเครื่องมือบนเว็บสำหรับแนบไฟล์และแชร์ข้อมูลที่ละเอียดอ่อนเมื่อจำเป็น การใช้เครื่องมือติดตามปัญหาเหมาะสําหรับการรายงานปัญหาเกี่ยวกับระบบนิเวศหรือการแชร์คําขอฟีเจอร์
  • ฟอรัมนักพัฒนาซอฟต์แวร์: หากต้องการขอคำแนะนำจากทีมสนับสนุนอย่างเป็นทางการและผู้เชี่ยวชาญในชุมชนของ Google คุณสามารถติดต่อผ่านฟอรัมนักพัฒนาซอฟต์แวร์ Nest ฟอรัมนี้เหมาะสําหรับรับคําแนะนําอย่างเป็นทางการสําหรับการพัฒนา

ลงชื่อสมัครรับจดหมายข่าวสำหรับนักพัฒนาแอป

นอกจากการเข้าชมช่องทางสำหรับนักพัฒนาแอปเพื่อถามคำถามแล้ว เรายังเผยแพร่จดหมายข่าวรายไตรมาสที่ไฮไลต์ฟีเจอร์ใหม่และข่าวสารเกี่ยวกับสถานะของระบบนิเวศสมาร์ทโฮมของ Google ด้วย

คุณสามารถใช้แบบฟอร์มลงชื่อสมัครใช้เพื่อรับจดหมายข่าวสำหรับนักพัฒนาแอป

7. ขอแสดงความยินดี

Google Home

ยินดีด้วย คุณได้เรียนรู้วิธีแก้ไขข้อบกพร่องในการผสานรวม Matter โดยใช้เครื่องมือและเทคนิคที่เราแนะนำเรียบร้อยแล้ว ขอให้คุณมีความสุขในการสร้างการผสานรวม Matter กับ Google Home

ขั้นตอนถัดไป

ลองทำแบบฝึกหัดต่อไปนี้และสำรวจแหล่งข้อมูลเพิ่มเติม

  • นอกจากการใช้ข้อมูลวิเคราะห์เพื่อแก้ปัญหาแล้ว คุณยังใช้ Test Suite เพื่อทดสอบการผสานรวมกับปัญหาที่อาจเกิดขึ้นได้อีกด้วย
  • เมื่อการผสานรวมพร้อมที่จะแชร์กับโลกแล้ว ขั้นตอนต่อไปคือการทำให้โปรเจ็กต์ของคุณได้รับการรับรอง WWGH โดยคุณทำตามขั้นตอนในหน้าการรับรองได้