Callback функции - История изменений

Aka sektor в 12:14, 30 августа 2024

2024-08-30T12:14:26Z

← Предыдущая версия		Версия от 15:14, 30 августа 2024
Строка 9:		Строка 9:
	\|-		\|-
	\| '''Дополнили'''		\| '''Дополнили'''
	\| ~~BoBaH_671 a.k.a. Overfirst~~, Graff46, Charsi		\| [[Overf1rst]], Graff46, Charsi
	\|-		\|-
	\| '''Тип статьи'''		\| '''Тип статьи'''

Aka sektor в 18:13, 26 июня 2022

2022-06-26T18:13:30Z

← Предыдущая версия		Версия от 21:13, 26 июня 2022
Строка 152:		Строка 152:
	\| <code>generic_object_binder:hear_callback(self, who_id, sound_type, sound_position, sound_power)</code>		\| <code>generic_object_binder:hear_callback(self, who_id, sound_type, sound_position, sound_power)</code>
	\|}		\|}


	== Использование callback функций ==		== Использование callback функций ==
Строка 202:		Строка 201:
	<code>funct_name</code> — имя функции в скрипте.		<code>funct_name</code> — имя функции в скрипте.
	\|}		\|}


	== Источник ==		== Источник ==
	{{~~References~~}}		{{reflist\|3}}

	[[Категория:Игровые архивы]][[Категория:Скрипты]]		[[Категория:Игровые архивы]][[Категория:Скрипты]]

Aka sektor: Дополнил описания событий

2019-06-05T21:51:50Z

Дополнил описания событий

← Предыдущая версия		Версия от 00:51, 6 июня 2019
Строка 18:		Строка 18:
	\|}		\|}

	'''Callback''' — это скриптовая функция, привязанная к движковому событию.		'''Callback'''<ref>[https://ap-pro.ru/forum/114-3951-1 Тема "Динамическое подключение/отключение функций." на форуме AP Production]</ref> — это скриптовая функция, привязанная к движковому событию.

	Событие регистрируется в скриптовом классе строчкой, к примеру, следующего вида:		Событие регистрируется в скриптовом классе строчкой, к примеру, следующего вида:
Строка 46:		Строка 46:
	\|-		\|-
	\| <code>article_info</code>		\| <code>article_info</code>
	\|		\| Получение статьи в Энциклопедию
	\| '''ТЧ/ЧН:''' ''bind_stalker.script''		\| '''ТЧ/ЧН:''' ''bind_stalker.script''
	\| <code>actor_binder:article_callback(npc, group, name)</code>		\| <code>actor_binder:article_callback(npc, group, name)</code>
Строка 56:		Строка 56:
	\|-		\|-
	\| <code>on_item_drop</code>		\| <code>on_item_drop</code>
	\| Выкидывание предмета (из инвентаря)		\| Выкидывание предмета (исчезновение из инвентаря)
	\| '''ТЧ/ЧН/ЗП:''' ''bind_stalker.script''		\| '''ТЧ/ЧН/ЗП:''' ''bind_stalker.script''
	\| <code>actor_binder:on_item_drop (obj)</code>		\| <code>actor_binder:on_item_drop (obj)</code>
	\|-		\|-
	\| <code>trade_sell_buy_item</code>		\| <code>trade_sell_buy_item</code>
	\|		\| Подтверждение торговли
	\| '''ТЧ/ЧН/ЗП:''' ''bind_stalker.script''		\| '''ТЧ/ЧН/ЗП:''' ''bind_stalker.script''
	\| <code>actor_binder:on_trade (item, sell_bye, money)</code>		\| <code>actor_binder:on_trade (item, sell_bye, money)</code>
Строка 81:		Строка 81:
	\|-		\|-
	\| <code>take_item_from_box</code>		\| <code>take_item_from_box</code>
	\| Взятие предмета из ~~ящика~~		\| Взятие предмета из объекта с классом S_INVBOX
	\| '''ТЧ/ЧН/ЗП:''' ''bind_stalker.script''		\| '''ТЧ/ЧН/ЗП:''' ''bind_stalker.script''
	\| <code>actor_binder:take_item_from_box(box, item)</code>		\| <code>actor_binder:take_item_from_box(box, item)</code>
Строка 202:		Строка 202:
	<code>funct_name</code> — имя функции в скрипте.		<code>funct_name</code> — имя функции в скрипте.
	\|}		\|}


			== Источник ==
			{{References}}

	[[Категория:Игровые архивы]][[Категория:Скрипты]]		[[Категория:Игровые архивы]][[Категория:Скрипты]]

Aka sektor в 12:16, 27 мая 2019

2019-05-27T12:16:57Z

← Предыдущая версия		Версия от 15:16, 27 мая 2019
Строка 9:		Строка 9:
	\|-		\|-
	\| '''Дополнили'''		\| '''Дополнили'''
	\| BoBaH_671, Graff46, Charsi		\| BoBaH_671 a.k.a. Overfirst, Graff46, Charsi
	\|-		\|-
	\| '''Тип статьи'''		\| '''Тип статьи'''

Aka sektor в 16:04, 27 февраля 2019

