لمساعدتك في إنشاء تطبيقات 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 Sample App لبرنامج Matter
للتعرّف على آلية عمل Mobile SDK من تطبيق Android، جرِّب Sample App for Matter.
إنشاء تطبيقك الخاص
لمساعدتك في البدء بسرعة، تم إتاحة رمز برمجي مفتوح المصدر لتطبيق Sample App for Matter وتوفير ورشة عمل رمزية مرافقة، ما يتيح لك تخصيص الرمز النموذجي لمشاريع Android الخاصة بك.
الانتقال إلى الدرس التطبيقي حول الترميز Sample App for Matter
الموارد
للاطّلاع على مزيد من المعلومات عن Mobile SDK، يُرجى الرجوع إلى مرجع واجهة برمجة التطبيقات.
لمعرفة كيفية تعامل حزمة SDK هذه مع بيانات المستخدمين النهائيين، يُرجى الرجوع إلى قسم "أمان البيانات" في Google Play الخاص بحزمة SDK للأجهزة الجوّالة في Home.