Để giúp bạn xây dựng 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 hai API cốt lõi cho phép ứng dụng của bạn uỷ quyền và chia sẻ thiết bị với Google Fabric.
Sau khi thêm một thiết bị vào Google Fabric, 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 nút điều khiển nguồn Android, giọng nói và 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ể sử dụng để uỷ quyền thiết bị cho các hệ sinh thái Matter khác.
Tích hợp SDK dành cho thiết bị di động vào ứng dụng Android
Để bắt đầu, hãy hoàn thành các bước sau:
Làm theo hướng dẫn được cung cấp tại phần 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 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ỉ xuất hiện 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 đưa phần phụ thuộc mô-đun này vào tệp kê khai. Nếu bạn đang tích hợp Mobile SDK vào ứng dụng Android, để đảm bảo Matter hỗ trợ người dùng ứng dụng, hãy thêm khối service
sau vào phần 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 tình trạng hoạt động của mô-đun Home trong thời gian chạy bằng cách sử dụng ModuleInstallClient
. Hãy xem trang Đảm bảo khả năng sử dụng API bằng ModuleInstallClient để biết thêm thông tin.
Gọi các ứng dụng Android khác
Nếu đang sử dụng Android 11 trở lên, bạn cần đưa khối queries
sau đây vào AndroidManifest.xml
để ứng dụng của bạn có thể thực hiện lệnh 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 ứng dụng Android, hãy 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 nhanh chóng bắt đầu, chúng tôi đã phát hành nguồn mở Sample App for Matter và cung cấp một lớp học lập trình đồng hành, cho phép bạn tuỳ chỉnh mã mẫu của chúng tôi cho các dự án Android của riêng mình.
Chuyển đến lớp học lập trình về 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 Home Mobile