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