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

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

مهم: الزامات ترجمه شده فقط برای مرجع ارائه شده است. برای راهنمایی قطعی به نسخه های انگلیسی الزامات مراجعه کنید.

1 SDK قابل پخش را بارگیری کنید

• بازی باید SDK Playables YouTube را قبل از هر کد بازی بارگیری کند.

2 اعلان آماده بازی

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

تا زمانی که این API فراخوانی نشود، YouTube "در حال بارگذاری" را حذف نمی کند.

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

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

4 ذخیره ابری

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

5 خاموش کردن

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

6 مکث کنید و از سر بگیرید

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

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