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

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

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

للتطوير، يجب أن يتوفّر جهاز كمبيوتر مثبّت عليه الأدوات التالية:

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

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

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

    تثبيت adb.

    يمكن إجراء ذلك باستخدام مدير حزمة تطوير البرامج (SDK).

لاختبار واجهات برمجة التطبيقات Home APIs، يجب أن يتوفّر ما يلي:

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

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

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

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

لا تتوافق مع واجهات برمجة التطبيقات Home APIs سوى مراكز تحكّم معيّنة من Google Nest.

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

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

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

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