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

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;
}

نکته‌ها​

یادداشت

همچنین این callback می تواند توسط NPC نیز صدا زده شود.

نکته

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

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

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

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

توابع مرتبط​

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