تاریخچه ویرایشهای

این صفحه تاریخچه ویرایش اسناد زیر را ارائه می‌دهد:

۲۵ آگوست ۲۰۲۶

  • الزامات اعتماد و ایمنی به‌روزرسانی شد تا سیاست محتوای تکراری (بخش ۲.۲) اضافه شود که محتوای اصلی، مجاز یا دارای مجوز را الزامی می‌کند و ساخت بازی‌های تکراری را ممنوع می‌کند.

۲۴ آگوست ۲۰۲۶

۱۱ ژوئیه ۲۰۲۴

  • الزامات فنی را در چندین صفحه بازنویسی کرد.
  • پاکسازی الزامات و حذف موارد تکراری.

۲۴ ژوئن ۲۰۲۴

محدودیت حجم کل بسته از ۱۰۰ مگابایت به ۲۵۰ مگابایت افزایش یافت و راهنمای بارگذاری کند (lazy loading guide) اضافه شد.

۱۷ ژوئن ۲۰۲۴

به‌روزرسانی‌های مجموعه تست:

  • بازی‌ها دیگر نیازی به ارائه از طریق HTTPS ندارند و می‌توانند برای آزمایش از طریق localhost ارائه شوند.
  • دکمه‌ی به‌روزرسانی (Refresh) در کنار فیلد URL اضافه شد تا محتوای iframe بدون بارگذاری مجدد کل مجموعه‌ی تست (Test Suite) به‌روزرسانی شود.

۱۶ مه ۲۰۲۴

بهترین شیوه‌های طراحی را به یک سند جداگانه منتقل کنید تا بتوانید بین الزامات طراحی و بهترین شیوه‌ها تمایز بهتری قائل شوید.

۸ مه ۲۰۲۴

سایت توسعه‌دهنده Playables را برای گسترش دسترسی و بهبود ناوبری، بازسازی کردیم.

۷ مه ۲۰۲۴

« الزامات فنی برای اعلان آماده بودن بازی» با جزئیات بیشتر برای فراخوانی firstFrameReady به‌روزرسانی شد.

۳ مه ۲۰۲۴

  • آرشیوی از نسخه‌های قبلی الزامات ایجاد شد.

۵ مارس ۲۰۲۴

محدودیت حجم هر فایل از ۱۰ مگابایت به ۳۰ مگابایت افزایش یافت.

۲۳ فوریه ۲۰۲۴

مقدار بولی IN_PLAYABLES_ENV به فضای نام سطح بالا اضافه شد تا به توسعه‌دهندگان اطلاع دهد که بازی‌شان چه زمانی در محیط Playables اجرا می‌شود.

۴ دسامبر ۲۰۲۳

به‌روزرسانی‌های مجموعه تست

  • بررسی کاراکترهای پشتیبانی نشده در نام فایل‌ها اضافه شد.
    • برای اطلاعات مربوط به کاراکترهای پشتیبانی‌شده، به الزامات فنی - نام فایل‌ها ۱.۹ مراجعه کنید.
    • محدودیت شناخته‌شده: این بررسی ممکن است تمام منابع بارگذاری‌شده را اعتبارسنجی نکند.
  • قابلیت شبیه‌سازی صفحه بارگذاری اضافه شد، از جمله تنظیم ارتفاع اولیه iframe روی ۰.
  • دکمه مکث-ادامه به‌روزرسانی شد تا با تغییر وضعیت صدا هنگام مکث و ازسرگیری، با تولید هماهنگ‌تر شود.
  • پیام‌های غیرقابل پیگیری از ثبت رویدادها حذف شدند.

۱۰ نوامبر ۲۰۲۳

بسته نرم‌افزاری Test Suite قابل دانلود با Test Suite میزبانی‌شده جایگزین شده است.

فایل تعاریف نوع TypeScript که قبلاً در بسته Test Suite موجود بود، به مقاله اصلی Playables SDK منتقل شده است.

۷ سپتامبر ۲۰۲۳

