مجموعه آزمون Google Home

ابر به ابر    کیت توسعه نرم‌افزار Local Home

Google Home Test Suite برنامه وبی است که به شما امکان می‌دهد «کنش» خانه هوشمندتان را خودآزمایی کنید. Test Suite به‌طور خودکار چارچوب‌های تست را براساس دستگاه‌ها و ویژگی‌های مرتبط با حسابتان تولید و اجرا می‌کند. وقتی آزمایش‌ها را تکمیل کردید، می‌توانید نتایج آزمایش را مشاهده کنید.

برای استفاده از Test Suite و ارسال نتایج آزمایش به Google برای دریافت گواهینامه، به صفحه آزمایش و هم‌رسانی «کنش‌های خانه هوشمند» مراجعه کنید. این نسخه از Test Suite به‌طور خاص برای توسعه و تضمین کیفیت است.

آزمایش‌های اجراشده توسط Test Suite شامل موارد زیر است، اما به آن‌ها محدود نمی‌شود:

  • بررسی می‌کند که گزارش وضعیت و درخواست همگام‌سازی برای دستگاه‌ها و ویژگی‌های شما پیاده‌سازی شده باشد.

  • تأیید می‌کند که قصد QUERY برای دستگاهتان پیاده‌سازی شده است و نتایج آن با نتایج «گزارش وضعیت» مطابقت دارد.

با کلیک کردن روی دکمه زیر می‌توانید ابزار Test Suite را راه‌اندازی کنید:

راه‌اندازی Test Suite

خودآزمایی «کنش»

بخش زیر نحوه اجرای Test Suite را در دستگاه و پروژه «کنش خانه هوشمند» شما شرح می‌دهد. Test Suite از شما می‌خواهد به سیستم وارد شوید تا بتواند دستگاه‌های موجود در Google Home Graph شما را بازرسی کند و مستقیماً به Google Assistant فرمان ارسال کند.

برای خودآزمایی «کنش»، این مراحل را دنبال کنید:

  1. در مرورگر وب، Test Suite را باز کنید.

  2. بااستفاده از دکمه گوشه بالا، به سیستم Google وارد شوید.

  3. جزئیات پروژه را پیکربندی کنید:

    1. در فیلد شناسه پروژه، شناسه پروژه را برای «کنش» خانه هوشمندتان وارد کنید.
    2. روی بعدی کلیک کنید.

  4. تنظیمات آزمایش را پیکربندی کنید:

    1. اگر ادغام Cloud-to-cloud را تأیید می‌کنید، مقدار پیش‌فرض زمان اتمام درخواست همگام‌سازی/گزارش وضعیت را تغییر ندهید. بااین‌حال، برای آزمایش، اگر نماینده شما زمان بیشتری برای گزارش وضعیت به Home Graph نیاز دارد، می‌توانید مقدار زمان‌اتمام را تغییر دهید.

    2. اگر ادغام Cloud-to-cloud را تأیید می‌کنید، مطمئن شوید گزینه همگام‌سازی درخواست آزمایشی فعال باشد—درطول آزمایش، از شما خواسته می‌شود دستگاهی را اضافه، به‌روزرسانی، یا حذف کنید و بررسی کنید که آیا فهرست دستگاه در Home Graph تغییر کرده است یا نه. کنش‌های تغییر ازطریق یکپارچه‌سازی‌ای که درحال آزمایش آن هستید انجام می‌شود. ادغام تحت آزمایش شما باید همیشه حداقل یک دستگاه متصل به کاربر نماینده داشته باشد.

    3. اگر از ویژگی Scene استفاده می‌کنید، ویژگی صحنه آزمایشی را انتخاب کنید.

    4. اگر مجموعه آزمون را برای دستگاه‌های Local Home اجرا می‌کنید، از کیت توسعه نرم‌افزار Local Home پشتیبانی می‌کند را انتخاب کنید.

      1. Local Fulfillment (تحقق محلی) یا Seamless Setup (راه‌اندازی یکپارچه) را انتخاب کنید.
      2. اگر دستگاه می‌تواند هدف پرس‌وجو را به‌صورت محلی مدیریت کند، روی پشتیبانی از پرس‌وجوی محلی کلیک کنید.

  5. اجرای آزمایشی را انجام دهید و نتایج را مشاهده کنید:

    1. روی بعدی کلیک کنید تا اجرای آزمایش‌ها شروع شود. رابط دستگاه‌ها و ویژگی‌هایی را که درحال آزمایش هستند نشان می‌دهد.

  6. صفحه نتایج و ارسال را مشاهده کنید:

    1. پس‌از تکمیل آزمایش‌ها، برای مشاهده نتایج روی بعدی کلیک کنید.

