SDK trên thiết bị di động tại nhà dành cho Android

Để 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 các ứng dụng của bạn nhận và chia sẻ thiết bị với Google Canvas.

Sau khi một thiết bị được thêm vào Google Canvas, người dùng có thể điều khiển các thiết bị đó 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ị có màn hình cảm ứng Nest.

Mobile SDK cũng cho phép bạn xác định dịch vụ phí hoa hồng tuỳ chỉnh mà bạn có thể sử dụng để ủy quyền thiết bị cho các hệ sinh thái Matter khác.

Tích hợp SDK di động vào ứng dụng Android của bạn

Để bắt đầu, hãy hoàn tất các bước sau:

  1. Làm theo hướng dẫn trong bài viết Thiết lập Google Play services.

  2. 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 home của Play services là không bắt buộc, do đó, chức năng Matter sẽ chỉ hiện diệ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ả GHAGoogle Home Sample App for Matter đều đưa phần phụ thuộc của 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 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 tình trạng có sẵn của mô-đun Home trong thời gian chạy bằng cách sử dụng ModuleInstallClient. Xem trang Bảo đảm tình trạng có sẵn 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 sử dụng Android 11 trở lên, bạn cần đưa khối queries sau vào AndroidManifest.xml để ứng dụng có thể gọi 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.

Dùng ứng dụng mẫu Google Home cho Matter

Để tìm hiểu cách Mobile SDK hoạt động từ một ứng dụng Android, hãy thử Sample App for Matter.

Hãy 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ở 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 bạn.

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 của người dùng cuối, hãy tham khảo Mục An toàn dữ liệu trên Google Play SDK dành cho thiết bị di động tại nhà