بخش « شروع به کار» به‌روزرسانی شده است تا آدرس اینترنتی کیت توسعه‌دهندگان Playables SDK از v0 به v1 تغییر کند.

۳۰ آگوست ۲۰۲۳

بخش‌های نام فایل‌ها و تصاویر کوچک به‌روزرسانی شده‌اند تا ارجاعات حذف شوند و کاراکترهای ویژه مجاز ( _ ، - ، . ) به طور صریح فهرست شوند.

علاوه بر این، بخش ذخیره ابری به‌روزرسانی شده است تا ذخیره ابری در نسخه‌های جدید بازی نیز کار کند.

۲۵ آگوست ۲۰۲۳

بخش saveData به‌روزرسانی شده است تا مشخص شود که داده‌های ذخیره شده باید یک رشته UTF-16 معتبر و خوش‌فرم باشند.

۱۸ آگوست ۲۰۲۳

بخش «مکث و از سرگیری» به‌روزرسانی شده است تا مشخص شود که بازی باید تمام اجراها را پس از فراخوانی onPause متوقف کند و فقط پس از فراخوانی onResume از سر بگیرد.

۱۱ آگوست ۲۰۲۳

بخش نام فایل‌ها اضافه شده است تا محدودیت‌های کاراکتری مورد استفاده برای نامگذاری فایل‌ها در بسته بازی را شامل شود.

۱۰ آگوست ۲۰۲۳

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

۹ آگوست ۲۰۲۳

بخش تصاویر بندانگشتی اضافه شده است تا الزامات مربوط به تصاویر بندانگشتی بازی را فهرست کند و به کاربران اجازه دهد به راحتی یک تصویر قابل پخش در یوتیوب را کشف و شناسایی کنند.

۸ آگوست ۲۰۲۳

بخش حرکات و ورودی‌ها به‌روزرسانی شده است تا بازی را از فراخوانی preventDefault() در رویدادهای Esc منع کند.

علاوه بر این، یک بخش جدید برای ارجاع به فایل‌ها اضافه شده است تا بازی‌ها را ملزم کند هنگام ارجاع به سایر فایل‌های موجود در بسته، فقط از مسیرهای نسبی استفاده کنند، زیرا استفاده از مسیرهای مطلق می‌تواند باعث خطا شود.

۲ آگوست ۲۰۲۳

بخش بی‌صدا کردن صدا در هر دو بخش الزامات فنی و دستورالعمل‌های طراحی بازی قابل بازی به‌روزرسانی شده است تا به ویژگی‌های بی‌صدا کردن و بی‌صدا کردن به عنوان کنترل‌های صوتی اشاره کند و نشان دهد که کنترل‌های صوتی جزئی ممکن است شامل لغزنده‌های صدا یا دکمه بی‌صدا کردن یا هر دو باشند.

۲۸ ژوئیه ۲۰۲۳

مستندات راهنمای طراحی بازی Playables به‌روزرسانی شده است تا نحوه‌ی بیان مطالب استاندارد شده و بهترین شیوه‌ها و تصاویر (اسکرین‌شات‌ها) به‌روزرسانی شوند.

۲۰ ژوئیه ۲۰۲۳

بخش مکث و از سرگیری (Pause and resume) برای ارائه قابلیت‌های مکث و از سرگیری بین پلتفرمی اضافه شده است.

۱۹ ژوئیه ۲۰۲۳

سایت YouTube Playables اکنون شامل مستندات دستورالعمل‌های طراحی بازی Playables است تا به عنوان راهنمایی در ارائه یک تجربه بازی بهینه برای کاربرانی که بازی‌های YouTube را در دستگاه‌ها و پلتفرم‌های مختلف انجام می‌دهند، عمل کند.

دستورالعمل‌های طراحی بازی بر حوزه‌های زیر تمرکز دارند:

  • تصاویر بندانگشتی
  • تطبیق دستگاه
  • رابط کاربری (UI)
  • حرکات و ورودی
  • مکث
  • بی‌صدا کردن
  • بازخورد لمسی
  • کاربرپسند بودن (onboarding)
  • پایان بازی (صفحه برنده)
  • دسترسی‌پذیری

