Để giúp bạn tạo các ứng dụng Android tương tác với thiết bị Matter, Google đã phát triển Google Home Mobile SDK. Mobile SDK bao gồm 2 API cốt lõi cho phép các ứng dụng của bạn uỷ quyền và chia sẻ thiết bị với Google Fabric.
Sau khi một thiết bị được thêm vào hệ thống của Google, người dùng có thể điều khiển thiết bị của họ thông qua Google Home app (GHA), các chế độ điều khiển nguồn của Android, giọng nói và các thiết bị màn hình cảm ứng Nest.
Mobile SDK cũng cho phép bạn xác định một dịch vụ uỷ quyền tuỳ chỉnh mà bạn có thể dùng để uỷ quyền cho các thiết bị đối với các hệ sinh thái Matter khác.
Tích hợp Mobile SDK vào ứng dụng Android
Để bắt đầu, hãy hoàn tất các bước sau:
Làm theo hướng dẫn tại Thiết lập Google Play services.
Thêm phần phụ thuộc Play services vào tệp
build.gradle:implementation 'com.google.android.gms:play-services-home:16.0.0-beta1'
Đảm bảo việc phân phối mô-đun
Mô-đun Play services home là không bắt buộc, do đó, chức năng Matter sẽ chỉ có trên thiết bị của người dùng nếu một ứng dụng trên thiết bị đó chỉ định phần phụ thuộc mô-đun Play services thích hợp trong tệp AndroidManifest.xml của ứng dụng.
Cả GHA và Google Home Sample App for Matter đều có phần phụ thuộc mô-đun này trong tệp kê khai. Nếu bạn đang tích hợp Mobile SDK vào ứng dụng Android, để đảm bảo hỗ trợ Matter cho người dùng ứng dụng, hãy thêm khối service sau vào nội dung khai báo application trong tệp AndroidManifest.xml:
<service android:name="com.google.android.gms.metadata.ModuleDependencies"
android:enabled="false"
android:exported="false">
<intent-filter>
<action android:name="com.google.android.gms.metadata.MODULE_DEPENDENCIES" />
</intent-filter>
<meta-data android:name="home:0:preferred" android:value=""/>
</service>
Tính năng này chỉ được hỗ trợ cho các thiết bị Android chạy Play services 22.50.14 trở lên.
Hãy xem tệp kê khai của Sample App for Matter để biết ví dụ về cách triển khai.
Bạn có thể kiểm tra phạm vi cung cấp mô-đun Home trong thời gian chạy bằng cách sử dụng ModuleInstallClient. Hãy xem trang Đảm bảo tính sẵn có của API bằng ModuleInstallClient để biết thêm thông tin.
Gọi các ứng dụng Android khác
Nếu đang dùng Android 11 trở lên, bạn cần thêm khối queries sau đây vào AndroidManifest.xml để ứng dụng có thể gọi đến các ứng dụng khác.
<queries>
<!-- For GMS Core/Play service -->
<package android:name="com.google.android.gms" />
<package android:name="com.android.vending" />
<!-- End of GMS Core/Play service-->
</queries>
Để biết thêm thông tin, hãy xem bài viết Lọc chế độ hiển thị gói trên Android.
Sử dụng Ứng dụng mẫu Google Home cho Matter
Để tìm hiểu cách hoạt động của Mobile SDK trong một ứng dụng Android, hãy dùng thử Sample App for Matter của chúng tôi.
Dùng thử Sample App for Matter
Tạo ứng dụng của riêng bạn
Để giúp bạn bắt đầu nhanh chóng, chúng tôi đã cung cấp mã nguồn mở cho Sample App for Matter và cung cấp một lớp học lập trình đi kèm, cho phép bạn tuỳ chỉnh mã mẫu cho các dự án Android của riêng mình.
Chuyển đến lớp học lập trình Sample App for Matter
Tài nguyên
Để tìm hiểu thêm về Mobile SDK, hãy tham khảo Tài liệu tham khảo API.
Để tìm hiểu cách SDK này xử lý dữ liệu người dùng cuối, hãy tham khảo Mục An toàn dữ liệu của Google Play cho SDK di động Home