پرش به مطلب اصلی

OnPlayerText

توضیحات

این کالبک زمانی فراخوانده می‌شود که بازیکن پیامی در چت ارسال می‌کند.

نامتوضیحات
playeridشناسه بازیکنی که پیام را ارسال کرده.
text[]محتوای پیامی که بازیکن ارسال کرده.

مقادیر برگشتی

همیشه ابتدا در فیلتراسکریپت‌ها فراخوانده می‌شود، بنابراین برگرداندن 0 باعث مسدود شدن پردازش آن توسط اسکریپت‌های دیگر می‌شود.

مثال‌ها

public OnPlayerText(playerid, text[])
{
new string[144];
format(string, sizeof (string), "(%d) %s", playerid, text);
SendPlayerMessageToAll(playerid, string);

// Returning 0 ignores the default message format and sends the custom one instead.
// Returning 1 will result in the message being duplicated, as the default message will also be sent.
return 0;
}

نکته‌ها

نکته

This callback can also be called by NPC.

نکته

به طور پیش‌فرض، این کالبک پیامی حاوی محتوای پیام، نام بازیکن و شناسه آن‌ها ارسال می‌کند. برگرداندن 0 این رفتار پیش‌فرض را نادیده می‌گیرد، همان‌طور که در مثال کد بالا نشان داده شده.

کالبک‌های مرتبط

کالبک‌های زیر ممکن است مفید باشند، زیرا به نوعی با این کالبک در ارتباط هستند.

  • OnPlayerCommandText: زمانی فراخوانده می‌شود که بازیکن دستوری تایپ می‌کند.

توابع مرتبط

توابع زیر ممکن است مفید باشند، زیرا به نوعی با این کالبک در ارتباط هستند.