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

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

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

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

การจัดสรร การดำเนินการ การอัปเดต OTA

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

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

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

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

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

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

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

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

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

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

แดชบอร์ดข้อมูลวิเคราะห์ของ Google Home

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

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

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

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

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

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

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

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

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

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

3. แก้ไขข้อบกพร่องเกี่ยวกับการเปิดใช้งาน

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

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

เหตุการณ์การจัดสรร Matter

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

ใช้ข้อมูลวิเคราะห์ของ 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 จะช่วยให้คุณทราบเบื้องต้นว่าปัญหาอาจเกิดขึ้นในขั้นตอนใด หากต้องการหาสาเหตุที่แท้จริงของข้อผิดพลาดในการจัดสรรอุปกรณ์ บางครั้งคุณอาจต้องทำการแก้ไขข้อบกพร่องเพิ่มเติมโดยใช้บันทึกที่สร้างขึ้นจากอุปกรณ์เคลื่อนที่ที่ใช้ในกระบวนการจัดสรร สำหรับอุปกรณ์เหล่านี้ คุณต้องใช้ 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. ออกคำสั่ง list devices จากเทอร์มินัลเพื่อดูว่าคอมพิวเตอร์เข้าถึงโทรศัพท์ผ่าน 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"
  • วิธีตรวจสอบว่าคุณมีโมดูลควบคุมบ้าน / Matter ผ่าน Play Services หรือไม่
$ 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 ใช้ Thread คุณยังดูข้อผิดพลาดที่เกิดจากระบบย่อยของ Thread ได้ด้วยคำสั่งต่อไปนี้
$ 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 ได้

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

ใช้เมตริก

ในแดชบอร์ดการผสานรวม 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) สำหรับอุปกรณ์ Matter ที่ออกโดย Google Home เรามีชุดเมตริกที่แสดงเวอร์ชันฮาร์ดแวร์และซอฟต์แวร์สำหรับอุปกรณ์ที่ใช้งานจริง

เมื่อเผยแพร่การอัปเดตจากคอนโซลแล้ว ให้จับตาดูเมตริกต่อไปนี้

ซอฟต์แวร์และฮาร์ดแวร์หยุดทำงาน

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

6. ขอรับการสนับสนุน

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

ไปที่ช่องสำหรับนักพัฒนาแอป

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

Stack Overflow, Issue Tracker, ฟอรัมสำหรับนักพัฒนาซอฟต์แวร์

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

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

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

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

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

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

Google Home

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

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

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

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