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