SDK yöntemleri

Gereksinim Maddesi 1.19

Yandex Oyunlar SDK'nın başlatılması ve yöntemlerinin kullanımı, belgelendirme ve oyun gereksinimleriyle tam uyum içinde yapılmalıdır:

  1. SDK, SDK'nın Kurulumu ve Kullanımı sayfasında belirtildiği şekilde kesinlikle başlatılmalıdır.

  2. Kullanıcı oyunu oynamaya başlayabileceği anda, gameReadyAPI'den ready() metodunun çağrılması gerekmektedir.

  3. GameplayAPI'nin kullanımı isteğe bağlıdır, ancak oyun içinde GameplayAPI metodları kullanılıyorsa, start() ve stop() olaylarının gönderilme anları Oynanış bölümünde açıklandığı şekilde kesinlikle uygun olmalıdır.

  4. game_api_pause ve game_api_resume olaylarının takibi isteğe bağlıdır, ancak eğer ysdk.on() ve ysdk.off() metotları oyunda kullanılıyorsa, olay işleme mantığı Oyunun Duraklatılması ve Devam Ettirilmesi Olayları bölümünde açıklandığı şekilde kesinlikle uygulanmalıdır.

SDK'nın Başlatılması

1.19.1. SDK, SDK'nın Kurulumu ve Kullanımı sayfasında belirtildiği şekilde kesinlikle başlatılmalıdır. Gereksinimin yerine getirildiği kabul edilmesi için, güncel yükleyicinin kullanılması gerekmektedir.

Yükleyicinin Güncelliğinin Kontrol Edilmesi

  1. Oyunu hata ayıklama paneliyle başlatın.

    1. Yandex Oyun Konsolunu açın.
    2. İlgili oyunu seçin.
    3. Sol üst köşede Open with debug panel'e tıklayın.
    1. İlgili oyunu açın.
    2. Tarayıcıdaki URL adresinin sonuna &debug-mode=16 ekleyin.

  2. Hata ayıklama panelinde, Oyun Hazır göstergesinin solunda iki harf bulacaksınız:

    • IF (init false) — oyun eski yükleyiciyi destekliyor. IF üzerine imleci getirdiğinizde Is loader: false yazısı belirecektir.

    • IT (init true) — oyun yeni yükleyiciyi destekliyor. IT üzerine imleci getirdiğinizde Is loader: true yazısı belirecektir.

Örnekler

Yükleyici

Yorum

Eski yükleyici. Debug panelinde gösterilir IF.

Eski yükleyici. Debug panelinde gösterilir IF.

Yeni yükleyici. Debug panelinde gösterilir IT.

Yeni yükleyici. Debug panelinde gösterilir IT.

Game Ready

1.19.2. Kullanıcı oyunu oynamaya başlayabileceği zaman, Game Ready içerisinden LoadingAPI.ready() metodunu çağırın.

Bu gerekliliğin karşılandığı kabul edilebilmesi için, LoadingAPI.ready() metodunun doğru zamanda çağrılması gerekmektedir.

Game Ready Kontrol Mantığı

Hazırlık

  1. Oyunu debug paneli ile başlatın.

    1. Yandex Oyun Konsolunu açın.
    2. İlgili oyunu seçin.
    3. Sol üst köşede Open with debug panel'e tıklayın.
    1. İlgili oyunu açın.
    2. Tarayıcıdaki URL adresinin sonuna &debug-mode=16 ekleyin.

  2. Debug panelinde Game Ready göstergesini bulun .

Genel Kontrol Prensibi

  1. Mavi gösterge 'nin 90 saniye içinde yeşile dönüştüğünü kontrol edin.
  2. Oyunu yeniden yükleyin.
  3. Göstergenin renginin ne zaman değiştiğini tekrar kontrol edin.

Game Ready Doğru Çalışıyor

Mavi gösterge yeşile dönüşür:

  • menüye erişilebilir olduğunda;

  • oyun etkileşime açık olduğunda (başlangıç animasyonu dahil).

Game Ready

Yorum

Menü erişilebilir olduğunda yeşil gösterge belirir.

Menü erişilebilir olduğunda yeşil gösterge belirir.

Menü erişilebilir olduğunda yeşil gösterge belirir.

Oyunun etkileşime açık olduğu an, yeşil bir gösterge belirir.

Oyunun etkileşime açık olduğu an, yeşil bir gösterge belirir.

Oyunun etkileşime açık olduğu an, yeşil bir gösterge belirir.

Game Ready düzgün çalışmıyor

Mavi gösterge , yeşile dönüştü :

  • oyun etkileşime açılmadan önce (ilerleme çubukları, dönen simgeler, siyah ekran vb. bulunurken);

  • Oyun etkileşime hazır hale geldikten birkaç saniye sonra.

