Ứng dụng mẫu Google Home quan trọng

Ứng dụng mẫu Google Home cho Matter

Google Home Sample App for Matter 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:

  • Thiết lập các thiết bị Matter thực và ảo cho Local Android fabric
  • Uỷ quyền cho các thiết bị thực và ảo vào một cấu trúc phát triển
  • Điều khiển các thiết bị trên nền tảng phát triển của bạn, chẳng hạn như bật đèn
  • Các tính năng dành cho nhiều quản trị viên cho phép bạn chia sẻ thiết bị trên nền tảng phát triển với các ứng dụng khác và ngược lại, bạn có thể đưa các thiết bị được chia sẻ từ các ứng dụng khác vào nền tảng phát triển
  • 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 để thiết lập, điều khiển 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 màn hình trong Android Studio, hãy thử lớp học lập trình Sample App for Matter của chúng tôi.

Chuyển đến Sample App for Matter lớp học lập trình

Điều kiện tiên quyết

Bạn không cần thiết bị trung tâm (ví dụ: Google Nest Hub (2nd gen)) để thiết lập và điều khiển các thiết bị bằng Sample App for Matter.

Cài đặt

  1. Chuyển đến phần Bản phát hành trong kho lưu trữ Sample App for Matter GitHub. Đối với bản phát hành gần đây nhất, hãy tìm trong phần Tài sản tệp APK có tên GHSAFM-version-default-debug.apk. Đừng chọn targetcommissioner.

  2. Cài đặt Cầu gỡ lỗi Android (adb):

    Cài đặt adb

  3. Kết nối thiết bị Android bằng USB và bật chế độ Truyền tệp, sau đó cài đặt APK:

    $ adb unroot && adb install GHSAFM-version-default-debug.apk

Uỷ quyền thiết bị

Khi chạy ứng dụng mẫu lần đầu tiên, bạn sẽ thấy 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ị lại thông báo này, bạn có thể đưa hộp thoại này trở lại bất cứ lúc nào bằng cách cập nhật lựa chọn ưu tiên của mình 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 cấu trúc Android cục bộ, cùng với một cấu trúc phát triển chỉ dành riêng cho ứng dụng mẫu.

Vải Matter là gì?

Ứng dụng mẫu Google Home cho Matter

Matter là một miền tin cậy dùng 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.

Các thiết bị có thể có một hoặc nhiều fabric 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 cấu trúc có một mã nhận dạng duy nhất và các thiết bị dùng chung cùng một bộ thông tin đăng nhập và tổ chức phát hành chứng chỉ (CA). Thông tin xác thực này được chỉ định trong quá trình thiết lập Matter.

Để thiết lập thiết bị Matter, hãy hoàn tất các bước sau:

  1. Nhấn vào nút Thêm thiết bị để bắt đầu quy trình thiết lập.

    Thêm thiết bị

  2. Tiếp theo, quyền kiểm soát sẽ được chuyển sang Google Play services, được khởi chạy từ một lệnh gọi đến Mobile SDK. Để xác minh quyền sở hữu, hãy Quét mã QR hoặc nhấn vào Dùng mã ghép nối.

    Quét mã QR

  3. Khi quá trình thiết lập 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 đã kết nối với cả Local Android fabric và development fabric.

Tất cả công việc thiết lập và các màn hình liên quan đều do Play services xử lý khi thiết lập thiết bị. Điều này mang lại trải nghiệm nhất quán cho người dùng và loại bỏ nhu cầu 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ị

Cấu trúc 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.

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ị để xem thông tin chi tiết về thiết bị.

Đã thêm thiết bị

Chia sẻ thiết bị

Việc chia sẻ thiết bị được gọi là quy trình nhiều quản trị viên trong quy cách Matter. Sau khi thiết bị được đưa vào hoạt động trong ứ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 của mình. Nền tảng bên ngoài này sẽ trở thành đơn vị uỷ quyề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ể dùng làm bên uỷ quyền mục tiêu.

  1. Chuyển đến phần Bản phát hành trong kho lưu trữ Sample App for Matter GitHub. Đối với bản phát hành gần đây nhất, hãy tìm trong phần Tài sản tệp APK có tên GHSAFM-version-targetcommissioner-debug.apk. Đừng chọn default.

  2. Cài đặt người uỷ thác mục tiêu.

    $ adb unroot && adb install GHSAFM-version-targetcommissioner-debug.apk

  3. Trên màn hình chính, hãy nhấn vào thiết bị để xem thông tin về thiết bị. Nhấn vào Chia sẻ.

    Chia sẻ thiết bị

Ứng dụng mẫu gọi Share API Mobile SDK và một lần nữa, quyền kiểm soát được chuyển sang Play services.

Một bảng 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 cho bạn 2 cách để chia sẻ thiết bị:

  1. Theo cách thủ công thông qua mã thiết lập để chia sẻ với ứng dụng uỷ viên mục tiêu
  2. Với một ứng dụng Android cục bộ đã đăng ký làm người uỷ quyền Matter

Ứng dụng của uỷ viên mục tiêu được gắn nhãn GHSAFM-TC. Nhấn vào phiên bản 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 (đơn vị uỷ quyền mục tiêu) hoàn tất quá trình uỷ quyền thiết bị vào mạng lưới của riêng mình.

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ó thể 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.

Cài đặt

Thông báo trên tờ giấy nửa trang

Trên màn hình Cài đặt, bạn có thể chọn tắt thông báo chủ động về nội dung có thể mang lại 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 thiết lập Matter riêng, bạn có thể muốn chặn các thông báo này để tránh bị gián đoạn. Hãy xem phần Ngăn chặn thông báo về nội dung khám phá có thể tính phí hoa hồng để 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 cho nhà phát triển.

Để xem nội dung của các kho lưu trữ Device và User Preferences DataStore trong Logcat, hãy hoàn tất các bước sau:

  1. Nhấp vào Ghi nhật ký nội dung kho lưu trữ.

  2. Nhấp vào OK trong hộp thoại, sau đó kiểm tra Logcat.

Phản hồi và trợ giúp

Để gửi ý kiến hoặc 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 bằng Sample App for Matter, hãy hoàn tất 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 vấn đề với Sample App for Matter, hãy thử hoàn tất các bước xác minh môi trường của bạn:

Nếu có thắc mắc về cách sử dụng ứng dụng mẫu hoặc phát hiện thấy 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 sử dụng Diễn đàn nhà phát triển nhà thông minh:

Để nhận được sự hỗ trợ kỹ thuật từ cộng đồng, hãy sử dụng thẻ google-smart-home trên Stack Overflow: