الزامات یکپارچه سازی

این بخش به ادغام بین Playable و SDK مربوط به YouTube Playables می‌پردازد.

۱- بارگذاری SDK مربوط به Playables

۲ اعلان آماده بودن بازی

  • بازی باید تابع firstFrameReady را فراخوانی کند، چه زمانی که بازی در حال رندر کردن صفحه بارگذاری یا صفحه شروع است که به صراحت به کاربر اطلاع می‌دهد که فرآیند بارگذاری در حال انجام است.
  • بازی باید تابع gameReady فراخوانی کند و فقط زمانی که بازی برای تعامل با کاربر آماده است (مثلاً: منوی اصلی یا بازی آماده اجرا است) باید تابع gameReady فراخوانی کند.
  • بازی نباید در حالی که هنوز عناصر غیرقابل تعاملی به کاربر نمایش داده می‌شوند (مثلاً صفحات شروع یا صفحات بارگذاری) تابع gameReady فراخوانی کند.

یوتیوب تا زمانی که این API فراخوانی نشود، «چرخنده‌ی بارگذاری» را حذف نمی‌کند.

۳ امتیاز کاربر

  • بازی ممکن است sendScore برای ارسال امتیاز کاربر استفاده کند.
  • اگر بازی sendScore برای ارسال امتیازها استفاده می‌کند، باید به مشخصات sendScore پایبند باشد و باید اطمینان حاصل کند که بهترین امتیاز ارسالی با بهترین امتیاز ذخیره شده در بازی مطابقت دارد.

۴ ذخیره ابری

  • بازی باید زمانی که کاربران پیشرفت قابل توجهی در بازی داشته‌اند (مثلاً تغییر سطح) و مکانیک‌های بازی باعث می‌شوند کاربر باور کند که پیشرفتش ذخیره شده است، برای ذخیره پیشرفت، saveData فراخوانی کند.
  • بازی نباید از هیچ مکانیزم دیگری برای ذخیره پیشرفت کاربر استفاده کند. این ویژگی به بازیکنان امکان می‌دهد بازی را بعداً از سر بگیرند.
  • بازی باید قبل از فراخوانی saveData منتظر loadData بماند. اگر saveData قبل از اتمام موفقیت‌آمیز loadData فراخوانی شود، درخواست رد خواهد شد. این کار از بازنویسی داده‌های ذخیره شده قبلی توسط بازی جلوگیری می‌کند.
  • بازی باید بتواند از داده‌های ذخیره ابری نسخه‌های قبلی بازی بدون خطا یا خرابی استفاده کند.
  • بازی باید از داده‌های ذخیره ابری برای حفظ پیشرفت کاربر در تمام نسخه‌های بازی که کاربر انتظار دارد از داده‌های او استفاده شود، استفاده کند.
  • بازی‌ها باید به طور خودکار پیشرفت کاربر را در مراحل مهم بازی ذخیره کنند تا از از دست رفتن داده‌ها جلوگیری شود. ذخیره نهایی زمانی انجام می‌شود که کاربر از بازی خارج می‌شود، اما بهترین کار این است که حداکثر تا ۶۴ کیلوبایت محتوا را ذخیره کنید.

۵- دکمه بی‌صدا کردن

  • بازی باید تنظیمات صدای سیستم و دکمه بی‌صدا کردن را رعایت کند.
  • بازی باید با استفاده از isAudioEnabled و onAudioEnabledChange ، تنظیمات صدای یوتیوب و دکمه بی‌صدا کردن را رعایت کند.
  • بازی باید به کنترل صدا روی دستگاه احترام بگذارد.
  • صدای بازی نباید به طور غیرمنتظره پخش شود.
  • وقتی بی‌صدا کردن یوتیوب تنظیم شده است، صدا نباید پخش شود و کنترل‌های صدای بازی نباید روی خروجی صدا تأثیر بگذارند.
  • وقتی بی‌صدا کردن یوتیوب تنظیم نشده باشد، کنترل‌های صدای بازی ممکن است بر خروجی صدا تأثیر بگذارند.
  • بازی نباید یک دکمه بی‌صدا کردن کلی در خود بازی داشته باشد؛ به کاربران اجازه دهید برای این کار به ویژگی‌های سطح یوتیوب تکیه کنند.
  • ممکن است بازی کنترل‌های صوتی جداگانه‌ای، مانند موسیقی و جلوه‌های صوتی، در بازی داشته باشد، اما باید از سایر الزامات کنترل صدا پیروی کند.

تنظیمات مختلف صدا برای پس‌زمینه، جلوه‌های ویژه، دیالوگ‌ها

۶- مکث و ادامه

کیت توسعه نرم‌افزار Playables، فراخوانی‌هایی برای قابلیت‌های مکث و از سرگیری بین پلتفرمی ارائه می‌دهد.

  • بازی باید پس از فراخوانی onPause تمام اجراها را متوقف کند و فقط زمانی که onResume فراخوانی شود، باید اجرا را از سر بگیرد. اجرا شامل تمام قابلیت‌های قابل پخش، مانند حلقه بازی، موسیقی، تعاملات، فراخوانی‌های شبکه و رندرینگ می‌شود.
  • بازی نباید از API وب Page Visibility یا APIهای وب مشابه استفاده کند و فقط باید از Playables SDK onPause و onResume استفاده کند.
  • بازی باید هنگام وقوع onPause پیشرفت کاربر را ذخیره کند.