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

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

Google Home Sample App for Matter sử dụng thuộc tính 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:

  • Gửi thiết bị Matter thực và ảo cho Vải Android cục bộ
  • Đưa các thiết bị thực và ảo vào một mô hình phát triển
  • Điều khiển thiết bị trên vải phát triển của bạn, ví dụ: bật nhỏ
  • Các tính năng với nhiều quản trị viên cho phép bạn chia sẻ thiết bị trên mô hình phát triển với các ứng dụng khác và ngược lại có thể đưa vào phiên bản thiết bị vải đượ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 để sử dụng, kiểm soát và chia sẻ Matter thiết bị.

Để tải xuống mã nguồn, 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 dùng thử Lớp học lập trình Sample App for Matter.

Truy cập vào lớp học lập trình Sample App for Matter

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

Bạn không cần một trung tâm (ví dụ: Google Nest Hub (2nd gen)) để hoa hồng 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 GitHub Sample App for Matter kho lưu trữ. Đố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 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 của bạn với USB và bật ứng dụ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 này lần đầu tiên, bạn sẽ thấy một hộp thoại kèm theo một đườ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 thì bạn có thể hiển thị hộp thoại trở lạ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 của bạ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 Vải Android cục bộ, cùng với vải phát triển là địa phương của mẫu chỉ ứng dụng.

Cấu trúc Matter là gì?

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

Vải Matter là một miền tin cậy chung giữa các thiết bị trong mạng gia đình để chúng giao tiếp với nhau.

Các thiết bị có thể có một hoặc nhiều loại vải 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. Fabric có một mã nhận dạng duy nhất và 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). Các thông tin đăng nhập này được chỉ định trong Matter vận hành.

Để uỷ quyền cho thiết bị Matter, hãy hoàn tất các bước sau:

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

    Thêm thiết bị

  2. Tiếp theo, quyền kiểm soát sẽ được chuyển sang Google Play services (đã chạy) từ một lệnh gọi đến Mobile SDK. Để chứng minh bằng chứng 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 uỷ quyền hoàn tất, 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ả vải Android cục bộ và cơ sở hạ tầng phát triển.

Tất cả công việc uỷ quyền và các màn hình liên quan đều do Play services khi lắp đặt thiết bị. Chiến dịch này mang đến trải nghiệm nhất quán cho người dùng và không cần phải xử lý dữ liệu nhạy cảm quyền truy cập, ví dụ: thông tin xác thực Wi-Fi và luồng.

Điều khiển thiết bị

Fabric cho phát triển tạo 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ị để 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. Khi một thiết bị được ủy 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 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. Chiến dịch này nền tảng bên ngoài trở thành người cố gắng mục tiêu. Chúng tôi đã tạo một bản sao của ứng dụng mẫu mà bạn có thể dùng làm uỷ viên mục tiêu.

  1. Chuyển đến phần Bản phát hành trong GitHub Sample App for Matter kho lưu trữ. Đố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 APK có tên GHSAFM-version-targetcommissioner-debug.apk. Đừng chọn default.

  2. Cài đặt trình uỷ quyền mục tiêu.

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

  3. Từ 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 Chia sẻ.

    Chia sẻ thiết bị

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

Một trang tính 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. Theo cách thủ công, thông qua mã thiết lập để chia sẻ với ứng dụng ủy quyền mục tiêu
  2. Với một ứng dụng Android cục bộ đã đăng ký làm Ủ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 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 (trình uỷ quyền mục tiêu) sẽ hoàn tất việc uỷ quyền thiết bị vào fabric của riêng ứng dụng đó.

Cài đặt

Từ Màn hình chính, hãy nhấp vào phần cài đặt Biểu tượng . 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.

Cài đặt

Thông báo về trang tính nửa đầu

Trên màn hình Cài đặt, bạn có thể chọn tắt tính năng chủ động ủy quyền thông báo khám phá cho Matter thiết bị.

Nếu ứng dụng của bạn cung cấp tính năng khám phá Matter riêng hoặc quy trình vận hành, bạn nên chặn các thông báo này để ngăn chặn gián đoạn. Xem phần Chặn hoạt động khám phá có thể kích hoạt thông báo để biết thêm thông tin.

Tiện ích dành cho nhà phát triển

Từ 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 lại nội dung của kho lưu trữ Device and User Preferences DataStore trong Logcat, hãy hoàn tất các bước sau:

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

  2. Nhấp vào OK trong 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 phản hồi của bạn về cách chúng tôi có thể cải thiện sự phát triển trải nghiệm với 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 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 của bạn:

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

Để nhận hỗ trợ kỹ thuật từ cộng đồng, hãy sử dụng thẻ google-smart-home trên Tràn ngăn xếp: