İçeriğe geç

Görev 8 — Callback telsizini dinle

Kazanacağın yetenek: SA-MP olaylarını doğru callback ve dönüş değeriyle karşılamak.

Normal fonksiyonu sen çağırırsın; callback’i SA-MP sunucusu çağırır. Oyuncunun bağlanması, doğması, komut yazması veya ayrılması bir olay üretir ve sunucu uygun public fonksiyonu bulur.

Basitleştirilmiş bir oyuncu oturumu şöyle ilerler:

Gamemode yüklenir
└─ OnGameModeInit
Oyuncu bağlanır
└─ OnPlayerConnect
Oyuncu sınıf seçer ve doğar
└─ OnPlayerRequestClass → OnPlayerRequestSpawn → OnPlayerSpawn
Oyuncu etkileşir
├─ OnPlayerCommandText
├─ OnPlayerText
└─ diğer oyun olayları
Oyuncu ayrılır
└─ OnPlayerDisconnect

Bu şema her olası callback’i göstermez. Filterscript ve gamemode birlikte çalıştığında çağrı sırası ve yayılma davranışı callback’e göre değişebilir.

public OnPlayerDisconnect(playerid, reason)
{
printf("Oyuncu %d ayrildi. Neden kodu: %d", playerid, reason);
PlayerData[playerid][playerScore] = 0;
PlayerData[playerid][isPlayerOnMission] = false;
return 1;
}

playerid, olayın hangi oyuncuya ait olduğunu; reason, ayrılma nedenini taşır. Parametre adını değiştirebilirsin ama sırasını veya beklenen tag’ini keyfî değiştiremezsin.

Callback yalnızca olayı karşılasın; asıl iş tekrar kullanılabilir fonksiyonda olsun:

public OnPlayerSpawn(playerid)
{
PreparePlayer(playerid);
return 1;
}
PreparePlayer(playerid)
{
SetPlayerHealth(playerid, 100.0);
GivePlayerMoney(playerid, 500);
return 1;
}

Böylece “oyuncu doğdu” olayı ile “oyuncuyu başlangıç durumuna getir” davranışı birbirine karışmaz.

Callback dönüş değeri, olayın diğer scriptlere aktarılması veya varsayılan davranış üzerinde etkili olabilir. Anlam callback’e özeldir. Örneğin OnPlayerCommandText, komut işlendiğinde 1, işlenmediğinde 0 döndürür. Başka callback’te aynı sayı farklı anlama gelebilir.

Bu yüzden:

  1. Callback’in resmi sayfasını aç.
  2. Returns bölümünü oku.
  3. Filterscript ve gamemode için ek notları kontrol et.
  4. Sonra dönüş değerini seç.
Callback Ne zaman? Başlangıçta ne için?
OnGameModeInit Gamemode başlarken Sınıflar, araçlar, genel ayarlar
OnPlayerConnect Bağlantı kabul edildiğinde Oturum verisini başlatma, karşılama
OnPlayerSpawn Oyuncu doğduğunda Sağlık, konum veya başlangıç ekipmanı
OnPlayerCommandText / ile komut gönderildiğinde Basit komutları işleme
OnPlayerDisconnect Oyuncu ayrıldığında Veriyi kaydetme ve oturumu temizleme
OnGameModeExit Gamemode kapanırken Kaynakları güvenli kapatma

Bir callback’in kim tarafından çağrıldığını, parametrelerin nereden geldiğini ve neden her callback’te dönüş değerini ayrı kontrol etmen gerektiğini açıklayabiliyorsan devam et.

Sonraki adım: öğrendiklerini ilk oyun mekaniğinde birleştir.