Unigine::Syncker::Master方法

在加载了 Syncker之后，此方法集才可用。

下列所描述的方法在 Unigine::Syncker::Master命名空间内得到指定。

int init(string address, int udp_port = Unigine::Syncker::UDP_PORT, int tcp_port = Unigine::Syncker::TCP_PORT)

初始化使用所给广播地址的主应用程序中的Syncker。

参数

• string address - 广播地址。
• int udp_port = Unigine::Syncker::UDP_PORT - UDP 端口。默认为 8890。
• int tcp_port = Unigine::Syncker::TCP_PORT - TCP 端口。默认为 8891。

返回值

如果成功将Syncker初始化则为1，否则为0。

int shutdown()

关闭主应用程序内的Syncker并关闭所有打开的套接口。

返回值

如果成功关闭Syncker则为1否则为0。

int getNumSlaves()

返回连接到主计算机上的从计算机数量。

返回值

从站的数量。

string getSlaveName(int num)

返回所给从计算机的名称。（如果未设置）默认名为未知。

参数

• int num - 从计算机数量。.

返回值

从计算机名。

string getSlaveAddress(int num)

返回所给从计算机的网络地址。

参数

• int num - 从计算机数量。

返回值

从计算机的网络地址。

void syncCAVE(Vec3 head)

同步观察器头部位置。

参数

• Vec3 head - 头部位置。

void syncFrame()

同步帧数据，包括以下内容的同步：

• 游戏激活标记
• 当前 帧数
• 帧像周期 （持续时间）
• 时标
• 当前游戏内的时间
• 用于随机数字生成器的 种子 。

void syncEnd()

通知从属计算机UDP协议上帧的结束。在主端帧同步化的最后需要此函数。

void syncPlayer()

同步相机：

• 相机转换
• 投影矩阵
• 视窗遮罩
• 用于反射的遮罩
• 如果存在地化，运用的后期材质

void syncRender()

同步所有状态及所给材质的参数。

void syncMaterial(Material material)

同步所有状态及所给材质的参数。

参数

• Material material - 材质。

void syncMaterials(Material materials[])

同步所有状态及所给材质的参数。

参数

• Material materials[] - 材质数组。

int createNode(Node node)

同步删除TCP协议上所有从站内所给节点。

参数

• Node node - 将创建的节点。

返回值

如果成功在所有从站上创建节点为1 ，否则则为0 - 不支持节点创建。

void deleteNode(Node node)

同步删除TCP协议上所有从站内所给节点。

参数

• Node node - 将删除的节点。

void syncNode(Node node)

同步UDP协议上所给节点的参数。

参数

• Node node - 节点。

void syncNodes(Node nodes[])

同步UDP协议上所给节点的参数。

参数

• Node nodes[] - 节点数组。

void systemSet(int mask, string name, int value)

对遮罩中定义的从站设置系统脚本变量值。

参数

• int mask - 定义从站的遮罩，应为此从站设置一个变量。要为所有从站设置变量，发送~0。
• string name - 系统脚本内的变量名称。
• int value - 将被设置的值。

void systemGet(int mask, string name, int ret[])

获取遮罩内来自从站的系统脚本变量值。

参数

• int mask - 定义从站的遮罩，应为此从站设置一个变量。要为所有从站设置变量，发送~0。
• string name - 系统脚本内的变量名称。
• int ret[] - 由从站返回的数值数组（按照从站与主站连接的顺序）。

void worldSet(int mask, string name, int value)

为在遮罩中定义的从站设置世界对象脚本变量值。

参数

• int mask - 定义从站的遮罩，应为此从站设置一个变量。要为所有从站设置变量，发送~0。
• string name - 世界对象脚本内变量的名称。
• int value - 将被设置的值。

void worldGet(int mask, string name, int ret[])

获取遮罩内来自从站的世界对象脚本变量值。

参数

