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

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

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

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

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

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

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

    ثبِّت adb.

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

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

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

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

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

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

تتوفّر واجهات برمجة التطبيقات لمنزل Google على بعض أجهزة 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)

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

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

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

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