Ủy quyền SDK di động tại nhà

Trang này trình bày cách sử dụng một số tính năng API uỷ quyền trong Google Home Mobile SDK.

Tắt thông báo khám phá có thể nhận được tiền hoa hồng

Thông báo nửa trang trên Android
Hình 1: Ví dụ về thông báo nửa trang trên Android

Theo mặc định, Google Play services trên Android sử dụng thông báo "halfsheet" (nửa trang) bao phủ nửa dưới của màn hình thiết bị di động để cung cấp cho người dùng thông tin chủ động về việc các thiết bị Matter có thể nhận được hoa hồng đang ở gần.

Để ngăn chặn sự gián đoạn khi ứng dụng đang chạy trên nền trước, bạn có thể bịt các thông báo này bằng cách gọi phương thức suppressHalfSheetNotification() trong Mobile SDK. Hãy xem tài liệu về API để biết thêm thông tin.

Tính năng chặn do API này bật sẽ hết thời gian chờ nếu ứng dụng của bạn chạy ở nền trước trong hơn 15 phút. Để bật lại tính năng chặn sau khi hết thời gian chờ, hãy gọi lại suppressHalfSheetNotification(), nếu không, thông báo nửa trang sẽ bắt đầu xuất hiện.

Bạn có thể tìm thấy cách triển khai API này trong Google Home Sample App for Matter. Hãy xem HalfSheetSuppressionObserver.kt để biết thêm thông tin.

Cho biết bạn hỗ trợ việc uỷ quyền Matter

Nếu đang sử dụng Mobile SDK để uỷ quyền, bạn phải thêm tên gói ứng dụng trong Google Home Developer Console, triển khai API Matter và cho biết ứng dụng của bạn hỗ trợ uỷ quyền Matter bằng cách xử lý ý định ACTION_COMMISSION_DEVICE.

Thêm intent-filter sau vào phần khai báo application trong tệp AndroidManifest.xml:

<intent-filter>
    <action android:name="com.google.android.gms.metadata.MODULE_DEPENDENCIES" />
</intent-filter>

Hãy xem tệp kê khai của ứng dụng mẫu để tham khảo.

Bộ chọn ứng dụng

Bộ chọn ứng dụng

Có hai cách để ứng dụng của bạn xuất hiện trong bộ chọn ứng dụng trong quá trình triển khai:

  1. Trên màn hình Chọn một ứng dụng.
  2. Nếu người dùng chọn Chọn ứng dụng khác, thì lựa chọn này sẽ xuất hiện trên màn hình Các ứng dụng đã cài đặt khác.

Ứng dụng đề xuất

Bộ chọn ứng dụng hiển thị hai ứng dụng được đề xuất.

  • Giá trị đầu tiên luôn là Google Home app (GHA).
  • Thuộc tính thứ hai dành cho ứng dụng ưu tiên của nhà sản xuất thiết bị, nếu ứng dụng đó được xác định trong dự án Developer Console liên kết với VID hoặc PID của thiết bị. Ứng dụng uỷ quyền ưu tiên của nhà sản xuất thiết bị

Có hai trường hợp khi ứng dụng xuất hiện trên màn hình Chọn ứng dụng.

  1. Đã cài đặt – Play services kiểm tra để đảm bảo ứng dụng hỗ trợ bộ lọc ý định ACTION_COMMISSION_DEVICE. Nếu thiếu bộ lọc ý định, người dùng sẽ được chuyển hướng đến Cửa hàng Play để cập nhật ứng dụng.
  2. Chưa cài đặt – Người dùng được chuyển hướng đến Cửa hàng Play để cài đặt ứng dụng trước khi tiếp tục.