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 sağlam bir API'ye sahiptir.

Playables SDK'sını oyununuza ekleme

Bir oyunun kök dizinde index.html dosyası olmalıdır. Oyun kodunuzun herhangi bir satırından önce şu satırı ekleyerek YouTube Hazır Oyunlar SDK'sını içe aktarın:

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

Oyununuz yerel olarak sunulduğunda SDK, işlem yapmadan çalışır. SDK entegrasyonunun doğruluğunu onaylamak için test paketi kılavuzunu kullanın.

Playables SDK ile entegrasyon

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

Zorunlu entegrasyonlar

Yayınlama koşullarını genel olarak inceleyin. Entegrasyon koşulları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 entegrasyonların yanı sıra, 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. Başka işlevler kullanmayın veya dili bulut kaydında saklamayın. Aksi takdirde dil 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(): Sorunları YouTube'a kaydedin.

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

Düz JavaScript, Flutter web, Godot ve Unity dahil olmak üzere YouTube Playables SDK ile nasıl entegrasyon yapılacağını gösteren örnekler mevcuttur.

Oyununuzu test paketiyle test etme

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