SA-MP C++ Pluginden Pawn Callback Çağırma
Native çağrıda kontrol Pawn’dadır: gamemode bir C++ fonksiyonunu çağırır. Callback’te yön tersine döner: plugin bir olay üretir ve Pawn’daki public fonksiyonu çalıştırır.
Bu bölümde pluginin OnPluginMessage adlı özel bir Pawn callback’i çağırmasını sağlayacağız.
Pawn callback sözleşmesini tanımla
Bölüm başlığı “Pawn callback sözleşmesini tanımla”starter.inc dosyasına callback bildirimini ekle:
forward OnPluginMessage(code, const message[]);Gamemode callback’i public olarak uygular:
public OnPluginMessage(code, const message[]){ printf("Plugin event %d: %s", code, message); return 1;}forward, compiler’a fonksiyon imzasını tanıtır. public, fonksiyonu AMX public tablosuna koyar; C++ tarafındaki amx_FindPublic yalnızca bu tabloda bulunan fonksiyonları bulabilir.
Callback’i mevcut AMX üzerinde çağır
Bölüm başlığı “Callback’i mevcut AMX üzerinde çağır”İlk örnekte olayı bir native tetikleyecek. Böylece native’in aldığı amx pointer’ının hâlâ geçerli olduğunu biliyoruz:
cell AMX_NATIVE_CALL Plugin_EmitMessage(AMX* amx, cell* params){ if (!HasParams(params, 2)) { return 0; }
std::string message; if (!ReadPawnString(amx, params[2], message)) { return 0; }
int callbackIndex = 0; if (amx_FindPublic(amx, "OnPluginMessage", &callbackIndex) != AMX_ERR_NONE) { return 0; }
cell stringAddress = 0; int error = amx_PushString( amx, &stringAddress, nullptr, message.c_str(), 0, 0 );
if (error != AMX_ERR_NONE) { return 0; }
error = amx_Push(amx, params[1]);
cell callbackResult = 0; if (error == AMX_ERR_NONE) { error = amx_Exec(amx, &callbackResult, callbackIndex); }
amx_Release(amx, stringAddress);
if (error != AMX_ERR_NONE) { return 0; }
return callbackResult;}Native bildirimi:
native Plugin_EmitMessage(code, const message[]);Test çağrısı:
new callbackResult = Plugin_EmitMessage(200, "Connection ready");printf("Callback returned: %d", callbackResult);Parametreler neden ters sırayla push edilir?
Bölüm başlığı “Parametreler neden ters sırayla push edilir?”Pawn callback imzası şöyledir:
OnPluginMessage(code, message[])AMX stack yapısı nedeniyle C++ tarafı önce son parametreyi push eder:
1. message2. code3. amx_ExecÜç parametreli bir callback’te sıra third, second, first olur. Yanlış sıra çoğu zaman compile hatası üretmez; callback içinde bozuk değer veya geçersiz adres olarak ortaya çıkar.
Ayrılan AMX belleğini serbest bırak
Bölüm başlığı “Ayrılan AMX belleğini serbest bırak”amx_PushString, metni callback çalışana kadar AMX heap alanına kopyalar ve başlangıç adresini stringAddress içine yazar. amx_Exec tamamlandıktan sonra amx_Release çağrısı bu geçici alanı serbest bırakır.
Şu sırayı koru:
- string veya dizi için AMX belleği ayır,
- diğer parametreleri ters sırada push et,
- callback’i çalıştır,
- sonucu al,
- ayrılan belleği serbest bırak.
Hata yolunda da amx_Release çağrılmalıdır. Örnekte string başarıyla push edildikten sonraki bütün yollar ortak serbest bırakma noktasına gider.
Birden fazla gamemode ve filterscript
Bölüm başlığı “Birden fazla gamemode ve filterscript”Plugin kendi ürettiği olayı bütün script’lere gönderecekse aktif AMX örneklerini ayrı ayrı takip etmelidir:
#include <algorithm>#include <vector>
std::vector<AMX*> loadedScripts;
PLUGIN_EXPORT int PLUGIN_CALL AmxLoad(AMX* amx){ const int error = amx_Register(amx, pluginNatives, -1); if (error != AMX_ERR_NONE) { return error; }
loadedScripts.push_back(amx); return AMX_ERR_NONE;}
PLUGIN_EXPORT int PLUGIN_CALL AmxUnload(AMX* amx){ loadedScripts.erase( std::remove(loadedScripts.begin(), loadedScripts.end(), amx), loadedScripts.end() );
return AMX_ERR_NONE;}Tek bir global AMX* saklamak yanlıştır. Son yüklenen filterscript pointer’ı önceki script’i ezer; script kaldırıldığında elde geçersiz bir adres kalabilir.
Native kayıt işlemi başarısız olursa AMX listeye eklenmez. Böylece callback yayını, plugini kullanmaya hazır olmayan bir script’e gitmez.
Callback bulunamazsa ne olur?
Bölüm başlığı “Callback bulunamazsa ne olur?”amx_FindPublic, callback tanımlı değilse AMX_ERR_NOTFOUND döndürür. Özel olay isteğe bağlıysa bunu normal bir durum kabul edip ilgili script’i atlayabilirsin. Callback zorunluysa açık bir log yaz ve plugin API belgesinde gereksinimi belirt.
OnPluginMessage içindeki return, amx_Exec üzerinden callbackResult değişkenine gelir. Bu değerin ne anlama geldiğini callback sözleşmesi belirler. Örneğimizde sonucu native çağıran Pawn koduna aynen döndürüyoruz.
Bölüm kontrolü
Bölüm başlığı “Bölüm kontrolü”- Callback Pawn tarafında hem
forwardhempublicolarak tanımlı. - Parametreler ters sırada push ediliyor.
amx_Execveamx_FindPublichata kodları kontrol ediliyor.- Geçici string belleği
amx_Releaseile bırakılıyor. - Kaldırılan AMX pointer’ı listeden siliniyor.
Sıradaki adım: ProcessTick ve thread güvenliğini kur.