SDK อุปกรณ์เคลื่อนที่สำหรับ Android สำหรับ Android

Google ได้พัฒนา Google Home Mobile SDK เพื่อช่วยให้คุณสร้างแอปพลิเคชัน Android ที่โต้ตอบกับอุปกรณ์ Matter ได้ Mobile SDK มี API หลัก 2 รายการที่ช่วยให้แอปของคุณสามารถเปิดใช้งานและแชร์อุปกรณ์กับแพลตฟอร์ม Google ได้

เมื่อเพิ่มอุปกรณ์ลงในแพลตฟอร์ม Google แล้ว ผู้ใช้จะควบคุมอุปกรณ์ได้ผ่าน Google Home app (GHA), การควบคุมอุปกรณ์ Android, เสียง และอุปกรณ์หน้าจอสัมผัส Nest

Mobile SDK ยังให้คุณกำหนดบริการการจัดเตรียมอุปกรณ์ที่กำหนดเองได้อีกด้วย ซึ่งคุณใช้เพื่อจัดเตรียมอุปกรณ์ในระบบนิเวศ Matter เพิ่มเติมได้

ผสานรวม Mobile SDK เข้ากับแอป Android

หากต้องการเริ่มต้นใช้งาน ให้ทำตามขั้นตอนต่อไปนี้

  1. ทำตามวิธีการที่ระบุไว้ที่หัวข้อตั้งค่า Google Play services

  2. เพิ่ม Dependency ของ Play services ลงในไฟล์ build.gradle

    implementation 'com.google.android.gms:play-services-home:16.0.0-beta1'

ตรวจสอบการนำส่งข้อบังคับ

โมดูล Play services home ไม่บังคับ ดังนั้นฟังก์ชันการทำงาน Matter จะแสดงในอุปกรณ์ของผู้ใช้ก็ต่อเมื่อแอปในอุปกรณ์ระบุการพึ่งพาโมดูล Play services ที่เหมาะสมในไฟล์ AndroidManifest.xml

ทั้ง GHA และ Google Home Sample App for Matter ต่างก็ระบุข้อกำหนดของโมดูลนี้ในไฟล์ Manifest หากคุณผสานรวม Mobile SDK เข้ากับแอป Android ให้เพิ่มบล็อก service ต่อไปนี้ในการประกาศ application ภายในไฟล์ AndroidManifest.xml เพื่อให้แน่ใจว่าแอปของคุณจะรองรับ Matter

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

การดำเนินการนี้ใช้ได้กับAndroidอุปกรณ์ที่ใช้ Play services 22.50.14 ขึ้นไปเท่านั้น

ดูตัวอย่างการใช้งานในไฟล์ Sample App for Matter's manifest

คุณสามารถตรวจสอบความพร้อมใช้งานของโมดูล Home ขณะรันไทม์ได้โดยใช้ ModuleInstallClient ดูข้อมูลเพิ่มเติมที่หน้าการตรวจสอบความพร้อมใช้งานของ API ด้วย ModuleInstallClient

การโทรหาแอปอื่นๆ ของ Android

หากคุณใช้ Android 11 ขึ้นไป คุณต้องใส่บล็อก queries ต่อไปนี้ใน AndroidManifest.xml เพื่อให้แอปโทรหาแอปอื่นๆ ได้

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

ดูข้อมูลเพิ่มเติมได้ที่บทความการกรองระดับการมองเห็นแพ็กเกจใน Android

ใช้แอปตัวอย่างของ Google Home สำหรับ Matter

หากต้องการดูวิธีการทำงานของ Mobile SDK จากแอป Android ให้ลองใช้ Sample App for Matter

ลองใช้ Sample App for Matter

สร้างแอปของคุณเอง

เราได้เปิดSample App for Matterเป็นโอเพนซอร์สและจัดเตรียม Codelab ประกอบไว้ให้เพื่อช่วยให้คุณเริ่มต้นใช้งานได้อย่างรวดเร็ว ซึ่งจะช่วยให้คุณปรับแต่งโค้ดตัวอย่างสำหรับโปรเจ็กต์ Android ของคุณเองได้

ไปที่ Sample App for Matter codelab

แหล่งข้อมูล

ดูข้อมูลเพิ่มเติมเกี่ยวกับ Mobile SDK ได้ที่เอกสารอ้างอิง API

ดูวิธีที่ SDK นี้จัดการข้อมูลผู้ใช้ปลายทางได้ที่ส่วนความปลอดภัยของข้อมูล Google Play สำหรับ Home Mobile SDK