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

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

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:

  • Uỷ quyền cho 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 mạng lưới phát triển
  • Điều khiển các thiết bị trên mạng lưới phát triển, chẳng hạn như bật đèn
  • Các tính năng quản trị nhiều thiết bị cho phép bạn chia sẻ thiết bị trên cấu trúc phát triển với các ứng dụng khác và ngược lại, có thể đưa vào cấu trúc phát triển các thiết bị được chia sẻ từ các ứng dụng khác
  • Tiện ích cho nhà phát triển

Hướng dẫn này mô tả cách cài đặt tệp APK Sample App for Matter và sử dụng tệp này để uỷ quyền, điều khiển 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ử 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 có thiết bị trung tâm (ví dụ: Google Nest Hub (2nd gen)) để uỷ quyền và điều khiển 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ữ GitHub Sample App for Matter. Đối với bản phát hành gần đây nhất, hãy tìm tệp APK có tên GHSAFM-version-default-debug.apk trong phần Tài sản. Đừ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 của bạn bằng 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

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 Don't show this message again (Không hiện lại thông báo này), bạn có thể mở lại hộp thoại bất cứ lúc nào bằng cách cập nhật 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 Local Android fabric, cùng với một development fabric chỉ dành riêng cho ứng dụng mẫu.

Mạng Matter là gì?

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

Matter fabric 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ị này giao tiếp với nhau.

Thiết bị có thể có một hoặc nhiều cấu trúc 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. Mỗi Fabric có một mã nhận dạng riêng biệt, còn các thiết bị dùng chung một bộ thông tin xác thực và tổ chức phát hành chứng chỉ (CA). Những thông tin đăng nhập này được chỉ định trong quá trình Matter uỷ quyền.

Để uỷ quyền cho một 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 uỷ quyền.

    Thêm thiết bị

  2. 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. Để chứng minh 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.

    Quét mã QR

  3. Khi quá trình uỷ quyền 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ả mạng Android cục bộ và mạng phát triển.

Tất cả công việc uỷ quyền và màn hình liên quan đều do Play services xử lý khi uỷ quyền 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 truy cập thông tin 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 để điều khiển Matter thiết bị 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 thông số kỹ thuật của Matter. Sau khi thiết bị được uỷ quyền cho ứ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 của bạn 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 người 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 trình uỷ nhiệm mục tiêu.

  1. 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 gần đây nhất, hãy tìm tệp APK có tên GHSAFM-version-targetcommissioner-debug.apk trong phần Tài sản. Đừng chọn default.

  2. Cài đặt trình uỷ viên 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 API Mobile SDK Share 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 hai cách để bạn chia sẻ thiết bị:

  1. 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 Matter trình uỷ nhiệm

Ứng dụng 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 (bên uỷ quyền mục tiêu) sẽ hoàn tất việc uỷ quyền thiết bị vào cấu trúc riêng của ứng dụ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ó thể 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.

Cài đặt

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 chủ động về việc khám phá thiết bị có thể nhận hoa hồng cho Matter thiết bị.

Nếu ứng dụng của bạn cung cấp quy trình khám phá hoặc uỷ quyền 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 Ẩn thông báo khám phá có thể nhận hoa hồng để biết thêm thông tin.

Tiện ích 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 kho lưu trữ DataStore về lựa chọn ưu tiên của người dùng và thiết bị trong Logcat, hãy hoàn tất các bước sau:

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

  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 ý 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 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 lỗi mã, bạn có thể gửi vấn đề đến Trình theo dõi sự cố trong kho lưu trữ GitHub:

Để nhận được 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: