لمساعدتك في إنشاء تطبيقات 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'
ضمان تقديم الوحدة
وحدة 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 التي تعمل بالإصدار 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