[PythonAPI] Методы вызова функций (Callbacks)

[MedvedevTD]

 

PythonAPI - Callbacks

Методы "callbacks" предназначены для многократного вызова функций.

 

Доступные методы: 

callbacks

• callbacks.perTick(func)
• callbacks.callback(dt, func, *args, **kw)
• callbacks.cancel(handle) 

---

callbacks.perTick(func)

Данная функция вызывает пользовательскую функцию, переданную в качестве параметра каждый тик игры (несколько раз в секунду!)*.

Входной параметр: пользовательская функция "func", которая будет вызываться этим методом каждый тик игры.

Возвращаемое значение: handle - уникальный идентификатор метода, используемый для остановки вызова функции по тику.

 

 

*Предупреждение!!!

Т.к. данный метод вызывает функцию несколько раз в секунду, то это может приводить к снижению производительности клиента игры. Будьте внимательны при использовании данного метода.

 

---

callbacks.callback(delaytime, func, *args, **kwargs)

Данная функция так же принимает в качестве параметра пользовательскую функцию "func", которая будет вызываться каждый раз (повторно, снова и снова) с установленной задержкой (интервалом в секундах).

Входные параметры:

• delaytime - задержка в секундах, через которое вызовется функция func
• func - функция, которая вызовется
• *args - позиционные аргументы, которые передадутся в функцию func
• **kwargs - именованные аргументы, которые передадутся в функцию func

Возвращаемое значение: handle - уникальный идентификатор, используемый для остановки вызова функции по тику.

 

 

---

callbacks.cancel(handle)

Данная функция завершает работу метода, ранее вызывавшего функцию каждый тик или с установленным интервалом.

Входной аргумент - уникальный идентификатор метода handle, возвращаемый функциями perTick и callback.