SendClientMessage

Материал из Pro-Pawn Wiki
Версия от 16:36, 2 февраля 2019; Daniel-Cortez (обсуждение | вклад)

(разн.) ← Предыдущая | Текущая версия (разн.) | Следующая → (разн.)
Перейти к: навигация, поиск

Описание:

Отправляет игроку сообщение, которое отображается в игровом чате.

Параметры:

(playerid, color, const message[])
playerid ID игрока, которому будет доставлено сообщение.
color Цвет сообщения (см. ниже).
const message[] Текст сообщения.


Возвращаемое значение:

Возвращает 1 в случае успеха, либо 0, если игрок playerid не подключен.

Info rhombus.png
Примечание
Цвет сообщения (параметр color) закодирован в формате 0xRRGGBBXX, где RR, GG и BB - градации красного, зелёного и синего, а XX не имеет никакого эффекта (возможно, ранее задумывался под прозрачность).
В текст сообщения также можно встраивать переключатели цвета в формате {RRGGBB}.
Пример:
SendClientMessage(playerid, 0xFF000000, "красный {00FF00}зелёный {0000FF}синий");

Вывод: красный зелёный синий.


Зачастую белый цвет в параметре color записывают как -1, поскольку это то же самое, что 0xFFFFFFFF, только в более кратком и удобном десятичном виде.


Bug.png
Баг SA-MP
Если текст сообщения длиннее 144 символов (145 с учётом завершающего '\0'), он не будет отправлен в чат.
Если в тексте сообщения присутствует символ '%', он не будет отображён в чате. Для того, чтобы правильно отобразить этот символ, его следует продублировать ("%%").


Bug.png
Баг SA-MP
Передача текста, содержащего форматный спецификатор %s или %n, приведёт к падению сервера.


Пример использования:

const COLOR_ORANGE = 0xFF7F0000; // Оранжевый цвет

public OnPlayerConnect(playerid)
{
    SendClientMessage(playerid, COLOR_ORANGE, "Добро пожаловать на наш сервер!");
}


См. также: