--- metadata: - name: generator content: Diplodoc Platform v5.54.4 alternate: - https://yandex.com.tr/dev/games/doc/en/requirements/1/19.md - https://yandex.com.tr/dev/games/doc/hi/requirements/1/19.md - https://yandex.com.tr/dev/games/doc/ko/requirements/1/19.md - https://yandex.com.tr/dev/games/doc/ru/requirements/1/19.md - https://yandex.com.tr/dev/games/doc/tr/requirements/1/19.md - https://yandex.com.tr/dev/games/doc/vi/requirements/1/19.md - https://yandex.com.tr/dev/games/doc/zh/requirements/1/19.md - href: tr/requirements/1/19.md type: text/markdown title: Markdown version - href: ../../llms.txt type: text/markdown title: llms.txt --- > **Documentation Index:** Fetch the complete configuration index at https://yandex.com.tr/dev/games/doc/tr/llms.txt # SDK yöntemleri {% note info "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](https://yandex.com.tr/dev/games/doc/tr/sdk/sdk-about.md) 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ış](https://yandex.com.tr/dev/games/doc/tr/sdk/sdk-game-events.md#gameplay) 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ı](https://yandex.com.tr/dev/games/doc/tr/sdk/sdk-events.md#pause-resume) bölümünde açıklandığı şekilde kesinlikle uygulanmalıdır. {% endnote %} ## SDK'nın Başlatılması {#sdk-initializing} **1.19.1.** SDK, [Bağlantı ve kullanım](https://yandex.com.tr/dev/games/doc/tr/sdk/sdk-about.md) 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 {#loader-check} 1. Oyunu hata ayıklama paneliyle başlatın. {% list tabs %} - Geliştirici konsolu üzerinden 1. [Yandex Oyun Konsolunu açın](https://games.yandex.com/console){.external}. 1. İlgili oyunu seçin. 1. Sol üst köşede **Open with debug panel**'e tıklayın. - URL adres çubuğuyla 1. İlgili oyunu açın. 1. 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ı. {% endlist %} 1. 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 {#examples-loader}
#| || **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."](../../_images/requirements/1-19-sdk-methods/gra/old-1.webp) | 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."](../../_images/requirements/1-19-sdk-methods/gra/old-2.webp) | 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."](../../_images/requirements/1-19-sdk-methods/gra/new-1.webp) | 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."](../../_images/requirements/1-19-sdk-methods/gra/new-2.webp) | Yeni yükleyici. Debug panelinde gösterilir `IT`. || |#
## Game Ready {#gameready} **1.19.2.** Kullanıcı oyunu oynamaya başlayabileceği zaman, [Game Ready](https://yandex.com.tr/dev/games/doc/tr/sdk/sdk-game-events.md#gameready) içerisinden `LoadingAPI.ready()` metodunu çağırın. Bu gerekliliğin karşılandığı kabul edilebilmesi için, `LoadingAPI.ready()` metodunun [doğru zamanda](#gameready-correct) çağrılması gerekmektedir. ### Yükleme ekranı {#loading-screen} 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. {% cut "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ı](../../_images/requirements/1-19-sdk-methods/gra/yandex-games-loading.webp) {% endcut %} 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 {#gameready-preparation} 1. Oyunu debug paneli ile başlatın. {% list tabs %} - Geliştirici konsolu üzerinden 1. [Yandex Oyun Konsolunu açın](https://games.yandex.com/console){.external}. 1. İlgili oyunu seçin. 1. Sol üst köşede **Open with debug panel**'e tıklayın. - URL adres çubuğuyla 1. İlgili oyunu açın. 1. 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ı. {% endlist %} 1. Debug panelinde Game Ready göstergesini bulun ![SVG](../../_images/debug-panel/gra-purple.svg). ### Game Ready kontrol mantığı {#gameready-check} 1. Mor gösterge ![SVG](../../_images/debug-panel/gra-purple.svg)'nin 90 saniye içinde yeşile ![SVG](../../_images/debug-panel/gra-green.svg) dönüştüğünü kontrol edin. 1. Oyunu yeniden yükleyin. 1. 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.](../../_images/requirements/1-19-sdk-methods/gra/without-yandex-games-loading.gif) || || 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.](../../_images/requirements/1-19-sdk-methods/gra/with-yandex-games-loading.gif) || |#
{% note info %} 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. {% endnote %} ### Game Ready doğru çalışıyor {#gameready-correct} Mor gösterge ![SVG](../../_images/debug-panel/gra-purple.svg) yeşile ![SVG](../../_images/debug-panel/gra-green.svg) 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.](../../_images/requirements/1-19-sdk-methods/gra/menu-1.gif) | 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.](../../_images/requirements/1-19-sdk-methods/gra/menu-2.gif) | 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.](../../_images/requirements/1-19-sdk-methods/gra/menu-3.gif) | 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.](../../_images/requirements/1-19-sdk-methods/gra/game-ok-1.gif) | 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.](../../_images/requirements/1-19-sdk-methods/gra/game-ok-2.gif) | 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.](../../_images/requirements/1-19-sdk-methods/gra/game-ok-3.gif) | Oyunun etkileşime açık olduğu an, yeşil bir gösterge belirir. || |#
### Game Ready düzgün çalışmıyor {#gameready-incorrect} Mor gösterge ![SVG](../../_images/debug-panel/gra-purple.svg) yeşile ![SVG](../../_images/debug-panel/gra-green.svg) 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.](../../_images/requirements/1-19-sdk-methods/gra/before-game-1.gif) | 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.](../../_images/requirements/1-19-sdk-methods/gra/before-game-2.gif) | 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.](../../_images/requirements/1-19-sdk-methods/gra/before-game-3.gif) | 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.](../../_images/requirements/1-19-sdk-methods/gra/after-start-1.gif) | 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.](../../_images/requirements/1-19-sdk-methods/gra/after-start-2.gif) | Oyun etkileşime hazır hale geldikten birkaç saniye sonra yeşil gösterge belirdi. || |#
### Game Ready entegre edilmedi {#no-gameready} Gösterge, 90 saniye sonra kırmızıya döndü ![SVG](../../_images/debug-panel/gra-red.svg).
#| || **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.](../../_images/requirements/1-19-sdk-methods/gra/no-gra-1.gif) | Gösterge kırmızıya döndü — Game Ready entegre edilmemiş. || |#
## Oynanış işaretlemesi {#gameplay} **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ış](https://yandex.com.tr/dev/games/doc/tr/sdk/sdk-game-events.md#gameplay) bölümünde açıklandığı şekilde kesinlikle karşılanmalıdır. ### Hazırlık {#gameplay-preparation} 1. Oyunu [debug paneli](https://yandex.com.tr/dev/games/doc/tr/console/debug-panel.md) ile başlatın. {% list tabs %} - Geliştirici konsolu üzerinden 1. [Yandex Oyun Konsolunu açın](https://games.yandex.com/console){.external}. 1. İlgili oyunu seçin. 1. Sol üst köşede **Open with debug panel**'e tıklayın. - URL adres çubuğuyla 1. İlgili oyunu açın. 1. 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ı. {% endlist %} 2. Debug panelinde gamepad düğmesini 🎮 bulun. ### Oynanış işaretlemesinin kontrolü {#gameplay-check-principle} 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 ![SVG](../../_images/debug-panel/gameplay-on.svg) 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ı ![SVG](../../_images/debug-panel/gameplay-off.svg) 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). {% note tip %} Odak nerede olduğunu (oyunda mı yoksa başka bir pencerede mi) öğrenmek için, [olayları](https://yandex.com.tr/dev/games/doc/tr/sdk/sdk-events.md#pause-resume) `game_api_resume` ve `game_api_pause` takip edin. {% endnote %} ### Oynanış doğru işaretlendi {#gameplay-correct} 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.](../../_images/requirements/1-19-sdk-methods/gameplay/new-lvl-ok.gif) | 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.](../../_images/requirements/1-19-sdk-methods/gameplay/lvl-done-ok.gif) | 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.](../../_images/requirements/1-19-sdk-methods/gameplay/menu-close-back-ok.gif) | 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.](../../_images/requirements/1-19-sdk-methods/gameplay/menu-open-ok.gif) | 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.](../../_images/requirements/1-19-sdk-methods/gameplay/purchases-open-close-ok.gif) | 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.](../../_images/requirements/1-19-sdk-methods/gameplay/ad-closed-ok.gif) | 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.](../../_images/requirements/1-19-sdk-methods/gameplay/browser-open-ok.gif) | 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 {#gameplay-incorrect} 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.](../../_images/requirements/1-19-sdk-methods/gameplay/lvl-done-bad.gif) | 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.](../../_images/requirements/1-19-sdk-methods/gameplay/menu-open-bad.gif) | 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.](../../_images/requirements/1-19-sdk-methods/gameplay/ad-closed-bad.gif) | 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.](../../_images/requirements/1-19-sdk-methods/gameplay/browser-open-bad.gif) | Tarayıcı sekmesinden başka bir pencereye odak kaydırıldığında gösterge rengi değişmez. || |#
## Moderasyon ile İletişime Geçin {#forma} 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.
{% cut "Formu aç" %}
{% endcut %}