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

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

پیش‌نیازها

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

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

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

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

    نصب adb.

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

و برای آزمایش «میاناهای برنامه‌سازی کاربردی خانه هوشمند»، به موارد زیر نیاز دارید:

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

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

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

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

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

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

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

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

برای بارگیری «کیت توسعه نرم‌افزار Android میاناهای برنامه‌سازی کاربردی خانه»، ابتدا باید به سیستم «توسعه‌دهندگان خانه هوشمند Google» وارد شوید.

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

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