SDK dành cho thiết bị di động trong 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 Matter thiết bị, Google đã phát triển Google Home Mobile SDK Chiến lược phát hành đĩa đơn Mobile SDK bao gồm hai API cốt lõi cho phép ứng dụng của bạn đặt cọc và chia sẻ thiết bị với các sản phẩm của Google.

Sau khi một thiết bị được thêm vào Google Tìm kiếm, người dùng của bạn có thể kiểm soát các thiết bị thông qua Google Home app (GHA), điều khiển nguồn của 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ể dùng để phân phối thiết bị cho Matter bổ sung hệ sinh thái.

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

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

  1. Làm theo hướng dẫn tại 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 Play services home là không bắt buộc nên Chức năng Matter sẽ chỉ có trên Nếu ứng dụng trên thiết bị chỉ định Phần phụ thuộc mô-đun Play services trong tệp AndroidManifest.xml.

GHAGoogle Home Sample App for Matter đều bao gồm thông tin này phần phụ thuộc mô-đun trong tệp kê khai. Nếu bạn đang tích hợp Mobile SDK vào ứng dụng Android của bạn để đảm bảo Hỗ trợ Matter cho người dùng ứng dụng của bạn, hãy thêm sau khối service đến 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 Android thiết bị đang chạy Play services 22.50.14 trở lên.

Xem quy tắc của Sample App for Matter tệp kê khai để tham khảo ví dụ về cách triển khai.

Bạn có thể kiểm tra khả năng hoạt động của mô-đun Home trong thời gian chạy bằng cách dùng ModuleInstallClient. Xem Đả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 thêm các thành phần sau Chặn queries trong AndroidManifest.xml để ứng dụng của bạn có thể thực hiện cuộc 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.

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 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 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.

Truy cập vào 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 trên Google Play dành cho thiết bị di động tại nhà