مجموعه تست Google Home

SDK خانه محلی ابری به ابری

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

برای استفاده از Test Suite و ارسال نتایج تست‌های خود به گوگل برای صدور گواهینامه، به صفحه اقدامات خانه هوشمند تست و اشتراک‌گذاری مراجعه کنید. این نسخه از Test Suite مخصوصاً برای توسعه و تضمین کیفیت است.

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

  • بررسی می‌کند که آیا Report State و Request Sync برای دستگاه‌ها و ویژگی‌های شما پیاده‌سازی شده‌اند یا خیر.

  • تأیید می‌کند که هدف QUERY برای دستگاه شما پیاده‌سازی شده است و نتایج آن با نتایج Report State مطابقت دارد.

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

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

اقدام خود را خودآزمایی کنید

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

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

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

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

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

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

  4. پیکربندی تنظیمات تست :

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

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

    3. اگر از Scene trait استفاده می‌کنید، Test Scene trait را انتخاب کنید.

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

      1. «تحویل محلی» یا «راه‌اندازی یکپارچه» را انتخاب کنید.
      2. اگر دستگاه می‌تواند درخواست کوئری را به صورت محلی مدیریت کند، روی گزینه Supports Local Query کلیک کنید.

  5. اجرای آزمایشی (Test Run) و مشاهده نتایج:

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

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

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

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

تست اعتبارسنجی اتصال حساب کاربری

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

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

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

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

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

پیام‌های خطا

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

پیام خطا چگونه حل کنیم
API مربوط به HomeGraph قبلاً در پروژه <_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. آدرس ایمیل اصلی حساب گوگل خود را ببینید
      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. تمام فیلدهای مورد نیاز را پر کنید، سپس روی ارسال کلیک کنید.