RU/triggerClientEvent - Revision history

Flox at 15:49, 10 February 2026

2026-02-10T15:49:03Z

← Older revision		Revision as of 15:49, 10 February 2026
Line 82:		Line 82:

	==Смотрите также==		==Смотрите также==
	{{/Event functions}}		{{RU/Event functions}}

	[[en:triggerClientEvent]]		[[en:triggerClientEvent]]

Flox at 15:48, 10 February 2026

2026-02-10T15:48:30Z

← Older revision		Revision as of 15:48, 10 February 2026
Line 82:		Line 82:

	==Смотрите также==		==Смотрите также==
	{{RU/Event functions}}		{{/Event functions}}

	[[en:triggerClientEvent]]		[[en:triggerClientEvent]]

EOFIK at 17:19, 7 June 2022

2022-06-07T17:19:47Z

← Older revision		Revision as of 17:19, 7 June 2022
Line 82:		Line 82:

	==Смотрите также==		==Смотрите также==
	~~===Серверные функции===~~
	{{RU/Event functions}}		{{RU/Event functions}}
	~~===Клиентские функции===~~
	~~{{RU/Client_event functions}}~~
	~~===Общие функции===~~
	~~{{RU/Shared_event functions}}~~
	[[en:triggerClientEvent]]		[[en:triggerClientEvent]]

EOFIK at 17:16, 7 June 2022

2022-06-07T17:16:22Z

← Older revision		Revision as of 17:16, 7 June 2022
Line 82:		Line 82:

	==Смотрите также==		==Смотрите также==
			===Серверные функции===
	{{RU/Event functions}}		{{RU/Event functions}}
			===Клиентские функции===
			{{RU/Client_event functions}}
			===Общие функции===
			{{RU/Shared_event functions}}
	[[en:triggerClientEvent]]		[[en:triggerClientEvent]]

Damage22: /* Пример */

2010-07-08T16:05:40Z

Пример

← Older revision		Revision as of 16:05, 8 July 2010
Line 24:		Line 24:
	Возвращает ''true'' если вызов события был успешно сделан, ''false'' если указаны некорректные аргументы.		Возвращает ''true'' если вызов события был успешно сделан, ''false'' если указаны некорректные аргументы.

	==~~Пример~~==		==Примеры==
	===Пример 1===		===Пример 1===
	В этом примере сервер передает простое сообщение "Превед медвед!" всем клиентам.		В этом примере сервер передает простое сообщение "Превед медвед!" всем клиентам.

Damage22: /* Example 2 */

2010-07-08T16:05:28Z

Example 2

← Older revision		Revision as of 16:05, 8 July 2010
Line 49:		Line 49:


	===~~Example~~ 2===		===Пример 2===
	В этом примере сервер передает простое сообщение "Превед медвед!" только '''одному''' клиенту.		В этом примере сервер передает простое сообщение "Превед медвед!" только '''одному''' клиенту.

Damage22 at 16:05, 8 July 2010

2010-07-08T16:05:09Z