نتایج آزمایش شامل تعداد آزمایش‌های موفق و ناموفق و امتیاز نهایی است که درصد آزمایش‌های موفق را نشان می‌دهد.

آزمون اعتبارسنجی پیونددهی حساب

پیوند دادن حساب نقش مهمی در بوم‌سازگان خانه هوشمند Google ایفا می‌کند. آزمایش اعتبارسنجی پیوند حساب در Test Suite سرویس OAuth شما را برای مشکلات احتمالی بررسی می‌کند.

آزمون اعتبارسنجی پیونددهی حساب شامل آزمون‌هایی برای اعتبارسنجی کدهای دسترسی و ژتون‌های بازآوری است:

آزمایش اعتبارسنجی کد دسترسی

کدهای دسترسی برگردانده‌شده از نقطه پایانی تبادل کد شما آزمایش می‌شوند تا اطمینان حاصل شود که قالب معتبری دارند و با کد بازآوری معتبری برگردانده می‌شوند.

موارد آزمایشی توضیح
بررسی کنید که آیا کد دسترسی در قالب JWT است «پیوند حساب Google» کد دسترسی با قالب JWT را توصیه نمی‌کند. اگر قالب JWT پیدا شود، هشدار زیر نمایش داده می‌شود: The access token seems to be JWT, this is not good. Because it unnecessarily exposes information about partner implementation and we recommend opaque symmetric encrypted access token.
بررسی کنید که کد دسترسی منقضی‌شدنی دارای کد بازآوری باشد. وقتی کد دسترسی منقضی‌شدنی باشد، باید کد بازآوری ارائه شود. اگر ژتون بازآوری پیدا نشود، این آزمایش ناموفق خواهد بود.

آزمایش اعتبارسنجی ژتون بازآوری

ژتون‌های بازآوری آزمایش می‌شوند تا اطمینان حاصل شود که نقطه پایانی تبادل ژتون شما به‌درستی آن‌ها را با ژتون‌های دسترسی جدید تبادل می‌کند.

موارد آزمایشی توضیح
بازآوری کردن ژتون با ژتون بازآوری نامعتبر، درحال بررسی پاسخ شریک. سرور شما باید خطای HTTP 400 Bad Request را با {"error": "invalid_grant"} به درخواست ژتون بازآوری نامعتبر برگرداند. اگر پاسخ با «کد یا پیام خطا» مطابقت نداشته باشد، این چارچوب تست رد خواهد شد. برای اطلاعات بیشتر، به تبدیل ژتون‌های بازآوری به کد دسترسی مراجعه کنید.
آزمایش کنید که آیا کد دسترسی پس‌از بازآوری کد به‌روز شده است یا نه. کدهای دسترسی جدید باید در پاسخ به درخواست‌های کد بازآوری برگردانده شوند. اگر سرور شما همان کد دسترسی را ارائه دهد، چارچوب تست رد خواهد شد.
بررسی کنید که آیا کد دسترسی منقضی‌نشده هنوز معتبر است یا نه. زمان انقضای کد دسترسی نمایش داده خواهد شد.
بررسی کنید که آیا ژتون بازآوری درطول بازآوری کردن چرخانده شده است یا نه. بررسی می‌کنیم که آیا ژتون‌های بازآوری پس‌از درخواست ژتون بازآوری تغییر کرده‌اند یا نه. اگر ژتون بازآوری تغییر کند، سرور شما باید فقط پس‌از استفاده از ژتون بازآوری جدید، ژتون بازآوری قدیمی را باطل کند تا از شرایط رقابتی که ممکن است پیوند حساب کاربر را قطع کند جلوگیری شود. اگر ژتون بازآوری قدیمی را قبل‌از استفاده از ژتون جدید باطل کنید، آزمایش ناموفق خواهد بود.

