افزودن «میاناهای برنامه‌سازی کاربردی خانه» به برنامه Android

برای افزودن Home API به برنامه Android، باید چند پیش‌نیاز را برآورده کنید.

پیش‌نیازها

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

  • Android Studio، نسخه 2024.2.1 («Ladybug») یا جدیدتر. توجه داشته باشید که نسخه‌های قدیمی‌تر از این ممکن است با کیت توسعه نرم‌افزار Home APIs به‌درستی کار نکنند.

    بارگیری «استودیو Android»

  • اشکال‌زدای Android‏ (adb).

    adb را نصب کنید.

    این کار را می‌توان با مدیر SDK انجام داد.

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

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

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

    • چراغ دمای رنگ (روشن و خاموش، روشنایی)
    • حسگر تماسی (وضعیت بولی)
    • چراغ با نور قابل‌تنظیم (روشن و خاموش، روشنایی)
    • قفل در
    • Extended Color Light (روشن و خاموش، روشنایی)
    • کلید عمومی
    • رهیاب مرزی Google
    • دوربین Google
    • Google Doorbell
    • حسگر حضور در خانه (تشخیص حضور در خانه)
    • روشن/خاموش کردن چراغ (روشن و خاموش، روشنایی)
    • کلید روشن/خاموش چراغ
    • واحد افزایه روشن/خاموش (روشن و خاموش)
    • حسگر روشن/خاموش

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

فقط برخی‌از Google Nest Hubها از Home API پشتیبانی می‌کنند.

جدول: Google Nest Hub با پشتیبانی Home API
دستگاه پشتیبانی رهیاب مرزی 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

راه‌اندازی کیت توسعه نرم‌افزار

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

برای بارگیری کیت توسعه نرم‌افزار Android برای Home API، ابتدا باید به سیستم Google Home Developers وارد شوید.

اکنون به سیستم وارد شوید!

بعدی
۲. راه‌اندازی OAuth