SAMP/OnPlayerUpdate

Материал из WiKiPi

OnPlayerUpdate

Wiki added.png

Добавлено

Обратный вызов работает только начиная с версии SA-MP 0.2X и не будет работать в предыдущих версиях!


Описание:

Срабатывает, когда клиент игрока обновляет/синхронизирует своё состояние.


Параметры:

(playerid)


playeridID игрока, состояние которого обновлено.


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

В моде:
1: состояние игрока будет обновлено.
0: состояние игрока не будет обновлено.
В скриптах:
1: позволяет обрабатывать обратный вызов в других скриптах, состояние игрока будет обновлено.
0: отключает обработку обратного вызова в других скриптах, состояние игрока не будет обновлено.


Wiki note.png

Примечание

Этот обратный вызов вызывается в среднем 30 раз в секунду для каждого игрока. Используйте его только тогда, когда знаете, для чего он предназначен (или, что более важно, для чего он не предназначен). Частота, с которой этот обратный вызов вызывается для каждого игрока, варьируется в зависимости от того, что делает игрок. Вождение или стрельба вызовут гораздо больше обновлений, чем простой. Большинство типовых задач можно решить с помощью таймеров с меньшей периодичностью срабатывания.


Wiki note important.png

Важное
примечание

Функция вызывается сначала в фильтрскриптах, затем в моде.


Wiki tip.png

Подсказка

Обратный вызов работает не только для игроков, но и для NPC.


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

public OnPlayerUpdate(playerid)
{
	new weaponid = GetPlayerWeapon(playerid);
	switch(weaponid)
	{
		// Пулемёт и гранатомёт не разрешены на сервере
		case WEAPON_ROCKETLAUNCHER, WEAPON_HEATSEEKER, WEAPON_MINIGUN: return 0; // Рассинхронизируем игрока с запрещённым оружием, чтобы он не мог нанести урон другим игрокам
	}
	return 1;
}