SDK'nın kurulumu ve kullanımı

Yandex Games SDK, üçüncü taraf geliştiriciler tarafından oluşturulan oyunları Yandex Games platformuna hızlı bir şekilde entegre etmenizi sağlayan bir kütüphanedir.

SDK bağlantısı moderasyondan geçmek için ön koşuldur.

SDK aşağıdaki olanakları sağlar:

  • Reklam gösterimini entegre etme,
  • Derlemeyi güncellemeden işlevselliği etkinleştirme ve devre dışı bırakmayı yönetme,
  • Otomatik olarak tam ekran moduna geçişin ayarlanması,
  • Oyun sırasında ekran yönünü ayarlanması ve cihazı hangi tarafa çevrilmesi gerektiğine dair bir ipucu eklenmesi.

Kurulum

Dikkat

https://yandex.ru/games/sdk/v2 yolu eskimiştir. Oyununuzun moderasyon sürecinden başarı ile geçmesi için, yerleştirme yönteminize bağlı olarak Yandex Oyunlar SDK'sını bağlamak için güncel yolu belirtin:

Yandex Games SDK'ya hem senkron hem de asenkron yollarla bağlanabilirsiniz. Her iki seçenek de eşittir. Ancak, asenkron bağlantı, callback işlevlerini kullanarak yükleme işlemini kontrol etmenize olanak tanır. Daha uygun olduğunu düşündüğünüz yöntemi seçin.

Yandex Sunucusu

Not

Geliştirme aşamasında /sdk.js'i proxy'lemek için yerel sunucuyu kullanın.

HTML sayfasının head başlığına aşağıdaki gibi bir satır ekleyin:

<!-- Yandex Games SDK -->
<script src="/sdk.js"></script>

Bu yöntemde, script için async, defer ve onload nitelikleri kullanılabilir. Örneğin:

<script async src="/sdk.js" onload="initSDK()"></script>

HTML sayfanıza aşağıdaki kodu ekleyin:

<!-- Yandex Games SDK -->
<script>
    (function(d) {
        var s = d.createElement('script');
        s.src = '/sdk.js';
        s.async = true;
        s.onload = initSDK;
        d.body.append(s);
    })(document);
</script>

Kendi Alan Adınız

HTML sayfasının head bölümüne aşağıdaki formda bir satır ekleyin:

<!-- Yandex Games SDK -->
<script src="https://sdk.games.s3.yandex.net/sdk.js"></script>

HTML sayfasına aşağıdaki kodu ekleyin:

<!-- Yandex Games SDK -->
<script>
    (function(d) {
        var s = d.createElement('script');
        s.src = "https://sdk.games.s3.yandex.net/sdk.js";
        s.async = true;
        s.onload = initSDK;
        d.body.append(s);
    })(document);
</script>

Kullanım

Çalışmaya başlamak için YaGames nesnesinin init yöntemini kullanarak SDK'yı başlatın.

YaGames
    .init()
    .then(ysdk => {
        console.log('Yandex SDK initialized');
        window.ysdk = ysdk;
    });

Olası sorunlar

Uncaught ReferenceError: YaGames is not defined

sdk komut dosyasının bağlanma düzenine dikkat edin: YaGames.init(). çalıştırılmadan önce bağlanmalıdır.

Uncaught ReferenceError: ysdk is not defined

SDK başlatılana kadar (konsolda Yandex SDK başlatıldı mesajı) SDK yöntemlerini (reklam, alışveriş vb.) kullanmaya çalıştınız. Çağrıların sırasını nasıl garanti edeceğinizi bilmiyorsanız, SDK kullanım konumlarını yeniden yazın. Bunun için aşağıdaki satırı:

ysdk.adv.showFullscreenAdv()

bununla değiştirin

YaGames.init().then(ysdk => ysdk.adv.showFullscreenAdv())

SDK bağlantı örneği

<!-- Yandex Games SDK -->
<script src="/sdk.js"></script>
<script>
    YaGames.init().then(ysdk => {
        // ...
    });
</script>

Not

Destek ekibi, hazır oyunu Yandex Oyun platformuna yerleştirmenize yardımcı olur. Geliştirme ve test etme konularındaki uygulamalı sorulara ise diğer geliştiriciler Discord Topluluğu yanıt verir.

Yandex Games SDK kullanırken sorunla karşılaşırsanız veya sorunuz varsa, lütfen destek ekibiyle iletişime geçin:

Sohbete yaz
Önceki
Diğer oyunlara bağlantılar
Sonraki
Oyun Yükleme ve Oynanış İşaretleme