Trang này trình bày cách sử dụng một số tính năng của API uỷ quyền trong Google Home Mobile SDK.
Ẩn thông báo về nội dung khám phá có thể nhận hoa hồng
Theo mặc định, Google Play services trên Android sử dụng thông báo "nửa trang" bao phủ nửa dưới màn hình của thiết bị di động để chủ động cho người dùng biết rằng có các thiết bị Matter có thể uỷ quyền ở gần.
Để tránh bị gián đoạn khi ứng dụng của bạn đang chạy trên nền trước, bạn có thể chặn 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 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 tính 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 có hỗ trợ việc thiết lập 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 rằng ứ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
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 uỷ quyền:
- Trên màn hình Chọn một ứng dụng.
- Nếu người dùng chọn Chọn ứng dụng khác, thì ứng dụng đó sẽ xuất hiện trên màn hình Ứng dụng khác đã cài đặt.
Ứ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).
- Thứ hai là 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 một dự án Developer Console liên kết với VID hoặc PID của 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 một ứng dụng.
- Đã 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 đến Cửa hàng Play để cập nhật ứng dụng. - Chưa cài đặt – Người dùng được chuyển đến Cửa hàng Play để cài đặt ứng dụng trước khi tiếp tục.