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.
Ngăn thông báo khám phá thiết bị có thể uỷ quyền
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 ở nền trước, bạn có thể
ngăn các thông báo này bằng cách gọi
suppressHalfSheetNotification()
phương thức trong Mobile SDK. Xem tài liệu về API để biết thêm thông tin.
Tính năng ngăn chặn do API này bật sẽ hết thời gian chờ nếu ứng dụng của bạn ở nền trước trong hơn 15 phút. Để bật lại tính năng ngăn 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 một cách triển khai API này trong
Google Home Sample App for Matter. Xem
HalfSheetSuppressionObserver.kt
để biết thêm thông tin.
Cho biết hỗ trợ 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
vào Google Home Developer Console, triển khai API Matter
của chúng tôi 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 khai báo application trong tệp AndroidManifest.xml:
<intent-filter>
<action android:name="com.google.android.gms.metadata.MODULE_DEPENDENCIES" />
</intent-filter>
Tham khảo tệp kê khai của ứng dụng mẫu .
Bộ chọn ứng dụng
Có 2 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 Các ứng dụng đã cài đặt khác.
Ứng dụng đề xuất
Bộ chọn ứng dụng hiển thị 2 ứng dụng đề xuất.
- Ứng dụng đầu tiên luôn là Google Home app (GHA).
- Ứng dụng thứ hai là ứ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
Developer Console dự án được liên kết với VID hoặc PID của
thiết bị.
Có 2 trường hợp khi các ứng dụng ở trên màn hình Chọn một ứng dụng.
- Đã cài đặt - Play services kiểm tra xem ứng dụng có hỗ trợ bộ lọc ý định
ACTION_COMMISSION_DEVICEhay không. Nếu bộ lọc ý định bị thiếu, 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.