Oyun yükleme ve oynanış işaretleme

Oyunun yüklenmesi

Yandex Oyunlar dünya genelinde çalışır, bu nedenle oyunların yükleme hızını ve erişilebilirliğini iyileştirmek için istatistik toplamak önemlidir. Örneğin, bu verilere dayanarak yeni veri merkezlerini nereye kuracağımıza karar veririz.

Oyunların ne zaman yüklendiğini anlamak, yeni işlevler eklememizi sağlayacaktır: tüm oyunlar için ortak bir yükleme ekranı, oyun ekran görüntüleri veya yorumlar göstermek. Bu, oyunların çekiciliğini artıracaktır.

ysdk.features.LoadingAPI.ready()

Metodu, oyun tüm kaynakları yüklediğinde ve kullanıcıyla etkileşime hazır olduğunda çağırmalısınız.

Game Ready metodunu çağırdığınız anda oyunda şunlardan emin olun:

  • Tüm elementler oyuncuyla etkileşime hazır.
  • Yükleme ekranı yok.

Game Ready metriğini DevTools'daki Performance sekmesinde takip edebilirsiniz.

Örnek

1const ysdk = await YaGames.init();
2
3// Platforma oyunun yüklendiğini ve oynamaya hazır olduğunu bildiriyoruz.
4ysdk.features.LoadingAPI?.ready();
1YaGames.init()
2    .then((ysdk) => {
3        // Platforma oyunun yüklendiğini ve oynamaya hazır olduğunu bildiriyoruz.
4        ysdk.features.LoadingAPI?.ready();
5    })
6    .catch(console.error);

Oynanış

Kullanıcıların oyunlarla nasıl ve ne zaman etkileşime girdiklerini takip etmek bizim için önemlidir. Bunun için SDK'da, oyunun başladığı ve durduğu anları işaretlememizi sağlayan özel metodlar vardır. Bu kullanım, katalogdaki öneri doğruluğunu artırmamıza, oyunların daha fazla platforma yayılmasına ve Geliştirici Konsolunda ek metrikler oluşturmamıza yardımcı olacaktır.

ysdk.features.GameplayAPI.start()

Metodu, oyuncu oyun sürecini başlattığında veya devam ettirdiğinde çağırmalısınız. Bu tür durumlar şunlardır:

  • Bir seviyenin başlaması.
  • Menünün kapatılması.
  • Oyundan pausenin kaldırılması.
  • Reklam gösterildikten sonra oyunun devam ettirilmesi.
  • Mevcut tarayıcı sekmesine geri dönülmesi.

GameplayAPI.start() olayının gönderilmesinden sonra oyun sürecinin hemen başlatıldığından emin olun.

ysdk.features.GameplayAPI.stop()

Metodu, oyuncu oyun sürecini duraklattığında veya sonlandırdığında çağırmalısınız. Bu tür durumlar şunlardır:

  • Bir seviyenin tamamlanması veya kaybedilmesi.
  • Menünün çağrılması.
  • Oyunda pausenin olması.
  • Tam ekran veya rewarded-reklamın gösterilmesi.
  • Başka bir tarayıcı sekmesine geçiş.

GameplayAPI.stop() olayının gönderilmesinden sonra oyun sürecinin durduğundan emin olun.

Önemli

Oyun sürecini yeniden başlattığınızda, ysdk.features.GameplayAPI.start() metodunu tekrar çağırın.

Örnek

 1const ysdk = await YaGames.init();
 2
 3// Oynanışın başladığını bildiriyoruz.
 4ysdk.features.GameplayAPI?.start();
 5
 6// Oyun süreci aktif.
 7
 8// Oynanışın durdurulduğunu bildiriyoruz:
 9// oyuncu menüye çıktı, bir seviyeyi tamamladı veya reklam gösterimi planlanıyor.
10ysdk.features.GameplayAPI?.stop();
 1YaGames.init()
 2    .then((ysdk) => {
 3        // Oynanışın başladığını bildiriyoruz.
 4        ysdk.features.GameplayAPI?.start();
 5
 6        // Oyun süreci aktif.
 7
 8        // Oynanışın durdurulduğunu bildiriyoruz:
 9        // oyuncu menüye çıktı, bir seviyeyi tamamladı veya reklam gösterimi planlanıyor.
10        ysdk.features.GameplayAPI?.stop();
11    });

Not

Destek ekibi, hazır bir oyunun Yandex Oyunlar platformunda yayınlanmasına yardımcı olur. Geliştirme ve test etmeyle ilgili uygulamalı sorulara Discord topluluğunda diğer geliştiriciler yanıt verir.

Yandex Oyun SDK'sını kullanırken bir sorunla karşılaşırsanız veya bir sorunuz olursa destek ekibiyle iletişime geçin:

Sohbete yaz