YouTube Hazır Oyunlar SDK'sı - Başlarken

YouTube Hazır Oyunlar SDK'sı, tarayıcı oyunlarını YouTube ortamına bağlamak için kullanılan bir web SDK'sıdır. SDK, YouTube'da mükemmel bir oyun deneyimi oluşturmak için oyunları çeşitli şekillerde destekleyen güçlü bir API'ye sahiptir.

Playables SDK'sını oyununuza ekleme

Bir oyunun kök dizininde index.html dosyası olmalıdır. YouTube Hazır Oyunlar SDK'sını, oyun kodunuzdan önce şu satırı ekleyerek içe aktarın:

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

Oyununuz yerel olarak yayınlandığında SDK, işlem yapmadan çalışır. SDK entegrasyonunun doğruluğunu doğrulamak için test paketi kılavuzunu kullanın.

Playables SDK ile entegrasyon

Playables SDK ile zorunlu ve isteğe bağlı çeşitli entegrasyonlar vardır.

Zorunlu entegrasyonlar

Yayınlama şartlarını genel olarak inceleyin. Entegrasyon şartlarına odaklanın. Uygulama ayrıntıları için Playables SDK referansını inceleyin.

Örnekler:

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

Gerekli entegrasyonlara ek olarak, oldukça ilgi çekici bir deneyim oluşturmak için başka işlevler de kullanılabilir. Örnekler:

  • ytgame.system.getLanguage(): Kullanıcının mevcut yerel ayarını almak için kullanılır. Diğer işlevleri kullanmayın veya dili bulut kaydında saklamayın. Aksi takdirde bu durum herhangi bir zamanda değişebilir.
  • ytgame.engagement.sendScore({ value: newScore }) - Gösterilmesi için YouTube'a en iyi skoru gönderme
  • ytgame.engagement.openYTContent({ id: videoID }) - Bir YouTube videosu açın.
  • ytgame.health.logError() ve ytgame.health.logWarning(): YouTube'da oturum açmayla ilgili sorunları günlüğe kaydeder.
  • ytgame.ads.requestInterstitialAd() ve requestRewardedAd(rewardId: string) - Reklam özelliklerini oyununuza entegre edin.

Uygulama ayrıntıları ve ek işlevler için Playables SDK referansını inceleyin.

TypeScript türü tanımları

TypeScript kullanan oyunlar için tür tanımlarını indirin.

Örnek oyunlar

YouTube Playables SDK'sı ile entegrasyonun nasıl yapılacağını gösteren örnekler mevcuttur. Bu örnekler arasında düz JavaScript, Flutter web, Godot ve Unity yer alır.

Oyununuzu test paketiyle test etme

Hazır olduğunuzda test paketini kullanarak entegrasyonunuzu doğrulayabilirsiniz. Nasıl yapılacağını öğrenmek için test paketi kılavuzunu inceleyin.