ولمساعدتك في إنشاء تطبيقات Android للتفاعل مع أجهزة Matter، طوّرت Google Google Home Mobile SDK تشير رسالة الأشكال البيانية يشتمل Mobile SDK على واجهتَي برمجة تطبيقات أساسيتَين تسمحان لتطبيقاتك بما يلي: عمولة الأجهزة ومشاركتها مع فريق قماش Google
بعد إضافة الجهاز إلى مجموعة منتجات Google، يمكن للمستخدمين التحكّم في الأجهزة من خلال Google Home app (GHA)، وعناصر التحكم في التشغيل من Android، والصوت، والأجهزة ذات الشاشات التي تعمل باللمس من Nest.
وتسمح لك السمة Mobile SDK أيضًا بتحديد خدمة الفوترة المخصّصة التي يمكنك استخدامها لمنح الأجهزة Matter المنظومات المتكاملة.
ادمج حزمة Mobile SDK في تطبيق Android
للبدء، يجب تنفيذ الخطوات التالية:
اتّبِع التعليمات الواردة في إعداد 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 22.50.14 أو أحدث.
يمكنك الاطّلاع علىSample App for Matter البيان للحصول على مثال لعملية تنفيذ.
يمكنك التحقّق من مدى توفّر وحدة "المنزل" في وقت التشغيل باستخدام
ModuleInstallClient يمكنك الاطّلاع على
التأكّد من توفُّر واجهة برمجة التطبيقات باستخدام ModuleInstallClient
للحصول على مزيد من المعلومات.
الاتصال بتطبيقات Android الأخرى
إذا كنت تستخدم الإصدار 11 من نظام التشغيل 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 المناسب للمسألة القانونية
للتعرّف على آلية عمل "Mobile SDK" من خلال تطبيق Android، يمكنك تجربة Sample App for Matter.
يمكنك تجربة Sample App for Matter.
إنشاء تطبيقك الخاص
لمساعدتك على البدء بسرعة، قمنا بإتاحة Sample App for Matter وقدّم درسًا تطبيقيًا مصاحبًا حول الترميز، ما يتيح لك تخصيص رمز نموذجي لمشاريع Android الخاصة بك
الانتقال إلى الدرس التطبيقي حول الترميز Sample App for Matter
الموارد
لمزيد من المعلومات عن Mobile SDK، يُرجى الرجوع إلى مرجع واجهة برمجة التطبيقات
لمعرفة كيف تعالج حزمة SDK هذه بيانات المستخدمين، يُرجى الرجوع إلى قسم "أمان البيانات" في Google Play لحزمة تطوير البرامج (SDK) للأجهزة الجوّالة من Google Play.