إضافة واجهات برمجة التطبيقات Home APIs إلى تطبيق Android

لإضافة واجهات برمجة التطبيقات Home API إلى تطبيق Android، عليك استيفاء بعض المتطلبات الأساسية.

المتطلبات الأساسية

للتطوير، ستحتاج إلى جهاز كمبيوتر مثبت عليه الأدوات التالية:

  • الإصدار 2024.2.1 من Android Studio ("Ladybug") أو إصدار أحدث يُرجى العِلم أنّ الإصدارات الأقدم من هذا الإصدار قد لا تعمل بشكل صحيح مع حزمة تطوير البرامج (SDK) الخاصة بواجهات برمجة التطبيقات Home API.

    تنزيل "استوديو Android"

  • أداة تصحيح أخطاء Android ‏ (adb)

    ثبِّت adb.

    ويمكن إجراء ذلك باستخدام SDK Manager.

ولاختبار واجهات برمجة التطبيقات Home API، ستحتاج إلى ما يلي:

  • جهاز Android يعمل بنظام التشغيل Android 10 أو إصدار أحدث تم إعداده باستخدام حساب Google الذي تنوي استخدامه للتطوير. تأكَّد من تثبيت إصدار حديث من Android Studio وتسجيل الدخول إليه باستخدام حساب المطوّر هذا.
  • شبكة Wi-Fi
  • للوصول إلى أجهزة "Matter" والتحكّم فيها، يجب أيضًا أن يكون لديك مركز تحكّم من Google متوافق مع Home APIs. لمعرفة التفاصيل، يُرجى الاطّلاع على إمكانية الاتصال على Android .

  • جهاز واحد متوافق على الأقل في المنزل إذا كان هذا الجهاز (أو أي جهاز آخر تريد اختباره) يستخدم Thread، يجب أن يكون المحور أيضًا Thread Border Router (TBR). يتوافق نموذج تطبيق Android مع أنواع الأجهزة والسمات التالية:

    • مصباح بدرجة حرارة ألوان قابلة للتعديل (تشغيل وإيقاف، سطوع)
    • أداة استشعار التلامس (حالة منطقية)
    • مصباح قابل للتعتيم (تشغيل وإيقاف، سطوع)
    • قفل الباب
    • مصباح ملوّن متقدّم (تشغيل وإيقاف، سطوع)
    • مفتاح تحكّم عام
    • جهاز توجيه الحدود من Google
    • كاميرا Google
    • Google Doorbell
    • وحدة استشعار تواجد الأفراد في المنزل (استشعار تواجد الأفراد في المنزل)
    • مصباح يمكن تشغيله وإطفاؤه (تشغيل وإطفاء، سطوع)
    • مفتاح تشغيل/إيقاف الإضاءة
    • وحدة قابلة للتوصيل للتشغيل/الإيقاف (تشغيل وإيقاف)
    • أداة استشعار التشغيل/الإيقاف

المراكز المتوافقة

تتوفّر واجهات برمجة التطبيقات لمنزل Google في بعض أجهزة Google Nest Hub فقط.

الجدول: أجهزة Google Nest Hub المتوافقة مع Home APIs
الجهاز دعم جهاز توجيه الحدود Thread Google Store
Google Home
Google Nest Audio
Google Nest Hub
Google Nest Hub (2nd gen)
Google Nest Hub Max
Google Nest Mini
Google TV Streamer (4k)
Nest WiFi Pro

إعداد حزمة تطوير البرامج (SDK)

لا تزال واجهات برمجة التطبيقات Home APIs في هذا الإصدار التجريبي المفتوح غير مضمّنة في المكتبات العادية التي توفّرها Google لأغراض التطوير. لتطوير تطبيقات باستخدام واجهات برمجة التطبيقات Home API، عليك تنزيل المكتبات واستضافتها محليًا.

لتنزيل حزمة تطوير البرامج (SDK) الخاصة بواجهات Home API لنظام التشغيل Android، يجب أولاً تسجيل الدخول إلى Google Home Developers.

سجِّل الدخول الآن.

التالي
2. إعداد OAuth