Kể từ năm 2026, mọi hoạt động kiểm thử và tích hợp Matter đều sẽ yêu cầu Kiểm thử khả năng tương tác của Liên minh. Để biết thêm thông tin, hãy xem trang chuyển đổi Phòng thử nghiệm khả năng tương tác của Liên minh.

Google sử dụng công nghệ AI để dịch nội dung sang ngôn ngữ bạn ưu tiên. Bản dịch bằng AI có thể có lỗi.

Khắc phục vấn đề

Tòa nhà

Xác minh rằng điện thoại của bạn tương thích

Tất cả thiết bị Android O (8.1, cấp độ API 27) trở lên đều tương thích với Matter. Hãy làm theo các bước dưới đây để kiểm tra xem điện thoại của bạn có các mô-đun cần thiết hay không.

Thiết lập Cầu gỡ lỗi Android

Bạn nên thiết lập Cầu gỡ lỗi Android (adb) trước khi khắc phục sự cố. Cách thiết lập:

Cài đặt "adb" trên máy tính.
Bật Tuỳ chọn cho nhà phát triển và Gỡ lỗi qua USB trên điện thoại Android.

Xác minh các mô-đun Matter của Dịch vụ Google Play (GPS)

Để kiểm tra xem bạn có các mô-đun Google Play services Matter hay không, hãy làm như sau:

Thiết lập Cầu gỡ lỗi Android.
Dùng cáp USB để kết nối điện thoại Android với máy tính.
Chạy lệnh này trong dòng lệnh để xác minh rằng các mô-đun Matter cần thiết đã được cài đặt:
```
  adb shell dumpsys activity provider com.google.android.gms.chimera.container.GmsModuleProvider | grep "com.google.android.gms.home"
  
```
Nếu thấy kết quả tương tự như bên dưới, tức là bạn đã cài đặt các mô-đun Matter:
```
com.google.android.gms.home [v222110900]
```
Xin lưu ý rằng số phiên bản ở trên có thể khác với số phiên bản trên thiết bị của bạn.
Chạy lệnh này trong dòng lệnh để xác minh rằng các mô-đun Thread cần thiết đã được cài đặt:
```
  adb shell dumpsys activity provider com.google.android.gms.chimera.container.GmsModuleProvider | grep "com.google.android.gms.threadnetwork"
  
```
Nếu thấy kết quả tương tự như trong ví dụ sau, thì tức là bạn đã cài đặt các mô-đun Thread:
```
com.google.android.gms.threadnetwork [v222106301]
```
Xin lưu ý rằng số phiên bản trên thiết bị của bạn có thể khác.

Nếu các mô-đun không có trong danh sách, thì có nghĩa là:

Bạn đang dùng phiên bản Android đã lỗi thời. Đảm bảo thiết bị chạy hệ điều hành Android O (8.1) trở lên.
Các mô-đun Matter chưa được tải xuống. Hãy đợi ít nhất 24 giờ để các bản ghi được tải xuống. Đảm bảo thiết bị của bạn đang bật nguồn và đang sạc trong thời gian này để quá trình tải xuống không bị trì hoãn. Nếu chưa nhận được các mô-đun trong vòng 24 giờ, bạn có thể thử đặt lại thiết bị về trạng thái ban đầu để buộc tải các mô-đun xuống.

Xác minh VID/PID của thiết bị

Nếu muốn bắt đầu phát triển quy trình tích hợp với Google, bạn phải tạo một dự án và một quy trình tích hợp trên Google Home Console.

Khắc phục sự cố về Trình theo dõi Bluetooth

Giá trị VID/PID mà thiết bị của bạn đang phát tín hiệu phải khớp với VID/PID được nhập vào dự án Google Home Developer Console của bạn.

VID 0xFFF1 — 0xFFF4 được dành riêng cho việc thử nghiệm. Bạn có thể dùng các thiết bị này cho các thử nghiệm cơ bản về việc chạy thử và điều khiển, nhưng không thể dùng trong các giai đoạn phát triển sau:

Khi sử dụng một ứng dụng kỹ thuật Bluetooth như nRF Connect for Mobile, bạn có thể thấy VID/PID của thiết bị phát tín hiệu trong trường Dữ liệu dịch vụ.

Trong ảnh chụp màn hình này từ phiên bản Android của nRF Connect, bạn sẽ thấy VID/PID được liệt kê là 5A23FFFE bắt đầu từ byte thứ tư của trường Dữ liệu dịch vụ. Điều này cho biết VID là 5A23 và PID là FFFE — cả hai đều ở định dạng little endian.

Ứng dụng BLE hiển thị các giá trị theo thứ tự byte cuối, nhưng các giá trị VID/PID mà bạn nhập vào dự án Developer Console của mình lại theo thứ tự byte đầu.

Xác thực rằng bạn đã nhập đúng giá trị và định dạng vào dự án của mình trên Bảng điều khiển Actions dựa trên những gì trình theo dõi Bluetooth đang hiển thị.

