İçeriğe geç

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.

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.

İ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);

Pawn callback imzası şöyledir:

OnPluginMessage(code, message[])

AMX stack yapısı nedeniyle C++ tarafı önce son parametreyi push eder:

1. message
2. code
3. 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.

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:

  1. string veya dizi için AMX belleği ayır,
  2. diğer parametreleri ters sırada push et,
  3. callback’i çalıştır,
  4. sonucu al,
  5. 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.

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.

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.

  • Callback Pawn tarafında hem forward hem public olarak tanımlı.
  • Parametreler ters sırada push ediliyor.
  • amx_Exec ve amx_FindPublic hata kodları kontrol ediliyor.
  • Geçici string belleği amx_Release ile bırakılıyor.
  • Kaldırılan AMX pointer’ı listeden siliniyor.

Sıradaki adım: ProcessTick ve thread güvenliğini kur.