YouTube Playables SDK یک وب SDK برای اتصال بازی های وب با محیط YouTube است. SDK دارای یک API قوی برای پشتیبانی از بازی ها به روش های مختلف برای ایجاد یک تجربه عالی از بازی در YouTube است.
Playables SDK را به بازی خود اضافه کنید
یک بازی باید یک فایل index.html در فهرست اصلی داشته باشد. با افزودن این خط قبل از هر کد بازی، SDK YouTube Playables را وارد کنید:
<script src="https://www.youtube.com/game_api/v1"></script>
زمانی که بازی شما به صورت محلی ارائه می شود، SDK به صورت بدون عملیات اجرا می شود. برای تأیید صحت ادغام SDK، از راهنمای مجموعه آزمایشی استفاده کنید.
ادغام با Playables SDK
چندین ادغام مورد نیاز و اختیاری با Playables SDK وجود دارد.
ادغام های مورد نیاز
الزامات انتشار را به طور کلی با تمرکز بر الزامات ادغام مرور کنید. مرجع Playables SDK را برای جزئیات پیاده سازی مرور کنید.
مثالها عبارتند از:
-
ytgame.game.firstFrameReady() -
ytgame.game.gameReady() -
ytgame.IN_PLAYABLES_ENV -
ytgame.system.isAudioEnabled() -
ytgame.system.onAudioEnabledChange((isAudioEnabled) => {}) -
ytgame.system.onPause(() => {}) -
ytgame.system.onResume(() => {}) -
ytgame.game.loadData() -
ytgame.game.saveData(data)
ادغام های توصیه شده
علاوه بر ادغام های مورد نیاز، چندین عملکرد دیگر برای ایجاد یک تجربه بسیار جذاب در دسترس هستند. مثالها عبارتند از:
-
ytgame.system.getLanguage()- از این برای بازیابی تنظیمات محلی فعلی کاربر استفاده کنید. از توابع دیگر استفاده نکنید یا زبان را در ذخیره ابری ذخیره نکنید، زیرا ممکن است در هر زمان تغییر کند. -
ytgame.engagement.sendScore({ value: newScore })- بهترین امتیاز را برای نمایش به YouTube ارسال کنید. -
ytgame.engagement.openYTContent({ id: videoID })- یک ویدیوی YouTube را باز کنید. -
ytgame.health.logError()وytgame.health.logWarning()- مشکلات را در YouTube ثبت کنید.
مرجع Playables SDK را برای جزئیات پیاده سازی و عملکردهای اضافی مرور کنید.
تعاریف نوع TypeScript
برای بازی هایی که از TypeScript استفاده می کنند، تعریف نوع را دانلود کنید .
نمونه بازی ها
نمونه‌هایی در دسترس هستند که نحوه ادغام با YouTube Playables SDK، از جمله جاوا اسکریپت ساده، Flutter web، Godot و Unity را نشان می‌دهند.
بازی خود را با مجموعه تست تست کنید
هنگامی که آماده شدید، می توانید با استفاده از مجموعه آزمایشی، ادغام خود را تأیید کنید. برای یادگیری نحوه انجام، راهنمای مجموعه آزمایشی را دنبال کنید.