Đối với các giá trị trong ảnh chụp màn hình ví dụ, VID và PID trong Developer Console sẽ lần lượt là 235A và FEFF.

Lưu ý: Bạn không nên sử dụng VID của 235A trong dự án của mình nữa. VID này chỉ được dùng ở đây cho mục đích minh hoạ. Đảm bảo rằng bạn đang sử dụng VID theo Thông số kỹ thuật Matter hoặc một trong các VID thử nghiệm như đã lưu ý trên trang Tạo một chế độ tích hợp Matter.

Xác minh rằng thiết bị của bạn được xây dựng bằng một nhánh SDK Matter tương thích

Các trung tâm Google Matter tương thích với Matter 1.0 và đã được thử nghiệm với các bản dựng sử dụng các thay đổi từ nhánh ổn định v1.0-branch. Hãy xem Ghi chú phát hành công khai để biết các thay đổi cụ thể được đề xuất sử dụng với mỗi bản phát hành trung tâm mới.

Tính năng ghép nối

Xác minh thông tin đăng nhập cho thiết bị của bạn

Khi bạn sử dụng VID do Alliance chỉ định, hãy đảm bảo rằng bạn có thông tin xác thực chính xác trên thiết bị:

Tuyên bố chứng nhận (CD).
Chứng chỉ chứng thực thiết bị (DAC) và chuỗi chứng chỉ của chứng chỉ này.

Để biết thêm thông tin, hãy xem phần Tạo chứng chỉ kiểm thử thiết bị Matter.

Xác minh Trung tâm điều khiển tương thích với Matter

Trung tâm Matter của bạn phải là một trong các trung tâm được Google hỗ trợ. Thiết bị cũng phải có một bản dựng tương thích với Matter.

Một số trung tâm cũng là Thread Border Router (TBR) và do đó cho phép bạn phát triển và thử nghiệm các thiết bị Thread. Các trung tâm khác chỉ hỗ trợ thiết bị Matter dùng Wi-Fi và Ethernet, trừ phi bạn có một border router khác trong mạng để bật kết nối Thread.

Bạn có thể xác minh bản dựng của trung tâm bằng cách: Trượt ngón tay xuống từ cạnh trên cùng > Bánh xe cấu hình > Thông tin thiết bị > Thông tin kỹ thuật > Phiên bản chương trình cơ sở của Chromecast

Không thể uỷ quyền và có thông báo lỗi "Không thể liên hệ với Google"

Đảm bảo rằng bạn đã tạo một chế độ tích hợp với tổ hợp VID/PID chính xác trong Developer Console. Hãy xem bài viết Tạo một công cụ tích hợp Matter để biết thêm thông tin.

Không thể uỷ quyền kèm theo thông báo lỗi "Không kết nối được với thiết bị"

Nếu bạn liên tục nhận được thông báo lỗi "Không kết nối được với thiết bị" khi uỷ quyền cho một thiết bị Thread và đã thử mọi lựa chọn gỡ lỗi hiện có, thì bạn nên xoá thông tin đăng nhập Thread ưu tiên được lưu trữ trên điện thoại Android để thiết lập mới thông qua Cài đặt > Ứng dụng > Ứng dụng > Dịch vụ Google Play > Bộ nhớ và bộ nhớ đệm > Quản lý dung lượng > XOÁ TẤT CẢ DỮ LIỆU.

Thử nghiệm

Thiết bị được uỷ quyền không xuất hiện trong Bộ kiểm thử

Nếu bạn đã ghép nối một thiết bị với Mã nhà cung cấp (VID) và Mã sản phẩm (PID) thử nghiệm, nhưng thiết bị đó không xuất hiện khi bạn cố gắng kiểm thử thiết bị bằng Bộ kiểm thử trong Developer Console, thì có thể là do bạn sử dụng cùng một tổ hợp VID và PID thử nghiệm trên nhiều chế độ tích hợp.

Để khắc phục sự cố, hãy xoá tất cả thiết bị thử nghiệm khỏi Developer Console rồi ghép nối lại thiết bị mà bạn muốn thử nghiệm.

Để xác thực rằng bạn đã ghép nối đúng thiết bị, bạn có thể đặt thông tin Nhà sản xuất và Kiểu máy (giá trị CHIP_DEVICE_CONFIG_DEVICE_*) cho thiết bị thành các giá trị riêng biệt trong chương trình cơ sở thử nghiệm.

Hãy xem phần Thông tin thiết bị để biết thêm thông tin.

Nếu vẫn xảy ra sự cố

Nếu bạn đã làm theo tất cả các bước khắc phục sự cố tại đây nhưng vẫn chưa giải quyết được vấn đề, đừng lo!

Trong các bước khắc phục sự cố, bạn đã thu thập dữ liệu quan trọng về thiết bị, dự án trên bảng điều khiển và môi trường của mình. Sau khi có dữ liệu đó, hãy xem Trang hỗ trợ để biết cách chia sẻ vấn đề của bạn một cách hiệu quả nhất với cộng đồng và nhóm hỗ trợ Google Home.