API های Home را به برنامه اندروید خود اضافه کنید

برای افزودن API های Home به یک برنامه اندروید، باید چند پیش نیاز را رعایت کنید.

پیش‌نیازها

برای توسعه، به رایانه‌ای نیاز دارید که ابزارهای زیر روی آن نصب شده باشد:

  • Android Studio ، نسخه 2024.2.1 ("لیدی باگ") یا جدیدتر. توجه داشته باشید که نسخه‌های پایین‌تر از این ممکن است به درستی با SDK رابط‌های برنامه‌نویسی کاربردی خانگی (Home APIs SDK) کار نکنند.

    دانلود اندروید استودیو

  • دیباگر اندروید ( adb ).

    adb نصب کنید.

    این کار را می‌توان با استفاده از SDK Manager انجام داد.

و برای آزمایش API های Home، به موارد زیر نیاز دارید:

  • یک دستگاه اندروید با سیستم عامل اندروید ۱۰ یا بالاتر که با یک حساب گوگل که قصد استفاده از آن را برای توسعه دارید، راه‌اندازی شده باشد. مطمئن شوید که نسخه به‌روز Android Studio نصب شده و با این حساب توسعه وارد سیستم شده‌اید.
  • یک شبکه وای‌فای.
  • برای دسترسی و کنترل دستگاه‌های Matter ، به یک هاب گوگل که از APIهای Home پشتیبانی کند نیز نیاز دارید. برای جزئیات بیشتر به بخش «اتصال در اندروید» مراجعه کنید.

  • حداقل یک دستگاه پشتیبانی‌شده در خانه. اگر این دستگاه (یا هر دستگاه دیگری که می‌خواهید آزمایش کنید) از Thread استفاده می‌کند، هاب نیز باید یک روتر مرزی Thread باشد. انواع و ویژگی‌های دستگاه زیر توسط برنامه نمونه اندروید پشتیبانی می‌شوند:

    • دمای رنگ نور (روشن و خاموش، روشنایی)
    • سنسور تماسی (حالت بولی)
    • چراغ قابل تنظیم (روشن و خاموش، روشنایی)
    • نور رنگی گسترده (روشن و خاموش، روشنایی)
    • سوئیچ عمومی
    • دوربین گوگل
    • حسگر حضور (حسگر حضور)
    • روشن/خاموش کردن چراغ (روشن و خاموش، روشنایی)
    • کلید روشن/خاموش چراغ
    • واحد دوشاخه روشن/خاموش (روشن و خاموش)
    • سنسور روشن/خاموش

هاب‌های پشتیبانی‌شده

فقط برخی از هاب‌های Google Nest از رابط‌های برنامه‌نویسی کاربردی (API) صفحه اصلی پشتیبانی می‌کنند.

جدول: هاب‌های Google Nest با پشتیبانی از رابط‌های برنامه‌نویسی کاربردی (API) صفحه اصلی
دستگاه پشتیبانی از روتر حاشیه‌ای Thread فروشگاه گوگل
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 را تنظیم کنید

رابط‌های برنامه‌نویسی کاربردی (API) خانگی (Home API) در این نسخه بتای عمومی هنوز بخشی از کتابخانه‌های استاندارد ارائه شده توسط گوگل برای توسعه نیستند. برای توسعه برنامه‌ها با رابط‌های برنامه‌نویسی کاربردی خانگی (Home APIs)، باید کتابخانه‌ها را به صورت محلی دانلود و میزبانی کنید.

برای دانلود SDK اندروید APIهای Home، ابتدا باید وارد حساب Google Home Developers شوید.

همین حالا وارد شوید!

بعدی
2. OAuth را راه اندازی کنید