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