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

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

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

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

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

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

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

    ثبِّت adb.

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

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

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

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

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

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

لا تتوفّر واجهات برمجة تطبيقات Home إلا في بعض وحدات تحكّم Google Nest.

جدول: وحدات Google Nest Hub التي تتيح استخدام واجهات برمجة التطبيقات Home API
الجهاز نظام التشغيل Thread التوافق مع أجهزة توجيه الحدود Google Store
Google Home بثّ
Google Nest Audio فريق التمثيل
Google Nest Hub بثّ
Google Nest Hub (2nd gen) Fuchsia
Google Nest Hub Max Fuchsia
Google Nest Mini بثّ
Google TV Streamer (4k) Android

إعداد حزمة SDK

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

لتنزيل حزمة تطوير البرامج (SDK) لـ Home APIs على Android، يجب أولاً تسجيل الدخول إلى Google Home Developers.

عليك تسجيل الدخول الآن.