پیام‌های خطا

جدول زیر برخی‌از پیام‌های خطای رایجی را که ممکن است با آن‌ها مواجه شوید و روش پیشنهادی برای حل آن‌ها را فهرست می‌کند.

پیام خطا نحوه حل کردن
HomeGraph API قبلاً در پروژه <_id_> استفاده نشده است یا غیرفعال است مطمئن شوید که HomeGraph API را فعال کرده‌اید.
نهاد درخواستی پیدا نشد بررسی کنید که agentUserId معتبر باشد و به سرویس شما پیوند شده باشد.

مطمئن شوید که اجازه resourcemanager.projects.get را در پروژه ${your project id} دارید و همه اجازه‌ها را در صفحه رضایت اعطا کرده‌اید.

خطا در دریافت داده‌های ماژول: خطای getModuleData: پاسخ ناموفق Http برای https://hometestsuiteproxy-pa.googleapis.com/v1/module:get: 403 OK 403
  1. دستورالعمل‌های عیب‌یابی اجازه‌های IAM را دنبال کنید تا مطمئن شوید حسابتان اجازه‌های resourcemanager.projects.get را برای پروژه دارد.
  2. به صفحه برنامه‌هایی که به حسابتان دسترسی دارند بروید تا اجازه‌های زیر را برای «مجموعه آزمون خانه هوشمند» بررسی کنید:
    • اطلاعات اصلی حساب
      1. دیدن نشانی ایمیل اصلی «حساب Google»
      2. دیدن اطلاعات شخصی شما، ازجمله هرگونه اطلاعات شخصی که دردسترس عموم قرار داده‌اید
    • دسترسی اضافی
      1. از Assistant خود استفاده کنید: دسترسی گسترده به حساب Google شما
      2. بازرسی و کنترل دستگاه‌های خانه هوشمند در Home Graph شما
    اگر خطای اجازه دریافت کردید، ابتدا دسترسی را بردارید و هنگام ورود مجدد به سیستم، همه اجازه‌ها را در صفحه رضایت اعطا کنید.

ارسال نتایج آزمایش

نتایج Test Suite شما باید قبل‌از ارسال برای صدور گواهینامه، ۱۰۰٪ آزمایش‌ها را با موفقیت پشت سر بگذارد. اگر ویژگی‌هایی دارید که به آزمایش دستی نیاز دارند، همچنان باید ابزار Test Suite را اجرا کنید و نتیجه را پیوست کنید، حتی اگر ۱۰۰٪ موفقیت‌آمیز نبوده باشد.

برای ارسال نتایج آزمایش و تأیید کردن ادغام Cloud-to-cloud، این مراحل را دنبال کنید:

  1. پس‌از دریافت نتایج آزمایش و زمانی که آماده تأیید ادغام Cloud-to-cloud بودید، روی ارسال در ابزار Test Suite کلیک کنید.
  2. به Google Home Developer Console > Cloud-to-cloud > گواهی کردن بروید.
  3. ادغامی را که می‌خواهید گواهی شود انتخاب کنید.
  4. در بخش اسناد، شناسه نتایج Test Suite را وارد کنید.

  5. همه فیلدهای الزامی را تکمیل کنید، سپس روی ارسال کلیک کنید.