SDK للأجهزة الجوّالة الرئيسية لنظام التشغيل Android

لمساعدتك في إنشاء تطبيقات Android تتفاعل مع أجهزة Matter، طوّرت Google Google Home Mobile SDK. تتضمّن واجهة برمجة التطبيقات Mobile SDK واجهتَي برمجة تطبيقات أساسيتَين، وهما تتيح للتطبيقات إنشاء أجهزة ومشاركتها مع قماش Google.

بعد إضافة جهاز إلى قماش Google، يمكن للمستخدمين التحكم في أجهزتهم من خلال Google Home app (GHA)، وعناصر التحكم في الطاقة لنظام Android، والصوت، وأجهزة Nest التي تعمل باللمس.

تسمح لك Mobile SDK أيضًا بتحديد خدمة عمولة مخصّصة يمكنك استخدامها لتفويض الأجهزة على أنظمة Matter إضافية.

دمج حزمة تطوير البرامج (SDK) للأجهزة الجوّالة في تطبيق Android

للبدء، أكمِل الخطوات التالية:

  1. اتّبِع التعليمات الواردة في إعداد Google Play services.

  2. إضافة الاعتمادية 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 التي تعمل بالإصدار 22.50.14 أو الإصدارات الأحدث من نظام التشغيل Play services.

يمكنك الاطّلاع على بيان Sample App for Matter للحصول على مثال لتنفيذ ذلك.

يمكنك التحقّق من مدى توفّر "وحدة المنزل" في وقت التشغيل باستخدام 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 لتطبيق Matter

للتعرّف على آلية عمل Mobile SDK من تطبيق Android، يمكنك تجربة Sample App for Matter.

جرِّب Sample App for Matter

إنشاء تطبيقك الخاص

لمساعدتك في البدء بسرعة، أضفنا مصدرًا مفتوحًا Sample App for Matter ووفّرنا درسًا تطبيقيًا مصاحبًا للترميز، ما يسمح لك بتخصيص رمز نموذجي لمشاريعك الخاصة في Android.

الانتقال إلى الدرس التطبيقي حول الترميز Sample App for Matter

المراجِع

لمعرفة المزيد من المعلومات حول Mobile SDK، يمكنك الرجوع إلى مرجع واجهة برمجة التطبيقات.

للتعرّف على كيفية معالجة حزمة تطوير البرامج (SDK) لبيانات المستخدمين النهائيين، يمكنك الرجوع إلى قسم "أمان البيانات" في حزمة تطوير البرامج (SDK) للأجهزة الجوّالة في Google Play.