Getting Started

Gametegra SDK, oyununuzu SuperApp ekosistemi icinde calistirmanizi saglayan bir SDK'dir. Oyununuz bir mini-app olarak SuperApp icinde yuklenir ve SDK araciligiyla platform ozellikleriyle iletisim kurar.

SDK Secimi

Platform	SDK	Dil
Web / HTML5	@gametegra/gametegra-core	JavaScript
Unity (WebGL)	com.gametegra.sdk	C#
Godot (Web Export)	gametegra_sdk plugin	GDScript

Hizli Baslangic

JavaScript

import gameTegra from '@gametegra/gametegra-core'

// SDK hazir olana kadar bekle
gameTegra.onReady((detail) => {
  console.log('SDK hazir!', detail)
})

// Kullanici bilgisi al
const userInfo = await gameTegra.getInfo()
console.log('Kullanici:', userInfo)

// Oda olustur
const room = await gameTegra.createRoom({ maxPlayers: 4 })

Unity (C#)

using GametegraSDK;

// Kullanici bilgisi al
var userInfo = await gameTegra.getUserInfo();
Debug.Log($"Kullanici: {userInfo.name}");

// Oda olustur
var room = await gameTegra.createRoom(
    gameTegra.@params("maxPlayers", 4)
);

Godot (GDScript)

# gameTegra autoload olarak eklenmis olmali
var user_info = await gameTegra.getUserInfo()
print("Kullanici: ", user_info)

# Oda olustur
var room = await gameTegra.createRoom({ "maxPlayers": 4 })

Temel Kavramlar

Game Methods

Oyun mantigiyla ilgili hazir methodlardir. Oda olusturma, katilma, skor alma, veri kaydetme gibi sik kullanilan islemler icin dogrudan SDK uzerinden erisilebilir.

Game Method (Custom)

SDK'nin hazir sunmadigi backend fonksiyonlarini custom() ile cagirabilirsiniz. JS tarafinda isterseniz setMethodMap() + callGameMethod() ile daha okunabilir alias'lar da tanimlayabilirsiniz.

Yaygin kullanim senaryolari:

• Envanter (getInventory, useItem, buyItem)
• Oyun ici ekonomi (claimReward, upgradeItem)
• Ozel turnuva/match akisi (joinTournament, submitRoundResult)

Stream & Realtime

Gercek zamanli veri akisi icin kullanilir:

• listenData - Platformdan gelen veriyi dinleme (gyroscope, game events vs.)
• sendData - Platforma veri gonderme

App Methods (Native Features)

Cihaz ve platform ozelliklerine erisen methodlar: kamera, galeri, konum, titresim, odeme, dil bilgisi gibi.

Response Format

Tum methodlar asenkron olarak calisir ve bir Promise/Task/await dondurur.

JavaScript:

const result = await gameTegra.createRoom({ maxPlayers: 4 })
// result icerigi backend tarafindan belirlenir

Unity/Godot: Dogrudan sonuc verisi doner.

Sonraki Adimlar

• Kurulum - Platform bazli kurulum adimlari
• Game Methods - Oyun methodlari (createRoom, saveData vs.)
• Stream - Gercek zamanli veri akislari
• Game Method (Custom) - Ozel backend method cagirma
• Controls - Sanal joystick ve butonlar
• Dev Console - WebView icinde debug paneli
• Tum API Referansi