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