Google Home Sample App for Matter sử dụng Google Home Mobile SDK để tạo một ứng dụng Android tương tự như Google Home app (GHA). Ứng dụng mẫu này cung cấp các tính năng sau:
- Ủy quyền các thiết bị Matter ảo và thực cho vải Android cục bộ
- Đưa các thiết bị thực và ảo vào một môi trường phát triển
- Điều khiển thiết bị trên vải phát triển, chẳng hạn như bật đèn
- Các tính năng đa quản trị cho phép bạn chia sẻ các thiết bị trong quá trình phát triển với các ứng dụng khác và ngược lại có thể được đưa vào thiết bị phát triển được chia sẻ từ các ứng dụng khác
- Tiện ích nhà phát triển
Hướng dẫn này mô tả cách cài đặt APK Sample App for Matter và sử dụng APK này để ủy quyền, kiểm soát và chia sẻ các thiết bị Matter.
Để tải mã nguồn xuống, hãy tìm hiểu cách tích hợp Mobile SDK và tuỳ chỉnh màn hình trong Android Studio, hãy thử tham gia lớp học lập trình Sample App for Matter của chúng tôi.
Truy cập lớp học lập trình Sample App for Matter
Điều kiện tiên quyết
- Một thiết bị Android O (8.1, API cấp 27) trở lên có sẵn để thử nghiệm. Để đảm bảo rằng thiết bị của bạn có Matter hỗ trợ mới nhất, hãy xem lại hướng dẫn Xác minh Matter Mô-đun và dịch vụ.
- Xây dựng thiết bị Matter có khả năng Bật/Tắt. Ứng dụng mẫu này hoạt động với thiết bị ảo và ESP32.
- Tạo một Thiết bị ảo Matter bằng ứng dụng
rootnode_dimmablelight_bCwGYSDpoe. Khi bạn tạo một công cụ tích hợp Matter trong Google Home Developer Console, hãy sử dụng0xFFF1làm mã nhà cung cấp và0x8000làm Mã sản phẩm. - Tạo thiết bị Espressif bằng
all-clusters-app. Khi Tạo cấu hình tích hợp Matter trong Developer Console, hãy sử dụng0xFFF1làm Mã nhà cung cấp và0x8001làm Mã sản phẩm.
- Tạo một Thiết bị ảo Matter bằng ứng dụng
Bạn không cần một trung tâm, chẳng hạn như Google Nest Hub (2nd gen), để ủy quyền và điều khiển các thiết bị bằng Sample App for Matter.
Cài đặt
Chuyển đến phần Bản phát hành trong kho lưu trữ GitHub Sample App for Matter. Tìm tệp APK có tên
GHSAFM-1.4.1-default-debug.apk. Đừng chọntargetcommissioner:Cài đặt Cầu gỡ lỗi Android (adb):
Kết nối thiết bị Android của bạn với USB và bật tính năng Truyền tệp, sau đó cài đặt APK:
$ adb unroot && adb install GHSAFM-1.4.1-default-debug.apk
Thiết bị có phí hoa hồng
Khi khởi chạy ứng dụng mẫu lần đầu tiên, bạn sẽ nhận được một hộp thoại có đường liên kết đến lớp học lập trình Sample App for Matter. Nếu chọn Không hiển thị thông báo này nữa, bạn có thể khôi phục hộp thoại bất kỳ lúc nào bằng cách cập nhật các lựa chọn ưu tiên trong phần Quản trị của ứng dụng.
Trong các bước tiếp theo, bạn sẽ thêm thiết bị Matter vào kết cấu Android cục bộ, cùng với một mẫu phát triển cục bộ chỉ có trong ứng dụng mẫu.
Vải Matter là gì?
Vải Matter là một miền chung tin cậy giữa các thiết bị trong mạng gia đình, cho phép các thiết bị này giao tiếp với nhau.
Các thiết bị có thể có một hoặc nhiều kết cấu tương ứng với một nền tảng, ứng dụng hoặc nhóm thiết bị tương tác với nhau. Các loại vải có mã nhận dạng duy nhất và các thiết bị có cùng bộ thông tin xác thực và tổ chức phát hành chứng chỉ (CA). Các thông tin đăng nhập này được chỉ định trong quá trình ủy quyền Matter.
Để đưa vào thiết bị Matter, hãy hoàn tất các bước sau:
Nhấn vào nút Thêm thiết bị để bắt đầu quy trình ủy quyền.
Tiếp theo, quyền kiểm soát được chuyển sang Google Play services, được khởi chạy từ lệnh gọi đến Mobile SDK. Để thiết lập bằng chứng về quyền sở hữu, hãy Quét mã QR hoặc nhấn vào Sử dụng mã ghép nối.
Khi hoàn tất quá trình ủy quyền, hãy nhập Tên thiết bị, sau đó nhấn vào Xong.
Thiết bị của bạn hiện đã kết nối với cả ứng dụng vải Android trên thiết bị và thiết bị phát triển ứng dụng.
Tất cả công việc chạy thử và màn hình liên kết đều do Play services xử lý khi vận hành thiết bị. Điều này cung cấp trải nghiệm người dùng nhất quán và loại bỏ nhu cầu xử lý các quyền nhạy cảm, ví dụ như thông tin đăng nhập qua Wi-Fi và luồng.
Điều khiển thiết bị
Canvas phát triển tạo thông tin xác thực để kiểm soát các thiết bị Matter ngay từ ứng dụng mẫu.
Từ Màn hình chính, bạn có thể Bật hoặc Tắt thiết bị. Nhấn vào thiết bị để truy cập thông tin chi tiết về thiết bị.
Chia sẻ thiết bị
Việc chia sẻ thiết bị được gọi là luồng đa quản trị trong thông số Matter. Sau khi một thiết bị được đưa vào ứng dụng mẫu, bạn có thể dễ dàng chia sẻ thiết bị đó với các hệ sinh thái khác.
Để chia sẻ thiết bị Matter với các hệ sinh thái khác, bạn cần cài đặt một nền tảng khác trên thiết bị Android. Nền tảng bên ngoài này sẽ trở thành uỷ viên mục tiêu. Chúng tôi đã tạo một bản sao khác của ứng dụng mẫu mà bạn có thể sử dụng làm ủy viên mục tiêu.
Chuyển đến phần Bản phát hành trong kho lưu trữ GitHub Sample App for Matter. Tìm tệp APK mới nhất có tên
GHSAFM-[version]-targetcommissioner, ví dụ:GHSAFM-1.4.1-targetcommissioner-debug.apk:Cài đặt ủy viên mục tiêu.
$ adb unroot && adb install GHSAFM-1.4.1-targetcommissioner-debug.apkTừ Màn hình chính, hãy nhấn vào thiết bị để hiển thị thông tin thiết bị. Nhấn vào Chia sẻ.
Ứng dụng mẫu gọi API Chia sẻ Mobile SDK và một lần nữa, quyền kiểm soát sẽ được chuyển sang Play services.
Trang chia sẻ hiển thị, cho phép bạn chọn ứng dụng hoặc nền tảng mà bạn muốn ghép nối thiết bị. Màn hình này cung cấp hai cách để bạn chia sẻ thiết bị:
- Thông qua mã thiết lập theo cách thủ công để chia sẻ với ứng dụng ủy quyền mục tiêu
- Với một ứng dụng Android cục bộ đã đăng ký với tư cách là ủy viên Matter
Ứng dụng ủy viên mục tiêu được gắn nhãn GHSAFM-TC. Nhấn vào bản sao này của ứng dụng mẫu để chia sẻ thiết bị của bạn.
Tiếp theo, ứng dụng bên ngoài (Ủy viên đích) sẽ hoàn thành việc vận hành thiết bị vào kết cấu riêng.
Cài đặt
Trên Màn hình chính, hãy nhấp vào biểu tượng cài đặt . Tại đây, bạn có các lựa chọn cập nhật lựa chọn ưu tiên của người dùng, yêu cầu trợ giúp và tìm hiểu thêm về ứng dụng.
Thông báo Halfsheet
Trên màn hình Cài đặt, bạn có thể chọn tắt thông báo phát hiện có phí hoa hồng chủ động cho Matter thiết bị.
Nếu ứng dụng của bạn cung cấp quy trình phát hiện hoặc hành trình Matter riêng, thì bạn nên chặn các thông báo này để ngăn chặn tình trạng gián đoạn. Hãy xem bài viết Chặn các thông báo về phí hoa hồng có thể phát hiện để biết thêm thông tin.
Tiện ích nhà phát triển
Từ màn hình Cài đặt, bạn cũng có thể truy cập Tiện ích nhà phát triển.
Để xem lại nội dung của vị trí lưu trữ DataStore Tuỳ chọn người dùng và Thiết bị trong Logcat, hãy hoàn tất các bước sau:
Nhấp vào Ghi nhật ký nội dung kho lưu trữ.
Nhấp vào OK, sau đó chọn Logcat.
Phản hồi và trợ giúp
Để gửi ý kiến hoặc phản hồi của bạn về cách chúng tôi có thể cải thiện trải nghiệm phát triển với Sample App for Matter, hãy hoàn thành Biểu mẫu phản hồi.
Gửi ý kiến phản hồi cho chúng tôi
Nếu bạn gặp sự cố với Sample App for Matter, hãy thử hoàn tất các bước để xác minh môi trường:
Nếu có thắc mắc về việc sử dụng ứng dụng mẫu hoặc phát hiện lỗi mã, bạn có thể gửi vấn đề đến Công cụ theo dõi lỗi trong kho lưu trữ GitHub:
Để nhận hướng dẫn chính thức từ Google về các câu hỏi kỹ thuật, hãy sử dụng Diễn đàn nhà thông minh dành cho nhà phát triển:
Để được cộng đồng hỗ trợ kỹ thuật, hãy sử dụng thẻ google-smart-home trên Stack Overflow: