کیت توسعه نرمافزاری YouTube Playables یک کیت توسعه نرمافزاری وب برای اتصال بازیهای وب به محیط یوتیوب است. این کیت توسعه نرمافزاری دارای یک API قوی برای پشتیبانی از بازیها به روشهای مختلف است تا یک تجربه بازی عالی در یوتیوب ایجاد کند.
کیت توسعه نرمافزار Playables را به بازی خود اضافه کنید
یک بازی باید یک فایل 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 })- بهترین امتیاز را برای نمایش به یوتیوب ارسال میکند. -
ytgame.engagement.openYTContent({ id: videoID })- یک ویدیوی YouTube را باز کنید. -
ytgame.health.logError()وytgame.health.logWarning()- مشکلات را در YouTube ثبت میکند.
برای جزئیات پیادهسازی و عملکردهای اضافی ، مرجع Playables SDK را بررسی کنید.
تعاریف نوع در تایپاسکریپت
برای بازیهایی که از TypeScript استفاده میکنند، تعاریف نوع را دانلود کنید .
بازیهای نمونه
نمونههایی موجود است که نحوه ادغام با SDK مربوط به YouTube Playables، از جمله جاوا اسکریپت ساده، Flutter web، Godot و Unity را نشان میدهد.
بازی خود را با مجموعه تست آزمایش کنید
پس از آماده شدن، میتوانید یکپارچهسازی خود را با استفاده از مجموعه تست اعتبارسنجی کنید. برای یادگیری نحوهی انجام این کار، راهنمای مجموعه تست را دنبال کنید.