قبل از ادامهی تأیید حساب، مطمئن شوید که موارد زیر را دارید:
- Google Home app (GHA) که روی دستگاه همراه اندروید شما نصب شده باشد، و حداقل یک خانه (سازه) در حساب گوگل شما تنظیم شده باشد.
- حداقل یکی از این انواع دستگاههای پشتیبانیشده برای برنامه نمونه در خانه:
- دمای رنگ نور (روشن و خاموش، روشنایی)
- سنسور تماسی (حالت بولی)
- چراغ قابل تنظیم (روشن و خاموش، روشنایی)
- نور رنگی گسترده (روشن و خاموش، روشنایی)
- سوئیچ عمومی
- دوربین گوگل
- حسگر حضور (حسگر حضور)
- روشن/خاموش کردن چراغ (روشن و خاموش، روشنایی)
- کلید روشن/خاموش چراغ
- واحد دوشاخه روشن/خاموش (روشن و خاموش)
- سنسور روشن/خاموش
- دو دستگاه برای آزمایش اتوماسیون نمونه.
قبل از استفاده از دستگاهها از طریق APIهای Home، آنها باید از GHA قابل کنترل باشند.
اجرای برنامه نمونه اندروید
برنامه نمونه اندروید را اجرا کنید. اولین باری که آن را اجرا میکنید، از شما خواسته میشود که به حساب گوگل خود اجازه دسترسی به یک خانه را بدهید. این به برنامه نمونه اجازه میدهد تا به ساختارها و دستگاههای موجود در آن خانه دسترسی داشته باشد و آنها را کنترل کند.
رفتار پیشفرض دسترسیهای برنامه بسته به اینکه آیا برنامه در Google Home Developer Console ثبت شده است یا خیر، متفاوت خواهد بود.
اگر برنامهای در Developer Console ثبت نشده باشد ، در حالت تأیید نشده قرار خواهد گرفت. این حالت برای آزمایش استفاده از رابطهای برنامهنویسی کاربردی خانگی (Home APIs) توصیه میشود:
فقط کاربرانی که به عنوان کاربر آزمایشی در کنسول OAuth ثبت نام کردهاند میتوانند مجوزهای لازم را برای برنامه اعطا کنند. برای یک برنامه تأیید نشده، محدودیت ۱۰۰ کاربر آزمایشی وجود دارد.
یک برنامهی تأیید نشده به دستگاههایی از هر نوع که توسط OAuth برای رابطهای برنامهنویسی کاربردی خانگی (لیست انواع دستگاهها در Developer Console ) پشتیبانی میشوند، دسترسی خواهد داشت. به تمام دستگاههای موجود در یک ساختار، این دسترسی اعطا خواهد شد.
اگر برنامهای در Developer Console ثبت شده باشد و برای دسترسی به یک یا چند نوع دستگاه تأیید شده باشد، و تأیید برند برای OAuth تکمیل شده باشد ، در حالت تأیید شده قرار خواهد گرفت. این حالت برای راهاندازی یک برنامه در محیط عملیاتی ضروری است:
- محدودیتهای کاربر آزمایشی دیگر اعمال نمیشود. هر کاربری میتواند به برنامه مجوز بدهد.
- کاربر فقط میتواند به انواع دستگاههایی که در Developer Console تأیید شدهاند، مجوز بدهد.
روی اجازه دسترسی به خانه انتخاب شده ضربه بزنید:
- اگر خانهای به حساب شما متصل است، خانهای را برای اعطای مجوز انتخاب کنید. اگر هیچ دستگاهی در خانه انتخاب شده یافت نشد، میتوانید یکی از موارد زیر را انجام دهید:
- برای انتخاب خانهای دیگر، روی «اجازه دسترسی به خانه دیگر» ضربه بزنید.
- با استفاده از Google Home app (GHA) یک دستگاه به دلخواه خود را در آن خانه راهاندازی کنید. به یاد داشته باشید، فقط این نوع دستگاهها از کنترل در این برنامه نمونه پشتیبانی میکنند:
- دمای رنگ نور (روشن و خاموش، روشنایی)
- سنسور تماسی (حالت بولی)
- چراغ قابل تنظیم (روشن و خاموش، روشنایی)
- نور رنگی گسترده (روشن و خاموش، روشنایی)
- سوئیچ عمومی
- دوربین گوگل
- حسگر حضور (حسگر حضور)
- روشن/خاموش کردن چراغ (روشن و خاموش، روشنایی)
- کلید روشن/خاموش چراغ
- واحد دوشاخه روشن/خاموش (روشن و خاموش)
- سنسور روشن/خاموش
- اگر هیچ خانهای به حساب شما متصل نباشد، صفحهای با پیام « هیچ ساختاری برای حساب انتخاب شده وجود ندارد» دریافت خواهید کرد.
- برای بازگشت به نمای اصلی برنامه نمونه، انگشت خود را به عقب بکشید.
- برای راهاندازی خانه، از GHA استفاده کنید. سپس دوباره سعی کنید به برنامه Sample اجازه دسترسی بدهید.
جریان مجوزها را میتوان در هر زمانی با انتخاب آیکون پروفایل در بالا سمت راست هر صفحه برنامه نمونه، مجدداً بررسی کرد.
پس از اینکه با موفقیت به خانهای که دارای دستگاهها است اجازه دادید، به نمای دستگاهها منتقل میشوید. میتوانید دستگاهها را کنترل کرده و تغییرات وضعیت آنها را از طریق برنامه نمونه مشاهده کنید.