مجموعه آزمون 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 هستید، مطمئن شوید گزینه همگام‌سازی درخواست آزمایش فعال باشد—درطول آزمایش، از شما خواسته می‌شود دستگاهی را اضافه کنید، به‌روز کنید، یا بردارید و بررسی کنید فهرست دستگاه در «نمودار خانه» تغییر کرده است یا نه. تغییر کنش‌ها ازطریق یکپارچه‌سازی که درحال آزمایش آن هستید انجام می‌شود. ادغام شما درحال آزمایش باید همیشه حداقل یک دستگاه متصل به کاربر کارگزار داشته باشد.

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

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

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

  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 را با {"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. همه فیلدهای الزامی را تکمیل کنید، سپس روی ارسال کلیک کنید.

    .