برای کمک به شما در ساختن برنامه‌های Android که با دستگاه‌های Matter تعامل برقرار می‌کنند، Google Google Home Mobile SDK را توسعه داده است. Mobile SDK شامل دو میانای برنامه‌سازی کاربردی اصلی است که به برنامه‌های شما اجازه می‌دهد دستگاه‌ها را با Google fabric راه‌اندازی و هم‌رسانی کنند.
وقتی دستگاهی به ساختار Google اضافه می‌شود، کاربران شما می‌توانند دستگاه‌هایشان را ازطریق Google Home app (GHA)، کنترل‌های روشن/خاموش Android، صدا، و دستگاه‌های Nest با صفحه لمسی کنترل کنند.
Mobile SDK همچنین به شما امکان می‌دهد سرویس راه‌اندازی سفارشی تعریف کنید که می‌توانید از آن برای راه‌اندازی دستگاه‌ها در بوم‌سازگان‌های Matter دیگر استفاده کنید.
ادغام کردن کیت توسعه نرم‌افزار تلفن همراه در برنامه Android
برای شروع به کار، مراحل زیر را تکمیل کنید:
دستورالعمل‌های ارائه‌شده در راه‌اندازی Google Play services را دنبال کنید.
وابستگی 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 هر دو این وابستگی واحد را در مانیفست خود دارند. اگر درحال ادغام کردن
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 نسخه ۲۲.۵۰.۱۴ یا بالاتر استفاده می‌کنند پشتیبانی می‌شود.
برای مشاهده نمونه پیاده‌سازی، مانیفست Sample App for Matter را ببینید.
می‌توانید دردسترس بودن ماژول Home را در زمان اجرا بااستفاده از
ModuleInstallClient بررسی کنید. برای اطلاعات بیشتر، صفحه
اطمینان از دردسترس بودن API با ModuleInstallClient
را ببینید.
فراخوانی دیگر برنامه‌های Android
اگر از Android نسخه ۱۱ یا بالاتر استفاده می‌کنید، باید بلوک
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 Sample App for Matter
برای آشنایی با نحوه عملکرد Mobile SDK از برنامه Android، Sample App for Matter ما را امتحان کنید.
Sample App for Matter را امتحان کنید
برنامه خودتان را بسازید
برای کمک به شما در شروع سریع، Sample App for Matter را متن‌باز کرده‌ایم و یک کدلَب همراه ارائه داده‌ایم که به شما امکان می‌دهد کد نمونه ما را برای پروژه‌های Android خودتان سفارشی‌سازی کنید.
به Sample App for Matter codelab بروید
منابع
برای کسب اطلاعات بیشتر درباره Mobile SDK، به مرجع میانای برنامه‌سازی کاربردی مراجعه کنید.
برای آشنایی با نحوه مدیریت داده‌های کاربر نهایی توسط این کیت توسعه نرم‌افزار، به بخش «ایمنی داده» Google Play کیت توسعه نرم‌افزار Home Mobile مراجعه کنید