2019-02-27T16:04:02Z

← Предыдущая версия		Версия от 19:04, 27 февраля 2019
Строка 152:		Строка 152:
	\| <code>generic_object_binder:hear_callback(self, who_id, sound_type, sound_position, sound_power)</code>		\| <code>generic_object_binder:hear_callback(self, who_id, sound_type, sound_position, sound_power)</code>
	\|}		\|}


	== Использование callback функций ==		== Использование callback функций ==

Aka sektor: Новая страница: «NOTOC {| class="wikitable" style="float:right; margin-left:0.8em; clear:right; text-align: center; font-size:12px; width: 300px;" |- | colspan=2 style="font-s…»

2019-02-22T18:11:54Z

Новая страница: «__NOTOC__ {| class="wikitable" style="float:right; margin-left:0.8em; clear:right; text-align: center; font-size:12px; width: 300px;" |- | colspan=2 style="font-s…»

Новая страница

__NOTOC__
{| class="wikitable" style="float:right; margin-left:0.8em; clear:right; text-align: center; font-size:12px; width: 300px;"
|-
| colspan=2 style="font-size:20px;"|
'''Callback функции'''
|-
| '''Автор'''
| [[Участник:aka_sektor|aka_sektor]]
|-
| '''Дополнили'''
| BoBaH_671, Graff46, Charsi
|-
| '''Тип статьи'''
| справка
|-
| '''Актуальность'''
| [[S.T.A.L.K.E.R. - Тень Чернобыля|ТЧ]], [[S.T.A.L.K.E.R. - Чистое Небо|ЧН]], [[S.T.A.L.K.E.R. - Зов Припяти|ЗП]]
|}

'''Callback''' — это скриптовая функция, привязанная к движковому событию.

Событие регистрируется в скриптовом классе строчкой, к примеру, следующего вида:
<syntaxhighlight lang="lua">
self.object:set_callback(callback.inventory_info, self.info_callback, self)
</syntaxhighlight>
Где:

<code>inventory_info</code> — название движкового события.

<code>info_callback</code> — название регистрируемой callback функции.

<code>self</code> — какому скриптовому классу принадлежит (в данном случае: <code>actor_binder</code>)

'''Callback функция''' пишется как <code>actor_binder:info_callback</code> — это означает, что она является методом класса <code>actor_binder</code>.

{| class="wikitable"
! Событие
! Описание
! Платформа / Скрипт
! Метод / Callback функция
|-
| <code>inventory_info</code>
| Выдача инфопорции владельцу инвентаря
| '''ТЧ/ЧН/ЗП:''' ''bind_stalker.script''
| <code>actor_binder:info_callback(npc, info_id)</code>
|-
| <code>article_info</code>
|
| '''ТЧ/ЧН:''' ''bind_stalker.script''
| <code>actor_binder:article_callback(npc, group, name)</code>
|-
| <code>on_item_take</code>
| Взятие предмета (попадание в инвентарь)
| '''ТЧ/ЧН/ЗП:''' ''bind_stalker.script''
| <code>actor_binder:on_item_take (obj)</code>
|-
| <code>on_item_drop</code>
| Выкидывание предмета (из инвентаря)
| '''ТЧ/ЧН/ЗП:''' ''bind_stalker.script''
| <code>actor_binder:on_item_drop (obj)</code>
|-
| <code>trade_sell_buy_item</code>
|
| '''ТЧ/ЧН/ЗП:''' ''bind_stalker.script''
| <code>actor_binder:on_trade (item, sell_bye, money)</code>
|-
| <code>task_state</code>
| Выдача задания или изменение состояния заданий или подзаданий
| '''ТЧ/ЧН/ЗП:''' ''bind_stalker.script''
| '''ТЧ:''' <code>actor_binder:task_callback(_task, _objective, _state)</code> '''ЧН/ЗП:''' <code>actor_binder:task_callback(_task, _state)</code>
|-
| <code>level_border_enter</code>
| Вход на разрешенную территорию уровня
| '''ТЧ/ЧН:''' ''bind_stalker.script''
| <code>actor_binder:level_border_enter(npc, info_id)</code>
|-
| <code>level_border_exit</code>
| Выход за разрешенную границу уровня
| '''ТЧ/ЧН:''' ''bind_stalker.script''
| <code>actor_binder:level_border_exit(npc, info_id)</code>
|-
| <code>take_item_from_box</code>
| Взятие предмета из ящика
| '''ТЧ/ЧН/ЗП:''' ''bind_stalker.script''
| <code>actor_binder:take_item_from_box(box, item)</code>
|-
| <code>use_object</code>
|
1. Съедание инвентарного предмета в инвентаре 
2. Использование объекта в игровом мире
| '''ТЧ/ЧН:''' ''ph_gate.script'' '''ЧН:''' ''mob_trader.script'' '''ЗП:''' ''bind_stalker.script bind_door_labx8.script''
| '''ТЧ/ЧН:''' <code>action_gate:use_callback(obj, who)</code> '''ЧН:''' <code>mob_trader:use_callback()</code> '''ЗП:''' <code>actor_binder:use_inventory_item(obj)</code> <code>door_binder_labx8:use_callback(obj)</code>
|-
| <code>helicopter_on_point</code>
| Достижение точки патрульного пути вертолётом
| '''ТЧ/ЧН/ЗП:''' ''bind_heli.script''
| <code>heli_binder:on_point( distance, position, path_idx )</code>
|-
| <code>helicopter_on_hit</code>
| Вертолет получает урон
| '''ТЧ/ЧН/ЗП:''' ''bind_heli.script''
| <code>heli_binder:on_hit( power, impulse, hit_type, enemy_id )</code>
|-
| <code>patrol_path_in_point</code>
| Достижение точки при ходьбе по путям
| '''ТЧ/ЧН/ЗП:''' ''bind_monster.script move_mgr.script''
| <code>generic_object_binder:waypoint_callback(obj, action_type, index)</code> <code>move_mgr:waypoint_callback(obj, action_type, index)</code>
|-
| <code>hit</code>
| Получение урона
| '''ТЧ/ЧН/ЗП:''' ''bind_monster.script'' '''ТЧ/ЧН:''' ''ph_gate.script''
| '''ТЧ/ЧН/ЗП:''' <code>generic_object_binder:hit_callback(obj, amount, local_direction, who, bone_index)</code> '''ТЧ/ЧН:''' <code>action_gate:hit_callback(obj, amount, local_direction, who, bone_index)</code>
|-
| <code>death</code>
| Смерть
| '''ТЧ/ЧН/ЗП:''' ''bind_monster.script'' '''ЧН/ЗП:''' ''bind_crow.script''
| '''ТЧ/ЧН/ЗП:''' <code>generic_object_binder:death_callback(victim, who)</code> '''ЧН/ЗП:''' <code>crow_binder:death_callback(victim, who)</code>
|-
| <code>trader_global_anim_request</code>
|
| '''ТЧ/ЧН:''' ''mob_trader.script''
| <code>mob_trader:on_global_anim_request()</code>
|-
| <code>trader_head_anim_request</code>
|
| '''ТЧ/ЧН:''' ''mob_trader.script''
| <code>mob_trader:on_head_anim_request()</code>
|-
| <code>trader_sound_end</code>
|
| '''ТЧ/ЧН:''' ''mob_trader.script''
| <code>mob_trader:on_sound_end()</code>
|-
| <code>zone_enter</code>
|
| '''ТЧ/ЧН/ЗП:''' ''xr_zones.script''
| <code>arena_zone_binder:on_enter(zone, obj)</code>
|-
| <code>zone_exit</code>
|
| '''ТЧ/ЧН/ЗП:''' ''xr_zones.script''
| <code>arena_zone_binder:on_exit(zone, obj)</code>
|-
| <code>script_animation</code>
| Окончание анимации
| '''ЧН:''' ''bind_agru_door.script bind_red_forest_bridge.script'' '''ЗП:''' ''bind_door_labx8''
| '''ЧН:''' <code>agru_door_binder:animation_end_callback(is_end)</code> <code>bridge_binder:animation_end_callback( is_end )</code> '''ЗП:''' <code>door_binder_labx8:animation_end_callback(is_end)</code>
|-
| <code>sound</code>
| Услышан звук
| '''ЗП:''' ''bind_monster.script''
| <code>generic_object_binder:hear_callback(self, who_id, sound_type, sound_position, sound_power)</code>
|}

== Использование callback функций ==
# Выберите нужную вам '''функцию'''
# Откройте соответствующий ей '''скрипт'''
# Найдите в нём соответствующий '''метод'''
# Допишите в него нужный вам '''код'''

{| class="mw-collapsible mw-collapsed wikitable"
! colspan=3 | Выдача инфопорции
|-
! Метод / Callback функция
! Код
! Описание
|-
| <code>actor_binder:on_item_take (obj)</code>
|
<syntaxhighlight lang="lua">
if obj:section() == "item_section_name" and not
has_alife_info("infoportion_name") then
give_info("infoportion_name")
end
</syntaxhighlight>
| При взятии указанного предмета, один раз будет выдана указанная инфопорция.

<code>item_section_name</code> — имя секции предмета. 
<code>infoportion_name</code> — имя инфопорции.
|}
{| class="mw-collapsible mw-collapsed wikitable"
! colspan=3 | Вызов функции
|-
! Метод / Callback функция
! Код
! Описание
|-
| <code>actor_binder:on_item_take (obj)</code>
|
<syntaxhighlight lang="lua">
if obj:section() == "item_section_name" and not has_alife_info("no_cycle_infoportion") then
script_name.funct_name()
give_info("no_cycle_infoportion")
end
</syntaxhighlight>
| При взятии указанного предмета, один раз будет вызвана указанная функция.

<code>item_section_name</code> — имя секции предмета. 
<code>no_cycle_infoportion</code> — инфопорция, которая необходима для устранения зацикленности вызова скрипта.
<code>script_name</code> — имя скрипта. 
<code>funct_name</code> — имя функции в скрипте.
|}

[[Категория:Игровые архивы]][[Категория:Скрипты]]