SDK yöntemleri

Madde 1.19 Oyun Gereksinimleri

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

  1. SDK, Bağlantı ve kullanım sayfasında belirtildiği şekilde kesinlikle başlatılmalıdır.

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

  3. Gameplay işaretlemesinin kullanımı isteğe bağlıdır; ancak oyunda GameplayAPI.start() ve GameplayAPI.stop() yöntemleri kullanılıyorsa, olay gönderme zamanlaması Oynanış bölümünde açıklananlara tam olarak uymalı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, Bağlantı 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.

      Bağlantı örneği: https://yandex.com.tr/games/app/XXXX?debug-mode=16, burada XXXX — oyunun benzersiz tanımlayıcısı.

  2. Hata ayıklama panelinde, Game Ready 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

Oyun ekran görüntüsü: debug panelinde IF görüntülenir, alttaki araç ipucunda şu metin yer alır: "SDK was initialized Version: v2. Is loader: false."

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

Oyun ekran görüntüsü: debug panelinde IF görüntülenir, alttaki araç ipucunda şu metin yer alır: "SDK was initialized Version: v2. Is loader: false."

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

Oyun ekran görüntüsü: debug panelinde IT görüntülenir, alttaki araç ipucunda şu metin yer alır: "SDK was initialized Version: v2. Is loader: true."

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

Oyun ekran görüntüsü: debug panelinde IT görüntülenir, alttaki araç ipucunda şu metin yer alır: "SDK was initialized Version: v2. Is loader: true."

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.

Yükleme ekranı

Oyun yüklenirken Yandex Oyunlar platformu önce kendi yükleme ekranını gösterir — oyunun titreşen simgesi ve "Yükleniyor" yazısı. Ekrana dokunarak manuel olarak kapatılabilir.

Yandex Oyunlar yükleme ekranı nasıl görünür

Yandex Oyunlar yükleme ekranı: oyunun titreşen simgesi ve "Yükleniyor" yazısı

Moderasyon, oyunun kendi yükleme ekranını denetler. Ekranda yasak içerik varsa — üçüncü taraf bağlantılar, izinsiz logolar, telif hakkı ihlali içeren öğeler — bu ret gerekçesi olur.

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.

      Bağlantı örneği: https://yandex.com.tr/games/app/XXXX?debug-mode=16, burada XXXX — oyunun benzersiz tanımlayıcısı.

  2. Debug panelinde Game Ready göstergesini bulun .

Game Ready kontrol mantığı

  1. Mor 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.

Moderasyonun kontrolde göz önünde bulundurduğu senaryolar:

Senaryo

Örnek

Yandex Oyunlar yükleme ekranı manuel olarak kapatıldı — ekrana dokunarak kapatın ve göstergenin ne zaman değiştiğini kontrol edin.

Oyun yükleme videosu: Yandex Oyunlar yükleme ekranı dokunarak kapatılır, ardından oyunun kendi yükleme ekranı gösterilir, sonrasında oyun etkileşime açılır.

Yandex Oyunlar yükleme ekranı otomatik olarak kapandı — ekranın kendiliğinden kaybolmasını bekleyin ve göstergenin ne zaman değiştiğini kontrol edin.

Oyun yükleme videosu: Yandex Oyunlar yükleme ekranı otomatik olarak kaybolur, ardından oyunun kendi yükleme ekranı kısa süreliğine gösterilir, sonrasında oyun etkileşime açılır.

Not

Game Ready her iki senaryoda da doğru çalışmalıdır. LoadingAPI.ready() çağrısı oyunun gerçek hazırlığına değil de belirli bir zaman noktasına bağlıysa, Yandex Oyunlar yükleme ekranı manuel olarak kapatıldığında bu fark edilir ve moderasyon bunu ihlal olarak işaretler.

Game Ready doğru çalışıyor

Mor 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

Oyun yükleme videosu: yükleme sırasında debug paneli göstergesi mavi yanıp söner; menü belirdiğinde gösterge yeşile döner.

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

Oyun yükleme videosu: yükleme sırasında debug paneli göstergesi mavi yanıp söner; menü belirdiğinde gösterge yeşile döner.

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

Oyun yükleme videosu: yükleme sırasında debug paneli göstergesi mavi yanıp söner; menü belirdiğinde gösterge yeşile döner.

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

