إضافة واجهات برمجة التطبيقات 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. لمزيد من التفاصيل، يُرجى الاطّلاع على الاتصال على أجهزة Android .

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

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

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

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

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

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

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

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