علاوه بر این، بخش onAudioEnabledChange به‌روزرسانی شده است تا یک خطای تایپی کوچک در کد که باعث ایجاد خطا در لایه قابلیت همکاری جاوا اسکریپت پیشنهادی فلاتر (JS-Interop) می‌شد، برطرف شود.

۱۴ ژوئیه ۲۰۲۳

بخش اندازه به شرح زیر به‌روزرسانی شده است:

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

۱۱ ژوئیه ۲۰۲۳

بخش Flutter web (آزمایشی) برای فعال کردن ادغام با بازی‌های نوشته شده با Flutter Web اضافه شده است.

۱ ژوئیه ۲۰۲۳

بخش غیرفعال کردن Mute (بی‌صدا کردن) از بازی می‌خواهد که تنظیمات صوتی یوتیوب و سیستم را رعایت کند و صدای بازی نباید به طور غیرمنتظره پخش شود.

علاوه بر این، بخش تکمیل مدیریت محتوا توضیح می‌دهد که بازی باید به کاربر اطلاع دهد که دیگر محتوایی برای تعامل وجود ندارد، مثلاً در مرحله نهایی یا تکمیل بازی.

۳۰ ژوئن ۲۰۲۳

بخش شروع به کار اکنون شامل یادداشتی است که نشان می‌دهد وقتی بازی به صورت محلی ارائه می‌شود، SDK غیرفعال خواهد بود. برای تأیید صحت ادغام SDK، به SDK Test Suite مراجعه کنید.

۲ ژوئن ۲۰۲۳

سایت YouTube Playables اکنون شامل مستندات Playables SDK است که مجموعه‌ای قوی از APIها را برای پشتیبانی از بازی‌های YouTube ارائه می‌دهد.

۲۶ مه ۲۰۲۳

به‌روزرسانی‌های مستندات الزامات فنی به شرح زیر است:

بخش تغییرات
زمان بارگذاری میانگین سرعت اینترنت در سراسر جهان ۶.۸ مگابیت بر ثانیه و برای ایالات متحده ۲۰ مگابیت بر ثانیه است.
روش‌های تعامل اضافه شده است که وقتی کاربر با بازی تعامل می‌کند، بازی نباید ناخواسته ورودی را به تأخیر بیندازد یا نادیده بگیرد.
ریز عکس‌ها وضوح تصویر مورد نیاز برای نسبت‌های ۱:۱، ۵:۷ و ۱۶:۹ به‌روزرسانی شد.
اطلاعات ناشر یا توسعه‌دهنده این بخش جدید اضافه شده است که الزام می‌کند بازی شامل نام ناشر یا توسعه‌دهنده باشد و ممکن است در آینده ملزم به ارائه رتبه‌بندی محتوا نیز باشد.
بارگذاری SDK مربوط به Playables این بخش جدید اضافه شده که بازی را ملزم می‌کند قبل از هر کد بازی دیگری، Playables SDK را بارگذاری کند.
اعلان آماده بودن بازی به‌روزرسانی شده است تا API firstFrameReady فقط زمانی فراخوانی شود که اولین فریم بازی شما آماده رندر شدن روی صفحه باشد و API gameReady فقط زمانی فراخوانی شود که بازی برای هرگونه تعامل با کاربر آماده باشد.
ضامن بی‌صدا کردن اضافه شد که وقتی بی‌صدا کردن یوتیوب تنظیم می‌شود، صدا نباید پخش شود و کنترل‌های بی‌صدا کردن یا قطع کردن صدای بازی نباید روی خروجی صدا تأثیر بگذارند.

۲۴ مارس ۲۰۲۳

سایت YouTube Playables اکنون شامل مستندات الزامات فنی است که هدف آن ارائه یک تجربه بازی روان برای کاربرانی است که در YouTube بازی می‌کنند.

بخش الزامات فنی بر حوزه‌های زیر تمرکز دارد:

  • پایداری بازی
  • تجربه یوتیوب
  • ادغام یوتیوب
  • محلی سازی
  • کسب درآمد