Ủ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 chọn chạy trong Google Home Mobile SDK.

Loại bỏ thông báo về hoạt động khám phá có thể chặn quyền truy cập

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

Theo mặc định, Google Play services trên Android sử dụng thông báo "bảng tính" che phủ nửa dưới màn hình của thiết bị di động để cung cấp cho người dùng thông báo chủ động về việc các thiết bị Matter có thể kích hoạt đang ở gần.

Để tránh bị gián đoạn khi ứng dụng chạy ở nền trước, bạn có thể tạm dừng 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.

Chế độ chặn do API này kích hoạ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 một nửa trang tính sẽ bắt đầu xuất hiện.

Bạn có thể xem 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 hoạt động hỗ trợ vận hành theo chuẩn Matter

Nếu đang sử dụng Mobile SDK để hoa hồng, bạn phải thêm tên gói ứng dụng trong Google Home Developer Console, triển khai các API Matter của chúng tôi và cho biết rằng ứng dụng của bạn hỗ trợ phí hoa hồng 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 vận hành:

  1. Trên màn hình Chọn ứng dụng.
  2. Nếu người dùng chọn Choose other app (Chọn ứng dụng khác), thì ứng dụng đó sẽ xuất hiện trên màn hình Other Installed Apps (Ứng dụng đã cài đặt khác).

Ứng dụng đề xuất

Bộ chọn ứng dụng cho thấy 2 ứng dụng đề xuất.

  • Giá trị đầu tiên luôn là Google Home app (GHA).
  • Phương thức 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 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ó 2 tình huống khi ứng dụng xuất hiện trên màn hình Choose an app (Chọn ứng dụng).

  1. Đã cài đặtPlay 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 đến Cửa hàng Play để cài đặt ứng dụng trước khi tiếp tục.