← Older revision		Revision as of 16:05, 8 July 2010
Line 14:		Line 14:
	===Обязательные аргументы===		===Обязательные аргументы===
	*'''name:''' Название события на стороне клиента. Оно должно быть зарегистрировано на стороне клиента с помощью [[RU/addEvent\|addEvent]] и иметь хотя бы один обработчик, добавленный с помощью [[RU/addEventHandler\|addEventHandler]].		*'''name:''' Название события на стороне клиента. Оно должно быть зарегистрировано на стороне клиента с помощью [[RU/addEvent\|addEvent]] и иметь хотя бы один обработчик, добавленный с помощью [[RU/addEventHandler\|addEventHandler]].
	*'''theElement:''' Элемент, который будет источником [[Event system#Event handlers\|source]] события. Это может быть другой игрок, или корень (root element) если это непринципиально.		*'''theElement:''' Элемент, который будет источником [[Event system#Event handlers\|source]] события. Это может быть, например, другой игрок, или корень (root element), если это непринципиально.

	===Дополнительные аргументы===		===Дополнительные аргументы===

Damage22: Created page with 'NOTOC {{RU/Server function}} Эта функция позволяет вызвать срабатывание события, предварительно созданног…'

2010-07-08T12:55:08Z

Created page with '__NOTOC__ {{RU/Server function}} Эта функция позволяет вызвать срабатывание события, предварительно созданног…'

New page

__NOTOC__
{{RU/Server function}}
Эта функция позволяет вызвать срабатывание события, предварительно созданного на клиенте. Она относится к основным средствам обмена информацией между сервером и клиентом. На клиентской стороне существует аналогичная функция [[RU/triggerServerEvent|triggerServerEvent]] работающая в противоположном направлении. Эту функцию можно рассматривать как асинхронный вызов функции с использованием [[RU/triggerServerEvent|triggerServerEvent]] для получения ответа\результата, если таковой требуется.

Передавать можно почти любые типы данных, включая элементы ([[element]]) и сложные вложенные таблицы ([[table]]). Данные неэлементных типов МТА, например указатели на xml (xmlNodes) или указатели на ресурсы не могут быть переданы, поскольку у них может и не существовать какого-либо представления на стороне клиента.

Вызовы посылаются надежно, поэтому клиенты их получат, однако возможны (хотя, как правило, незначительные) задержки в получении, что также следует принимать во внимание. Также следует учитывать вопросы пропускной способности канала - не отправляйте большой объем данных без необходимости. Отправка одного большого вызова ненамного эффективнее отправки нескольких маленьких.

==Синтаксис==
<syntaxhighlight lang="lua">
bool triggerClientEvent ( [element triggerFor=getRootElement()], string name, element theElement, [arguments...] )
</syntaxhighlight>

===Обязательные аргументы===
*'''name:''' Название события на стороне клиента. Оно должно быть зарегистрировано на стороне клиента с помощью [[RU/addEvent|addEvent]] и иметь хотя бы один обработчик, добавленный с помощью [[RU/addEventHandler|addEventHandler]].
*'''theElement:''' Элемент, который будет источником [[Event system#Event handlers|source]] события. Это может быть другой игрок, или корень (root element) если это непринципиально.

===Дополнительные аргументы===
{{OptionalArg}}
*'''triggerFor:''' Событие будет вызвано для всех игроков ( [[player]] ) которые являются потомками этого элемента. По умолчанию это корень, поэтому событие будет вызвано для всех элементов (для всех игроков). Если вы укажете только конкретного игрока, событие будет вызвано только для него.
*'''arguments...:''' Список аргументов, которые будут передаваться вместе с событием. Можно передавать любые типы lua (кроме функций), а также любые элементы ([[element]]).

===Вывод===
Возвращает ''true'' если вызов события был успешно сделан, ''false'' если указаны некорректные аргументы.

==Пример==
===Пример 1===
В этом примере сервер передает простое сообщение "Превед медвед!" всем клиентам.

<section name="Client" class="client" show="true">
<syntaxhighlight lang="lua">
function greetingHandler ( message )
outputChatBox ( "The server says: " .. message )
end
addEvent( "onGreeting", true )
addEventHandler( "onGreeting", getRootElement(), greetingHandler )
</syntaxhighlight>
</section>
<section name="Server" class="server" show="true">
<syntaxhighlight lang="lua">
function greetingCommand ( playerSource, commandName )
triggerClientEvent ( "onGreeting", getRootElement(), "Превед медвед!" )
end
addCommandHandler ( "greet", greetingCommand )
</syntaxhighlight>
</section>

Когда выполняется консольная команда "greet" (вводится через консоль сервера или игрока), на стороне сервера вызывается функция ''greetingCommand''. Она вызывает срабатывание на стороне клиента события ''onGreeting'' с параметром "Превед медвед!". В результате вызывается функция-обработчик ''greetingHandler'', которая и пишет полученное с сервера сообщение в чат.

===Example 2===
В этом примере сервер передает простое сообщение "Превед медвед!" только '''одному''' клиенту.

<section name="Client" class="client" show="true">
<syntaxhighlight lang="lua">
function greetingHandler ( message )
outputChatBox ( "The server says: " .. message )
end
addEvent( "onGreeting", true )
addEventHandler( "onGreeting", getRootElement(), greetingHandler )
</syntaxhighlight>
</section>
<section name="Server" class="server" show="true">
<syntaxhighlight lang="lua">
function greetingCommandOne ( playerSource, commandName, playerName )
if playerName then
local thePlayer = getPlayerFromName ( playerName )
if thePlayer then
triggerClientEvent ( thePlayer, "onGreeting", getRootElement(), "Превед медвед!" )
else
-- указано неправильное имя
end
else
-- не указано имя
end
end
addCommandHandler ( "greet_one", greetingCommandOne )
</syntaxhighlight>
</section>

Пример работает так же, как и предыдущий, за исключением того, что для triggerClientEvent указывается дополнительный аргумент ''thePlayer''.

==Смотрите также==
{{RU/Event functions}}
[[en:triggerClientEvent]]