SDK Ruang Game YouTube - Memulai

YouTube Playables SDK adalah SDK web untuk menghubungkan game web dengan lingkungan YouTube. SDK ini memiliki API yang andal untuk mendukung game dengan berbagai cara guna menciptakan pengalaman bermain game yang luar biasa di YouTube.

Menambahkan Playables SDK ke game

Game harus memiliki file index.html di direktori utama. Impor YouTube Playables SDK dengan menambahkan baris ini sebelum kode game Anda:

<script src="https://www.youtube.com/game_api/v1"></script>

SDK berjalan sebagai no-op saat game Anda ditayangkan secara lokal. Untuk memverifikasi ketepatan integrasi SDK, gunakan panduan rangkaian pengujian.

Mengintegrasikan dengan Playables SDK

Ada beberapa integrasi yang diperlukan dan opsional dengan Playables SDK.

Integrasi yang diperlukan

Tinjau persyaratan publikasi secara keseluruhan, dengan fokus pada persyaratan integrasi. Tinjau referensi Playables SDK untuk mengetahui detail penerapan.

Contohnya mencakup:

  • 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)

Selain integrasi yang diperlukan, beberapa fungsi lain tersedia untuk menciptakan pengalaman yang sangat menarik. Contohnya mencakup:

  • ytgame.system.getLanguage() - Gunakan ini untuk mengambil setelan lokalitas saat ini milik pengguna. Jangan gunakan fungsi lain atau simpan bahasa di penyimpanan cloud, karena hal ini dapat berubah kapan saja.
  • ytgame.engagement.sendScore({ value: newScore }) - Mengirim skor terbaik ke YouTube untuk ditampilkan.
  • ytgame.engagement.openYTContent({ id: videoID }) - Membuka video YouTube.
  • ytgame.health.logError() dan ytgame.health.logWarning() - Mencatat masalah ke YouTube.

Tinjau referensi Playables SDK untuk mengetahui detail penerapan dan fungsi tambahan.

Definisi jenis TypeScript

Untuk game yang menggunakan TypeScript, download definisi jenis.

Contoh game

Contoh tersedia yang menunjukkan cara berintegrasi dengan YouTube Playables SDK, termasuk JavaScript biasa, web Flutter, Godot, dan Unity.

Menguji game dengan rangkaian pengujian

Setelah siap, Anda dapat memvalidasi integrasi menggunakan rangkaian pengujian. Untuk mempelajari caranya, ikuti panduan rangkaian pengujian.