YG2 Doc Nedir? Plugin Your Games 2.0 Dokümantasyonu ve Kullanım Rehberi

YG2 Doc Nedir?

YG2 Doc, Unity oyun motoruyla geliştirilen oyunların Yandex Games ve desteklenen diğer oyun platformlarına entegre edilmesinde kullanılan Plugin Your Games 2.0 eklentisinin dokümantasyonudur.

Bu dokümantasyon, oyun geliştiricilerine eklentinin nasıl kurulacağını, modüllerin nasıl kullanılacağını ve platform özelliklerinin oyunlara nasıl entegre edileceğini açıklar.

YG2 Doc içerisinde reklam gösterimi, oyuncu kayıtlarının saklanması, dil yönetimi, platform ayarları, oyun durumu bildirimleri ve WebGL derlemesi gibi konularda teknik bilgiler bulunur.

Özellikle Unity ile HTML5 oyun geliştiren ve projelerini Yandex Games üzerinde yayımlamak isteyen yazılımcılar için önemli bir başvuru kaynağıdır.

YG2 Doc Ne İşe Yarar?

YG2 dokümantasyonunun temel amacı, Plugin Your Games 2.0 eklentisinin doğru ve verimli kullanılmasını sağlamaktır.

Geliştiriciler dokümantasyonu kullanarak şu işlemler hakkında bilgi edinebilir:

• Unity projesine YG2 eklentisini kurmak.
• Eklenti modüllerini indirmek ve etkinleştirmek.
• C# üzerinden reklam çağrıları yapmak.
• Oyuncu ilerlemesini buluta kaydetmek.
• Oyunun dilini ve platform bilgilerini yönetmek.
• Oyun başlangıç ve duraklama durumlarını bildirmek.
• WebGL çıktısı oluşturmak.
• Oyunu yerel ortamda ve Yandex Games üzerinde test etmek.

Dokümantasyon yalnızca başlangıç seviyesindeki geliştiricilere değil, mevcut oyun projelerine yeni platform özellikleri eklemek isteyen deneyimli yazılımcılara da hitap eder.

YG2 Doc İçerisinde Hangi Konular Bulunur?

1. Kurulum ve Başlangıç

YG2 Doc’un başlangıç bölümü, eklentinin Unity projesine nasıl aktarılacağını anlatır.

Dokümantasyonda belirtilen Unity sürümleri arasında Unity 2021.3.18 ve üzeri, Unity 2022.3, Unity 2023.2 ve Unity 6 bulunur. Kullanılan eklenti sürümüne göre uyumluluk bilgileri yeniden kontrol edilmelidir.

Kurulum sırasında geliştiricilerin dikkat etmesi gereken önemli noktalar şunlardır:

• Projede mevcut derleme hatalarının giderilmesi.
• Eklenti dosyalarının proje içinde elle taşınmaması.
• Eklentinin uygun sürümünün kurulması.
• Plugin ayarlarının kontrol edilmesi.
• Hedef platformun doğru seçilmesi.

2. Modüler Sistem

YG2’nin önemli özelliklerinden biri modüler mimarisidir. Eklentinin tüm işlevleri tek bir büyük paket yerine farklı modüller üzerinden sunulur.

Örneğin reklam özelliğini kullanmak isteyen bir geliştirici InterstitialAdv modülünü projeye ekleyebilir. Diğer modüller ise ihtiyaç duyuldukça kurulabilir.

Modüler sistemin avantajları şunlardır:

• Projeye yalnızca gerekli özellikleri eklemek.
• Kullanılmayan kodların projeyi gereksiz yere büyütmesini önlemek.
• Modülleri bağımsız şekilde güncelleyebilmek.
• Farklı oyun projelerinde farklı özellik kombinasyonları kullanabilmek.

Modüllerin yönetimi için eklentinin sürüm kontrol aracı kullanılabilir.

3. C# Kod Kullanımı

YG2 Doc, eklentinin C# üzerinden nasıl kullanılacağını da açıklar.

Temel kullanım için ilgili isim alanı projeye eklenir:

using YG;

Eklentinin birçok fonksiyonu YG2 sınıfı üzerinden çağrılır.

Örneğin tam ekran reklam göstermek için dokümantasyonda şu kullanım yer alır:

YG2.InterstitialAdvShow();

Bu kod, ilgili reklam modülü projeye eklenmiş ve gerekli platform ayarları yapılmış olduğunda reklam çağrısını başlatmak için kullanılır.

Geliştiricilerin ilgili fonksiyonların kullanım koşullarını, olaylarını ve geri dönüşlerini dokümantasyondaki modül açıklamalarından incelemesi gerekir.

4. EventsYG2 Bileşeni

YG2 Doc içerisinde anlatılan araçlardan biri de EventsYG2 bileşenidir.

Bu bileşen, bazı eklenti fonksiyonlarının doğrudan kod yazılmadan Unity Inspector üzerinden belirli olaylara bağlanmasına yardımcı olur.

Örneğin bir oyun arayüzündeki butona reklam gösterme fonksiyonu atanabilir. Böylece geliştirici, ilgili işlemi her defasında ayrı bir C# metodu yazarak yönetmek zorunda kalmaz.

EventsYG2 özellikle görsel arayüzlerle çalışan ve olay tabanlı oyun mantığını tercih eden geliştiriciler için kullanışlıdır.

YG2 Doc ile WebGL Derleme İşlemleri

Yandex Games üzerinde yayımlanacak Unity oyunlarının WebGL çıktısı hazırlanmalıdır.

YG2 dokümantasyonu, platforma uygun WebGL şablonunun seçilmesi ve proje ayarlarının yapılandırılması hakkında bilgi verir.

