Ủ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 thử nghiệm trong Google Home Mobile SDK.

Chặn các thông báo khám phá có thể trả phí hoa hồng

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

Theo mặc định, Google Play services trên Android sử dụng thông báo "nửa trang 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 chỉ báo chủ động cho biết các thiết bị Matter có thể hoạt động đang ở gần.

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

Quá trình 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 trên 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 khả năng hỗ trợ việc thử nghiệm 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 vào Google Home Developer Console, triển khai các API Matter và cho biết rằng ứng dụng của bạn hỗ trợ việc cam kết Matter bằng cách xử lý ý định ACTION_COMMISSION_DEVICE.

Thêm intent-filter sau đây 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ó 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 vận hành thử nghiệm:

  1. Trên màn hình Choose an app (Chọn ứng dụng).
  2. Nếu người dùng chọn Chọn ứng dụng khác, ứng dụng đó sẽ hiển thị trên màn hình Ứ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.

  • Đầ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 một dự án Developer Console liên kết với VID hoặc PID của thiết bị. Ứng dụng uỷ viên ưu tiên của nhà sản xuất thiết bị

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

  1. Đã cài đặt – Play services kiểm tra để đảm bảo ứng dụng có 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.