• int mask - 定义从站的遮罩，应从此从站获取变量。要为所有从站设置变量，发送~0。
• string name - 世界对象脚本内变量的名称。
• int ret[] - 由从站返回的数值数组（按照从站与主站连接的顺序）。

void editorSet(int mask, string name, int value)

为在遮罩中定义的从站设置编辑器脚本变量值。

参数

• int mask - 定义从站的遮罩，应为此从站设置一个变量。要为所有从站设置变量，发送~0。
• string name - 编辑器脚本内的变量名称。
• int value - 将被设置的值。

void editorGet(int mask, string name, int ret[])

获取遮罩内来自从站的编辑器脚本变量值。

参数

• int mask - 定义从站的遮罩，应为此从站设置一个变量。要为所有从站设置变量，发送~0.
• string name - 编辑器脚本内的变量名称。
• int ret[] - 由从站返回的数值数组（按照从站与主站连接的顺序）。

void systemCall(int mask, string name, int args[])

在遮罩内定义的从站上调用系统脚本函数。

参数

• int mask - 定义从站的遮罩，在此从站上应调用一种方法。要在所有从站上调用方法，发送~0。
• string name - 系统脚本内的方法名。
• int args[] - 将被传输的参数数组（支持最多传输6个参数）。

void systemCall(int mask, string name, int args[], int ret[])

调用系统脚本方法，此方法位于在遮罩定义的从站上并通过TCP协议接收返回值。

参数

• int mask - 定义从站的遮罩，在此从站上应调用一种方法。要在所有从站上调用方法，发送~0.
• string name - 系统脚本内的方法名。
• int args[] - 将被传输的参数数组（支持最多传输6个参数）。
• int ret[] - 由遮罩内定义的从站返回的数值数组（按照从站与主站连接的顺序）。

void systemStream(int mask, string name, Buffer buffer)

调用一种方法，此方法接收一个缓冲并将此缓冲作为遮罩指定从站上的一个参数。缓冲包括从站显示器的状态。

参数

• int mask - 定义从站的遮罩，在此从站上应调用一种方法。要在所有从站上调用方法，发送~0。
• string name - 方法名。
• Buffer buffer - 使用显示器状态进行的缓冲，这些显示器需被传递给此方法。

void worldCall(int mask, string name, int args[])

在遮罩内定义的从站上调用世界脚本方法。

参数

• int mask - 定义从站的遮罩，在此从站上应调用一种方法。要在所有从站上调用方法，发送~0。
• string name - 世界对象脚本内方法的名称。
• int args[] - 将被传输的参数数组（支持最多传输6个参数）。

void worldCall(int mask, string name, int args[], int ret[])

调用世界脚本方法，此方法位于在遮罩定义的从站上并通过TCP协议接收返回值。

参数

• int mask - 定义从站的遮罩，在此从站上应调用一种方法。要在所有从站上调用方法，发送~0。
• string name - 世界对象脚本内方法的名称。
• int args[] - 将被传输的参数数组（支持最多传输6个参数）。
• int ret[] - 由遮罩内定义的从站返回的数值数组（按照从站与主站连接的顺序）。

void editorCall(int mask, string name, int args[])

在遮罩内定义的从站上调用编辑器脚本方法。

参数

• int mask - 定义从站的遮罩，在此从站上应调用一种方法。要在所有从站上调用方法，发送~0。
• string name - 编辑器脚本内的方法名称。
• int args[] - 将被传输的参数数组（支持最多传输6个参数）。

void editorCall(int mask, string name, int args[], int ret[])

在遮罩内定义的从站上调用编辑器脚本方法并通过TCP协议接收一个返回值。

参数

• int mask - 定义从站的遮罩，在此从站上应调用一种方法。要在所有从站上调用方法，发送~0。
• string name - 编辑器脚本内的方法名称。
• int args[] - 将被传输的参数数组（支持最多传输6个参数）。
• int ret[] - 由从站返回的数值数组（按照从站与主站连接的顺序）。