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.
Temel yaşam döngüsü
Bölüm başlığı “Temel yaşam döngüsü”Basitleştirilmiş bir oyuncu oturumu şöyle ilerler:
Gamemode yüklenir └─ OnGameModeInitOyuncu bağlanır └─ OnPlayerConnectOyuncu sınıf seçer ve doğar └─ OnPlayerRequestClass → OnPlayerRequestSpawn → OnPlayerSpawnOyuncu etkileşir ├─ OnPlayerCommandText ├─ OnPlayerText └─ diğer oyun olaylarıOyuncu ayrılır └─ OnPlayerDisconnectBu ş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.
Parametre olayın bağlamıdır
Bölüm başlığı “Parametre olayın bağlamıdır”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 ile normal fonksiyonu ayır
Bölüm başlığı “Callback ile normal fonksiyonu ayır”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.
return 1 ezber değildir
Bölüm başlığı “return 1 ezber değildir”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:
- Callback’in resmi sayfasını aç.
- Returns bölümünü oku.
- Filterscript ve gamemode için ek notları kontrol et.
- Sonra dönüş değerini seç.
Sık kullanılan ilk callback’ler
Bölüm başlığı “Sık kullanılan ilk callback’ler”| 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 |
Kontrol noktası
Bölüm başlığı “Kontrol noktası”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.