Home Mobile SDK برای اندروید

برای کمک به شما در ساخت برنامه‌های Android که با دستگاه‌های Matter تعامل دارند، Google Home Mobile SDK توسعه داده است. Mobile SDK شامل دو API اصلی است که به برنامه‌های شما امکان می‌دهد دستگاه‌ها را با Google Fabric به اشتراک بگذارند.

هنگامی که دستگاهی به پارچه Google اضافه می‌شود، کاربران شما می‌توانند دستگاه‌های خود را از طریق Google Home app (GHA) ، کنترل‌های قدرت Android، صدا، و دستگاه‌های صفحه لمسی Nest کنترل کنند.

Mobile SDK همچنین به شما امکان می دهد یک سرویس سفارشی سفارشی تعریف کنید که می توانید از آن برای سفارش دستگاه ها به اکوسیستم های اضافی Matter استفاده کنید.

SDK موبایل را در برنامه اندروید خود ادغام کنید

برای شروع مراحل زیر را انجام دهید:

  1. دستورالعمل های ارائه شده در راه اندازی Google Play services را دنبال کنید.

  2. وابستگی Play services را به فایل build.gradle خود اضافه کنید:

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

از تحویل ماژول اطمینان حاصل کنید

ماژول home Play services اختیاری است و بنابراین عملکرد Matter تنها در صورتی در دستگاه کاربر وجود دارد که یک برنامه در دستگاه وابستگی مناسب ماژول Play services در فایل AndroidManifest.xml خود مشخص کند.

GHA و Google Home Sample App for Matter هر دو این وابستگی ماژول را در مانیفست خود دارند. اگر Mobile SDK در برنامه Android خود ادغام می کنید، برای اطمینان از پشتیبانی Matter برای کاربران برنامه خود، بلوک service زیر را به اعلان application در فایل 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>

این فقط برای دستگاه‌های Android دارای Play services 22.50.14 یا بالاتر پشتیبانی می‌شود.

برای اجرای نمونه به مانیفست Sample App for Matter مراجعه کنید.

با استفاده از ModuleInstallClient می‌توانید در دسترس بودن ماژول Home را در زمان اجرا بررسی کنید. برای اطلاعات بیشتر به صفحه اطمینان از در دسترس بودن API با ModuleInstallClient مراجعه کنید.

تماس با سایر برنامه های اندروید

اگر از 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>

برای اطلاعات بیشتر، به مقاله فیلتر مشاهده بسته در اندروید مراجعه کنید.

از Google Home Sample App for 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 SDK موبایل خانگی مراجعه کنید.