Temel süreç şu şekildedir:

1. Unity projesinde hedef platform WebGL olarak seçilir.
2. Plugin Your Games ayarları açılır.
3. Basic Settings bölümünden hedef platform belirlenir.
4. WebGL Template ayarları kontrol edilir.
5. Gerekli modüller ve platform seçenekleri yapılandırılır.
6. Proje WebGL olarak derlenir.
7. Oluşturulan oyun paketi test edilir.

Eklentide bulunan Auto Apply Settings seçeneği, platform için önerilen bazı proje ayarlarının otomatik uygulanmasını sağlayabilir.

YG2 Doc ile Oyun Testi Nasıl Yapılır?

YG2 dokümantasyonu, yalnızca oyun yayımlama sürecini değil, test aşamasını da kapsar.

Geliştiriciler oyunlarını yerel ortamda çalıştırabilir, WebGL derlemesini kontrol edebilir ve gerekli durumlarda Yandex Games taslak ortamında test gerçekleştirebilir.

Dokümantasyonda ayrıca yerel WebGL derlemesini Yandex Games ortamına bağlı şekilde çalıştırmaya yönelik bir yöntem açıklanır.

Bu süreçte Node.js ve npm gibi araçlar gerekebilir. Yerel test için platform ayarlarında gerekli oyun kimliği ve bağlantı parametreleri yapılandırılmalıdır.

Test sürecinde şu noktalar kontrol edilmelidir:

• Oyunun doğru şekilde yüklenmesi.
• SDK başlatma işleminin tamamlanması.
• Reklamların beklenen şekilde çalışması.
• Oyuncu kayıtlarının doğru saklanması.
• Oyun duraklatma ve devam ettirme işlemleri.
• Mobil ve masaüstü tarayıcı uyumluluğu.

YG2 Doc Resmî Dokümantasyon Adresi

Plugin Your Games 2.0 için dokümantasyonun yayımlandığı adres:

https://max-games.ru/plugin-yg/doc

Bu sayfada kurulum, modüler sistem, kod kullanımı, EventsYG2, WebGL derleme ve test işlemleriyle ilgili açıklamalar bulunur.

Eklentinin kaynak koduna ve sürüm geçmişine ulaşmak isteyen geliştiriciler GitHub deposunu da inceleyebilir:

https://github.com/JustPlay-Max/Unity-PluginYG-2

YG2 Doc Kullanmanın Avantajları

YG2 Doc, geliştiricilerin eklentiyi daha bilinçli ve doğru şekilde kullanmasına yardımcı olur.

Öne çıkan avantajları şunlardır:

1. Kurulum kolaylığı: Eklentinin Unity projesine nasıl aktarılacağını açıklar.
2. Teknik referans: Sınıflar, metotlar ve modüller hakkında bilgi sağlar.
3. Hata çözümü: Yaygın kurulum ve yapılandırma sorunlarının araştırılmasına yardımcı olur.
4. Modül yönetimi: İhtiyaç duyulan özelliklerin nasıl ekleneceğini gösterir.
5. Test desteği: Yerel test ve WebGL derleme süreçlerini açıklar.
6. Geliştirme verimliliği: Platform entegrasyonunda doğru yöntemlerin kullanılmasını kolaylaştırır.

YG2 Doc Hakkında Sık Sorulan Sorular

YG2 Doc nedir?

YG2 Doc, Plugin Your Games 2.0 Unity eklentisinin kurulum, yapılandırma ve kod kullanımı hakkında bilgi veren teknik dokümantasyonudur.

YG2 Doc ücretsiz kullanılabilir mi?

Dokümantasyon web üzerinden erişilebilir durumdadır. Eklentinin güncel lisans ve kullanım koşulları için resmî indirme ve dağıtım sayfaları incelenmelidir.

YG2 Doc hangi oyun motoru için hazırlanmıştır?

Plugin Your Games 2.0, Unity oyun motoru için geliştirilmiştir. Dokümantasyon da Unity projelerinde eklentinin kullanımını açıklar.

YG2 Doc üzerinden reklam entegrasyonu öğrenilebilir mi?

Evet. Dokümantasyonda reklam modüllerinin kurulumu ve reklam gösterme fonksiyonlarının kullanımı anlatılır.

YG2 Doc oyuncu kayıtlarını yönetmeyi açıklar mı?

Evet. Storage modülü ve bulut kayıt sistemiyle ilgili kullanım bilgileri dokümantasyonda yer alır.

YG2 Doc ile WebGL oyunu hazırlanabilir mi?

Dokümantasyon, Unity projesinin WebGL için yapılandırılması ve derlenmesi konusunda geliştiricilere rehberlik eder. Derleme işlemi Unity üzerinden gerçekleştirilir.

YG2 Doc ile Yandex Games SDK aynı şey midir?

Hayır. YG2 Doc, Plugin Your Games 2.0 eklentisinin dokümantasyonudur. Eklenti ise Yandex Games SDK ve diğer desteklenen platformlarla entegrasyonu kolaylaştıran bir Unity aracıdır.

Sonuç

YG2 Doc, Plugin Your Games 2.0 kullanarak Unity oyunlarını Yandex Games platformuna hazırlayan geliştiriciler için önemli bir teknik kaynaktır.

Kurulumdan modül yönetimine, C# kodlarından reklam entegrasyonuna ve WebGL testlerine kadar farklı aşamalarda yol gösterir.

Unity ile oyun geliştiren yazılımcılar, YG2 Doc’u kullanarak eklentinin özelliklerini daha iyi anlayabilir ve platform entegrasyon süreçlerini daha düzenli yönetebilir.