Потоко-безопасные API

Threads

Threads are used to balance processing power across CPUs and cores. Godot supports multithreading, but not in the whole engine.

Below is a list of ways multithreading can be used in different areas of Godot.

Global scope

Глобальные синглтоны полностью потоко-безопасны. Доступ к серверам из потоков поддерживается (для VisualServer и Physics серверов, убедитесь что потоковые операции включены в настройках проекта!).

Это делает их отличными для кода который создаёт многие тысячи экземпляров в серверах и контролирует их из потоков. Конечно, это требует немного больше кода, так как они используются напрямую, а не через дерево сцены.

Дерево сцены

Взаимодействие с активным деревом сцены НЕ потоко-безопасно. Убедитесь что используете мьютексы когда посылаете данные между потоками. Если вы хотите вызывать функции из потока, можно использовать функцию call_deferred:

# Unsafe:
node.add_child(child_node)
# Safe:
node.call_deferred("add_child", child_node)

Хотя, создание чанков сцены (нодов в древе) вне активного древа нормально. Таким образом, части сцены могут быть собраны или инстанцированы из потока, а затем добавлены в главный поток:

var enemy_scene = load("res://enemy_scene.scn").instance()
var enemy = enemy_scene.instance()
enemy.add_child(weapon) # Set a weapon.
world.call_deferred("add_child", enemy)

Still, this is only really useful if you have one thread loading data. Attempting to load or create scene chunks from multiple threads may work, but you risk resources (which are only loaded once in Godot) tweaked by the multiple threads, resulting in unexpected behaviors or crashes.

Only use more than one thread to generate scene data if you really know what you are doing and you are sure that a single resource is not being used or set in multiple ones. Otherwise, you are safer just using the servers API (which is fully thread-safe) directly and not touching scene or resources.

GDScript массивы, словари

В GDScript, чтение или запись элементов из многих потоков нормально, но любая операция изменяющая размер контейнера (изменение размера, добавление или удаление элементов) требует закрытие через мьютекс.

Ресурсы

Изменение уникального ресурса через много-поточность не поддерживается, но загрузка их из потоков или выделение ссылки отлично поддерживается. Сцены, текстуры, сетки, итд. Они могут быть загружены или настроены через потоки, а затем добавлены в активную сцену на главном потоке.