مجوز حساب در Android

قبل‌از ادامه دادن با صدور مجوز حساب، مطمئن شوید که موارد زیر را دارید:

  1. ‫Google Home app (GHA) در دستگاه همراه Android شما نصب شده باشد.
  2. حداقل یکی از این انواع دستگاه‌های پشتیبانی‌شده برای «برنامه نمونه» در خانه:
    • چراغ دمای رنگ (روشن و خاموش، روشنایی)
    • حسگر تماسی (وضعیت بولی)
    • چراغ کم‌نورشدنی (روشن و خاموش، روشنایی)
    • قفل در
    • Extended Color Light (روشن و خاموش، روشنایی)
    • کلید عمومی
    • رهیاب مرزی Google
    • دوربین Google
    • Google Doorbell
    • حسگر حضور در خانه (تشخیص حضور در خانه)
    • روشن/خاموش کردن چراغ (روشن و خاموش، روشنایی)
    • کلید روشن/خاموش چراغ
    • واحد افزایه روشن/خاموش (روشن و خاموش)
    • حسگر روشن/خاموش
  3. دو دستگاه برای آزمایش خودکارسازی نمونه.

قبل‌از استفاده از دستگاه‌ها ازطریق Home APIs، باید ازطریق GHA قابل‌کنترل باشند.

اجرا کردن برنامه نمونه Android

پیش‌از صدور مجوز برای حساب، بررسی کنید که «برنامه نمونه» با گستره OAuth مناسب برای پروژه‌تان پیکربندی شده باشد. به‌طور پیش‌فرض، کد منبع «برنامه نمونه» از دامنه https://www.googleapis.com/auth/home.platform.v2 استفاده می‌کند. بسیاری از ویژگی‌های برنامه نمونه با محدوده home.platform.v2 محدود شده‌اند و برای دسترسی به آن‌ها به تأیید شریک نیاز است. برای مجاز کردن و استفاده از «برنامه نمونه» با گستره استاندارد https://www.googleapis.com/auth/home.platform.selected.devices، به‌طور دستی homePlatformScope را به HOME_PLATFORM_SCOPE_VERSION_1 در HomeModule.kt همان‌طور که در ساختن برنامه شرح داده شده است تغییر دهید.

«برنامه نمونه Android» را اجرا کنید. اولین‌باری که آن را اجرا می‌کنید، از شما خواسته می‌شود به خانه‌ای در «حساب Google» خود اجازه دسترسی بدهید. این کار به «برنامه نمونه» اجازه می‌دهد به ساختمان‌ها و دستگاه‌های آن خانه دسترسی داشته باشد و آن‌ها را کنترل کند.

اگر ساختاری ندارید، کاربر می‌تواند درطول جریان اجازه بدون نیاز به استفاده از GHA، ساختاری ایجاد کند.

عملکرد اجازه پیش‌فرض برنامه بسته به اینکه برنامه در Google Home Developer Console ثبت شده است یا نه متفاوت خواهد بود.

اگر برنامه‌ای در Developer Console ثبت نشده باشد، در وضعیت تأییدنشده قرار می‌گیرد. این مورد برای آزمایش کردن استفاده از Home API توصیه می‌شود:

  • فقط کاربرانی که به‌عنوان کاربر آزمایشی در کنسول OAuth ثبت شده‌اند می‌توانند برای برنامه اجازه اعطا کنند. برای برنامه تأییدنشده، محدودیت ۱۰۰ کاربر آزمایشی وجود دارد.

  • برنامه تأییدنشده به دستگاه‌هایی از هر نوع دستگاهی که OAuth برای Home API پشتیبانی می‌کند (فهرست انواع دستگاه در Developer Console) دسترسی خواهد داشت. همه دستگاه‌های موجود در ساختار اعطا خواهند شد.

اگر برنامه‌ای در Developer Console ثبت شده باشد و برای دسترسی به یک یا چند نوع دستگاه تأیید شده باشد، و درستی‌سنجی نمانام برای OAuth تکمیل شده باشد، در وضعیت درستی‌سنجی‌شده قرار خواهد گرفت. این وضعیت برای راه‌اندازی برنامه در تولید الزامی است:

  • محدودیت‌های کاربر آزمایشی دیگر اعمال نمی‌شود. هر کاربری می‌تواند به برنامه اجازه دهد.
  • کاربر فقط می‌تواند به انواع دستگاهی که در Developer Console تأیید شده‌اند اجازه دسترسی بدهد.

روی اجازه دادن به دسترسی به خانه انتخابی تک‌ضرب بزنید:

  • اگر خانه‌ای به حسابتان متصل است، خانه‌ای را برای اعطای اجازه انتخاب کنید. اگر هیچ دستگاهی در خانه انتخابی پیدا نشد، می‌توانید:
    1. برای انتخاب خانه دیگر، روی اجازه دسترسی به خانه دیگر تک‌ضرب بزنید.
    2. دستگاه انتخابی‌تان را در آن خانه بااستفاده از Google Home app (GHA) راه‌اندازی کنید. به‌خاطر داشته باشید که فقط این نوع دستگاه‌ها در این «برنامه نمونه» از کنترل پشتیبانی می‌کنند:
      • چراغ دمای رنگ (روشن و خاموش، روشنایی)
      • حسگر تماسی (وضعیت بولی)
      • چراغ کم‌نورشدنی (روشن و خاموش، روشنایی)
      • قفل در
      • Extended Color Light (روشن و خاموش، روشنایی)
      • کلید عمومی
      • رهیاب مرزی Google
      • دوربین Google
      • Google Doorbell
      • حسگر حضور در خانه (تشخیص حضور در خانه)
      • روشن/خاموش کردن چراغ (روشن و خاموش، روشنایی)
      • کلید روشن/خاموش چراغ
      • واحد افزایه روشن/خاموش (روشن و خاموش)
      • حسگر روشن/خاموش
  • اگر خانه‌ای به حسابتان متصل نباشد، صفحه‌ای با این پیام دریافت خواهید کرد: هیچ ساختاری برای حساب انتخاب‌شده وجود ندارد.
    1. برای برگشتن به نمای اصلی «برنامه نمونه»، تند به عقب بکشید.
    2. برای راه‌اندازی خانه، از GHA استفاده کنید. سپس دوباره سعی کنید به «برنامه نمونه» اجازه دهید.

هرزمان بخواهید می‌توانید با انتخاب نماد نمایه در بالا سمت چپ هریک از صفحه‌های «برنامه نمونه»، به جریان اجازه‌ها برگردید.

انتخاب ساختاری که «برنامه نمونه» در آن اجرا شود.
شکل ۱: انتخاب ساختار
ساختار انتخاب‌شده، دستگاه‌های دردسترس را نشان می‌دهد.
شکل ۲: ساختار و دستگاه‌ها
تنظیمات کنترل برای دستگاه.
شکل ۳: کنترل‌های دستگاه
ساختمان انتخاب‌شده، که خودکارسازی‌های دردسترس را نشان می‌دهد.
شکل ۴: ساختار و خودکارسازی‌ها

پس‌از اینکه باموفقیت به خانه‌ای که دارای دستگاه است اجازه دادید، به نمای دستگاه‌ها هدایت خواهید شد. می‌توانید دستگاه‌ها را کنترل کنید و تغییرات وضعیت آن‌ها را ازطریق «برنامه نمونه» مشاهده کنید.