لمساعدتك في إنشاء تطبيقات 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.