Game Ready

Yorum

Oyun etkileşime açılmadan önce yeşil gösterge belirir.

Oyun etkileşime açılmadan önce yeşil gösterge belirir.

Oyun etkileşime açılmadan önce yeşil gösterge belirir.

Oyun etkileşime hazır hale geldikten birkaç saniye sonra yeşil gösterge belirdi.

Oyun etkileşime hazır hale geldikten birkaç saniye sonra yeşil gösterge belirdi.

Game Ready Entegre Edilmedi

İndikatör, 90 saniye sonra kırmızıya döndü .

Game Ready

Yorum

İndikatör kırmızıya döndü — Game Ready entegre edilmemiş.

Oynanış İşaretlemesi

1.19.3. GameplayAPI.start() ve GameplayAPI.stop() metodları, oyun sürecinin başlangıcını ve durdurulmasını işaretlemek için kullanılır. Eğer bu metodlar oyunda kullanılırsa, olayların gönderilme anları, Oynanış bölümünde açıklandığı şekilde kesinlikle karşılanmalıdır.

Oynanış İşaretlemesinin Kontrolü

Hazırlık

  1. Oyunu hata ayıklama paneli ile başlatın.

    1. Yandex Oyun Konsolunu açın.
    2. İlgili oyunu seçin.
    3. Sol üst köşede Open with debug panel'e tıklayın.
    1. İlgili oyunu açın.
    2. Tarayıcıdaki URL adresinin sonuna &debug-mode=16 ekleyin.

  2. Hata ayıklama panelinde, gamepad düğmesini 🎮 bulun.

Genel Kontrol Prensibi

Eylemlere bağlı olarak oynanış göstergesinin durumunu takip edin:

  • Oyuncu oyun sürecini başlattığında veya bir mola sonrasında devam ettirdiğinde, GameplayAPI.start() metodunun çağrılması gerekir. Oynanış göstergesi yeşil olmalıdır — oynanış devam etmektedir.

  • Oyuncu oyun sürecini bitirdiğinde veya duraklattığında, GameplayAPI.stop() metodunun çağrılması gerekir. Oynanış göstergesi kırmızı olmalıdır — oynanış mola durumundadır.

Kontrol sırasında göz önünde bulundurulan senaryolar:

  • Seviyenin başlatılması ve bitirilmesi.

  • Oyun menüsünün açılması ve kapanması.

  • Satın alma menüsünün açılması ve kapanması.

  • Reklamın başlatılması ve kapatılması.

  • Oyundan odaklanmanın kaybolması ve oyuna geri dönülmesi (tarayıcıda başka bir sekmeye geçiş yapmak veya başka bir pencereye geçmek).

Öneri

Odak nerede olduğunu (oyunda mı yoksa başka bir pencerede mi) öğrenmek için, olayları game_api_resume ve game_api_pause takip edin.

Oyun içi işaretlemeler doğru bir şekilde yapıldı

Gösterge rengi senaryoya göre değişir.

Oyun

Yorum

Yeni bir seviyenin başlangıcında gösterge yeşil.

Seviye tamamlandı, gösterge kırmızıya döndü.

Menüye geçiş yapıldığında ve oyun sürecine geri dönüldüğünde gösterge değişir.

Menüye geçiş yapıldığında ve oyun sürecine geri dönüldüğünde gösterge değişir.

Satın alma menüsüne geçiş yapıldığında ve oyun sürecine geri dönüldüğünde gösterge değişir.

Reklam kapatıldı, gösterge rengi kırmızıdan yeşile döndü.

Tarayıcı sekmesinden başka bir pencereye odak kaydırıldığında ve oyun sürecine geri dönüldüğünde gösterge rengi değişir.

Oyun içi işaretlemeler yanlış bir şekilde yapıldı

Gösterge rengi senaryoya göre değişmez.

Oyun

Yorum

Seviye tamamlandı, gösterge rengi yeşilden kırmızıya dönmedi.

Menüye geçiş yapıldığında gösterge rengi yeşilden kırmızıya dönmedi.

Reklam kapatıldı, gösterge rengi kırmızıdan yeşile dönmedi.

Tarayıcı sekmesinden başka bir pencereye odak kaydırıldığında gösterge rengi değişmez.

Moderasyon ile İletişime Geçin

Eğer SDK yöntemlerini doğru kullandığınızı düşünüyor ve oyununuzun haksız yere yayından kaldırıldığını ya da kabul edilmediğini düşünüyorsanız aşağıdaki formu doldurun.

Kalite kontrol ve moderasyon servisi, kararı tekrar gözden geçirecek ve oyununuz haksız yere engellenmişse, tekrar yayına alınacaktır.

Formu aç
Önceki
Temel ihlaller
Sonraki
Oyun mekaniği