Up to date

This page is up to date for Godot 4.2. If you still find outdated information, please open an issue.

MultiplayerSpawner

继承： Node < Object

自动将可出生节点从授权端复制到其他多人对等体。

描述

可出生的场景可以在编辑器中或通过代码配置（参阅 add_spawnable_scene）。

还支持通过在所有对等体上调用 spawn_function，通过 spawn 自定义节点出生。

在内部，MultiplayerSpawner 使用 MultiplayerAPI.object_configuration_add 来通知出生， 需将出生的节点作为 object，并将其自身作为 configuration 传入；并使用 MultiplayerAPI.object_configuration_remove 以类似的方式通知消失。

属性

Callable	spawn_function
int	spawn_limit	0
NodePath	spawn_path	NodePath("")

方法

void	add_spawnable_scene ( String path )
void	clear_spawnable_scenes ( )
String	get_spawnable_scene ( int index ) const
int	get_spawnable_scene_count ( ) const
Node	spawn ( Variant data=null )

---

信号

despawned ( Node node )

当可生成场景或自定义生成被多人游戏授权端消除时发出。只在傀儡端调用。

---

spawned ( Node node )

当可生成场景或自定义生成被多人游戏授权端生成时发出。只在傀儡端调用。

---

属性说明

Callable spawn_function

• void set_spawn_function ( Callable value )

• Callable get_spawn_function ( )

当每个自定义 spawn 被授权端请求时，在所有对等体上调用的方法。将接收 data 参数，并且应该返回一个不在场景树中的 Node。

注意：返回的节点不应该用 Node.add_child 添加到场景中。这是自动完成的。

---

int spawn_limit = 0

• void set_spawn_limit ( int value )

• int get_spawn_limit ( )

该出生器允许出生的最大节点数。包括可出生场景和自定义出生。

当设置为 0（默认值）时，没有限制。

---

NodePath spawn_path = NodePath("")

• void set_spawn_path ( NodePath value )

• NodePath get_spawn_path ( )

到出生的根的路径。作为直接子节点被添加的可出生场景，会被复制到其他对等体。

---

方法说明

void add_spawnable_scene ( String path )

将场景路径添加到可出生的场景中，使其在添加为 spawn_path 指向的节点的子节点时，自动从多人游戏授权端，复制到其他对等体。

---

void clear_spawnable_scenes ( )

清除所有可生成的场景。不会在远程对等体上消除现有实例。

---

String get_spawnable_scene ( int index ) const

按索引返回可生成场景的路径。

---

int get_spawnable_scene_count ( ) const

返回可生成场景路径的数量。

---

Node spawn ( Variant data=null )

请求进行一次自定义出生，data 将被传递给所有对等体的 spawn_function。返回本地出生的节点实例，该节点实例已经在场景树中，并被添加为 spawn_path 指向的节点的子节点。

注意：可出生的场景是自动出生的。spawn 仅在自定义出生时需要。