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

لإضافة واجهات برمجة التطبيقات Home APIs إلى تطبيق 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 APIs
  • جهاز متوافق واحد على الأقل في المنزل إذا كان هذا الجهاز (أو أي جهاز آخر تريد اختباره) يستخدم بروتوكول Thread، يجب أن يكون المحور أيضًا جهاز توجيه حدود Thread. يتيح تطبيق Android النموذجي أنواع الأجهزة التالية وسماتها:

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

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

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

جدول: وحدات Google Nest Hub التي تتيح استخدام Home APIs
الجهاز نظام التشغيل 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) لنظام التشغيل Android من Home APIs، يجب أولاً تسجيل الدخول إلى Google مطوّرو Home.

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