Пользовательские дополнения

На главную

common.EnablePersonalEvent( sysEventName, object )

Включает обработку персонального события для конкретной пары (событие : объект). Применимо только к некоторым специальным событиям:

• EVENT_HEALING_RECEIVED

• EVENT_UNIT_MANA_CHANGED

• EVENT_UNIT_MANA_PERCENTAGE_CHANGED

• EVENT_UNIT_DAMAGE_RECEIVED

• EVENT_DEVICE_DAMAGE_RECEIVED

• EVENT_OBJECT_BUFFS_CHANGED

• EVENT_OBJECT_BUFF_ADDED

• EVENT_OBJECT_BUFF_REMOVED

• EVENT_OBJECT_BUFF_CHANGED

• EVENT_OBJECT_HEALTH_CHANGED

Данные события формируются клиентом только для тех объектов, для которых хотя-бы один аддон включил персональное событие на конкретную пару (событие : объект)

ВНИМАНИЕ! Ручное управление персональными событиями может привести к неожиданным эффектам. Допускается только в хорошо протестированном коде в целях оптимизации для случаев с высокой степенью покрытия события фильтрами. Например если аддон отслеживает бафы на всех объектах вокруг, то можно зарегистрировать EVENT_OBJECT_BUFF_ADDED без фильтров, через данную функцию добавить все соответствующие объекты и иметь единую точку входа.

ВНИМАНИЕ! Таблица персональных событий является глобальной (общей для всего интерфейса) и при регистрации события из списка выше без фильтров оно может приходить для объектов которые данный аддон не активировал (но активировал кто-то другой).

ВНИМАНИЕ! На один аддон для одной пары (событие : объект) счетчик персональных событий должен находиться в диапазоне 0-5, глобально 0-250.

Для данной функции есть обратный метод common.DisablePersonalEvent().

-- библиотека:
common

-- объявление:
function EnablePersonalEvent( sysEventName, object )

-- параметры:
sysEventName: string - название события
object: ObjectId (int) - идентификатор объекта для которого включается персональное событие

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

-- примеры:
common.EnablePersonalEvent( "EVENT_OBJECT_BUFF_ADDED", avatar.GetId() ) -- Включить отправку EVENT_OBJECT_BUFF_ADDED для аватара

Search: "CategoryLuaApi" "CategoryCommon"

На главную