Oyun yükleme videosu: yükleme sırasında debug paneli göstergesi mavi yanıp söner; oyun etkileşime açıldığında gösterge yeşile döner.

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

Oyun yükleme videosu: yükleme sırasında debug paneli göstergesi mavi yanıp söner; oyun etkileşime açıldığında gösterge yeşile döner.

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

Oyun yükleme videosu: yükleme sırasında debug paneli göstergesi mavi yanıp söner; oyun etkileşime açıldığında gösterge yeşile döner.

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

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

Mor 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 yükleme videosu: yükleme sırasında debug paneli göstergesi yeşil olsa da oyunla henüz etkileşime girilemiyor.

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

Oyun yükleme videosu: yükleme sırasında debug paneli göstergesi önce mavi yanıp söner, ardından oyunla henüz etkileşime girilemese de yeşile döner.

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

Oyun yükleme videosu: yükleme ve reklam sırasında debug paneli göstergesi yeşil olsa da oyunla henüz etkileşime girilemiyor.

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

Oynanış videosu: oyun zaten etkileşime açık olsa da debug paneli göstergesi birkaç saniye daha mavi yanıp sönmeye devam ediyor.

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

Oynanış videosu: oyun zaten etkileşime açık olsa da debug paneli göstergesi birkaç saniye daha mavi yanıp sönmeye devam ediyor.

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

Game Ready entegre edilmedi

Gösterge, 90 saniye sonra kırmızıya döndü .

Game Ready

Yorum

Bilgi yarışması oyunu videosu: oyun devam ederken debug paneli göstergesi mavi yanıp söner, ardından kırmızıya döner.

Gösterge kırmızıya döndü — Game Ready entegre edilmemiş.

Oynanış iş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.

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.

      Bağlantı örneği: https://yandex.com.tr/games/app/XXXX?debug-mode=16, burada XXXX — oyunun benzersiz tanımlayıcısı.

  2. Debug panelinde gamepad düğmesini 🎮 bulun.

Oynanış işaretlemesinin kontrolü

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.

Moderasyonun kontrolde göz önünde bulundurduğu 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.

Oynanış doğru işaretlendi

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

Oyun

Yorum

Seviye seçimi ve başlatma videosu: seviye belirdiğinde oynanış göstergesi (gamepad simgesi) yeşile döner.

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

Oynanış videosu: seviye tamamlandığında oynanış göstergesi (gamepad simgesi) yeşilden kırmızıya döner.

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

Oynanış videosu: seviye sırasında oynanış göstergesi (gamepad simgesi) yeşil; menü açıldığında kırmızıya döner, menüden çıkıldıktan sonra tekrar yeşile döner.

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

Oynanış videosu: seviye sırasında oynanış göstergesi (gamepad simgesi) yeşil; menü açıldığında kırmızıya döner, menüden çıkıldıktan sonra tekrar yeşile döner.

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

Oynanış videosu: oyundan uygulama içi satın alma mağazasına geçildiğinde oynanış göstergesi (gamepad simgesi) yeşilden kırmızıya döner. Oyuna dönüldüğünde gösterge yeşile döner.

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.

Oynanış videosu: reklam başladığında oynanış göstergesi (gamepad simgesi) yeşilden kırmızıya döner. Oyuna dönüldüğünde gösterge yeşile döner.

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

Oynanış videosu: oyun sırasında oynanış göstergesi (gamepad simgesi) yeşil. Başka bir uygulama (Dosya Gezgini) açıldığında gösterge kırmızıya döner. Tarayıcıdaki oyun sekmesine geri geçildiğinde gösterge yeşile döner.

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.

Oynanış yanlış işaretlendi

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

Oyun

Yorum

Oynanış videosu: seviye bittikten sonra oynanış göstergesi (gamepad simgesi) hâlâ yeşil.

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

Oynanış videosu: menü açıldıktan sonra oynanış göstergesi (gamepad simgesi) hâlâ yeşil.

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

Oynanış videosu: reklam başladığında oynanış göstergesi (gamepad simgesi) yeşilden kırmızıya döner. Oyuna dönüldüğünde gösterge kırmızı kalmaya devam eder.

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

Oynanış videosu: oyun sırasında oynanış göstergesi (gamepad simgesi) yeşil. Başka bir uygulama (Dosya Gezgini) açıldığında gösterge yeşil kalmaya devam eder.

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