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

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

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

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

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

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

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

    ثبِّت adb.

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

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

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

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

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

المراكز الرئيسية المتوافقة

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

جدول: أجهزة Google Nest Hub المتوافقة مع واجهات برمجة تطبيقات Home
الجهاز 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، عليك تنزيل المكتبات واستضافتها محليًا.

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

تسجيل الدخول الآن

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