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