Просмотр исходного текста страницы Callback функции

__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]]
|-
| '''Дополнили'''
| [[Overf1rst]], Graff46, Charsi
|-
| '''Тип статьи'''
| справка
|-
| '''Актуальность'''
| [[S.T.A.L.K.E.R. - Тень Чернобыля|ТЧ]], [[S.T.A.L.K.E.R. - Чистое Небо|ЧН]], [[S.T.A.L.K.E.R. - Зов Припяти|ЗП]]
|}

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

Событие регистрируется в скриптовом классе строчкой, к примеру, следующего вида:
<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><br>'''ЧН/ЗП:''' <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>
| Взятие предмета из объекта с классом S_INVBOX
| '''ТЧ/ЧН/ЗП:''' ''bind_stalker.script''
| <code>actor_binder:take_item_from_box(box, item)</code>
|-
| <code>use_object</code>
| 
1. Съедание инвентарного предмета в инвентаре<br>
2. Использование объекта в игровом мире
| '''ТЧ/ЧН:''' ''ph_gate.script''<br>'''ЧН:''' ''mob_trader.script''<br>'''ЗП:''' ''bind_stalker.script<br>bind_door_labx8.script''
| '''ТЧ/ЧН:''' <code>action_gate:use_callback(obj, who)</code><br>'''ЧН:''' <code>mob_trader:use_callback()</code><br>'''ЗП:''' <code>actor_binder:use_inventory_item(obj)</code><br><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<br>move_mgr.script''
| <code>generic_object_binder:waypoint_callback(obj, action_type, index)</code><br><code>move_mgr:waypoint_callback(obj, action_type, index)</code>
|-
| <code>hit</code>
| Получение урона
| '''ТЧ/ЧН/ЗП:''' ''bind_monster.script''<br>'''ТЧ/ЧН:''' ''ph_gate.script''
| '''ТЧ/ЧН/ЗП:''' <code>generic_object_binder:hit_callback(obj, amount, local_direction, who, bone_index)</code><br>'''ТЧ/ЧН:''' <code>action_gate:hit_callback(obj, amount, local_direction, who, bone_index)</code>
|-
| <code>death</code>
| Смерть
| '''ТЧ/ЧН/ЗП:''' ''bind_monster.script''<br>'''ЧН/ЗП:''' ''bind_crow.script''
| '''ТЧ/ЧН/ЗП:''' <code>generic_object_binder:death_callback(victim, who)</code><br>'''ЧН/ЗП:''' <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<br>bind_red_forest_bridge.script''<br>'''ЗП:''' ''bind_door_labx8''
| '''ЧН:''' <code>agru_door_binder:animation_end_callback(is_end)</code><br><code>bridge_binder:animation_end_callback( is_end )</code><br>'''ЗП:''' <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> — имя секции предмета.<br>
<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> — имя секции предмета.<br>
<code>no_cycle_infoportion</code> — инфопорция, которая необходима для устранения зацикленности вызова скрипта.
<code>script_name</code> — имя скрипта.<br>
<code>funct_name</code> — имя функции в скрипте.
|}

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

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