fromJSON

功能

fromJSON 方法用于从 JSON 格式的数据中加载行为数据，以便构建 SteeeringBehavior 对象。

语法

SteeringBehavior.fromJSON(jsonData);

参数

• jsonData: 包含 SteeringBehavior 数据的 JSON 格式的字符串或对象。

用法

创建 SteeringBehavior 实例并通过 fromJSON 方法加载数据：

// 定义 SteeringBehavior 数据
const jsonData = `
    {
        "type": "seek",
        "target": {"x": 10, "y": 20},
        "force": 0.5
    }
`;

// 通过 fromJSON 加载数据
const behavior = SteeringBehavior.fromJSON(jsonData);

数据格式

JSON 数据应该包括以下属性：

• type（字符串）：必需，指定驾驶行为的类型，例如："seek", "flee", "arrive", "wander","followPath", "obstacleAvoidance", "hide", "evade", "pursuit" 或 "separation"。
• target（对象）：根据类型的不同，可能是一个 vector2 实例，一个 path 实例，一个障碍物列表，隐藏对象等。如果是 vector2 实例，则应包括以下属性：
  • x（数字）：指定目标在 x 轴上的位置。
  • y（数字）：指定目标在 y 轴上的位置。
• force（数字）：可选，指定应用于行为的力大小。如果未提供，则默认值为 1。

以下是一些数据示例：

• 追逐行为：

{
    "type": "pursuit",
    "target": {"x": 10, "y": 20},
    "force": 0.5
}

• 躲避障碍行为：

{
    "type": "obstacleAvoidance",
    "targets": []
}

• 掩藏行为：

{
    "type": "hide",
    "targets": [],
    "obstacles": [],
    "force": 2
}

返回值

返回一个 SteeeringBehavior 实例，该实例是通过加载 JSON 数据构建的。如果 JSON 数据无效，则方法将抛出异常。

异常

如果 jsonData 参数是无效的 JSON 字符串，则方法将抛出 SyntaxError 异常。如果 JSON 数据不包含必需的属性，则方法将抛出 TypeError 异常。

示例

以下示例演示了如何从 JSON 字符串中加载行为数据：

// 定义 SteeringBehavior 数据
const jsonData = `
    {
        "type": "seek",
        "target": {"x": 10, "y": 20},
        "force": 0.5
    }
`;

// 通过 fromJSON 加载数据
const behavior = SteeringBehavior.fromJSON(jsonData);