YouTube Playables SDK'sı, web 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
Oyunların kök dizininde bir index.html dosyası olmalıdır. Oyun kodunuzdan herhangi birinin önüne şu satırı ekleyerek YouTube Playables SDK'sını 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'sıyla entegrasyon
Playables SDK'sı ile birkaç zorunlu ve isteğe bağlı entegrasyon vardır.
Zorunlu entegrasyonlar
Entegrasyon koşullarına odaklanarak genel olarak yayınlama koşullarını inceleyin. Uygulama ayrıntıları için Playables SDK referansını inceleyin.
Örnekler:
ytgame.game.firstFrameReady()ytgame.game.gameReady()ytgame.IN_PLAYABLES_ENVytgame.system.isAudioEnabled()ytgame.system.onAudioEnabledChange((isAudioEnabled) => {})ytgame.system.onPause(() => {})ytgame.system.onResume(() => {})ytgame.game.loadData()ytgame.game.saveData(data)
Önerilen entegrasyonlar
Gerekli entegrasyonlara ek olarak, son derece ilgi çekici bir deneyim oluşturmak için kullanılabilecek başka işlevler de vardır. Örnekler:
ytgame.system.getLanguage(): Kullanıcının geçerli yerel ayarını almak için kullanın. Bu özellik her an değişebileceği için başka işlevler kullanmayın veya dili bulutta saklamayın.ytgame.engagement.sendScore({ value: newScore }): Gösterilmek üzere YouTube'a en iyi puanı gönderin.ytgame.engagement.openYTContent({ id: videoID }): YouTube videosu açar.ytgame.health.logError()veytgame.health.logWarning(): YouTube'a sorun kaydetme.
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.
Sana Özel oyunları
Basit JavaScript, Flutter web, Godot ve Unity dahil olmak üzere YouTube Playables SDK'sının nasıl entegre edileceğini gösteren örneklere erişebilirsiniz.
Oyununuzu test paketiyle test etme
Hazır olduğunuzda test paketini kullanarak entegrasyonunuzu doğrulayabilirsiniz. Bunu nasıl yapacağınızı öğrenmek için test paketi kılavuzunu inceleyin.