角色编辑工具 ​

1. 角色编辑工具简介 ​

1.1 角色编辑工具是什么 ​

角色编辑工具为开发者提供可视化的角色形象编辑能力，通过调整工具中体型、发型、服饰、妆容等选项可以对游戏中的角色形象进行个性化定制。

1.2 角色编辑工具的应用场景 ​

编辑状态下自定义游戏角色形象 ↓

中文示例	英文示例

运行状态下自定义游戏角色形象 ↓（通过 API）

1.3 角色编辑基础规则 ​

1.3.1 角色风格

角色编辑工具目前提供的角色风格主要分为：二次元风格、多边形风格、写实风格和欧美卡通风格。

二次元风格 ↓

男	女

多边形风格 ↓

男	女

写实风格 ↓

男	女

欧美卡通风格 ↓

男	女

1.3.2 编辑项

• 捏人类

  捏人类编辑项，可以通过调整部位缩放、拉伸等参数来改变角色形象。 可以调节的选项有：头部相关和身材相关。

中文示例	英文示例

中文示例	英文示例

• 换装类

  换装类编辑项，可以通过替换资源、调整颜色和花纹等参数来改变角色形象。 可以替换的资源有：化妆相关、发型相关和服饰相关。

中文示例	英文示例

中文示例	英文示例

中文示例	英文示例

2. 角色编辑工具使用指南 ​

2.1 角色编辑工具入口 ​

入口1：编辑 Player 角色形象

点击 Player 对象属性面板中的“编辑玩家形象”。

中文示例	英文示例

入口2：编辑人形对象角色形象

点击人形对象 v2 中的“编辑人形对象”。

中文示例	英文示例

入口3：编辑本地角色形象

双击工程内容中的角色形象数据文件，或点击右键菜单中的编辑选项。

中文示例	英文示例

2.2 角色编辑数据的保存与使用 ​

• 保存

  编辑 PLayer/人形对象/本地角色文件时，显示保存选项，点击保存后将编辑数据更新至 PLayer/人形对象/本地角色文件中。

中文示例	英文示例

• 另存为

  点击另存为，将角色编辑数据整体或组合存储在工程内容的角色分类下。

中文示例	英文示例

中文示例	英文示例

• 角色编辑数据说明

中文示例	英文示例

• 角色编辑数据应用

  • 编辑时应用

    将角色形象数据文件拖入主视口，将数据文件中存储的角色数据应用至角色。

  • 运行时应用

    通过 API 将数据文件中存储的数据应用至角色。

    ts

    //使用工程内容-角色数据文件资源ID改变人形对象对应数据
    Player.localPlayer.character.setDescription(["资源ID"]);
    //将角色形象同步至多端
    Player.localPlayer.character.syncDescription();

    //使用工程内容-角色数据文件资源ID改变人形对象对应数据
    Player.localPlayer.character.setDescription(["资源ID"]);
    //将角色形象同步至多端
    Player.localPlayer.character.syncDescription();

2.3 角色编辑数据的导入与导出 ​

• 导入

  • 点击工程内容-左侧分类正下方资源导入按钮，在资源管理器中选择要导入的角色文件后将数据导入。（可支持批量导入）
  • 支持从外部Window资源管理器中直接拖拽角色资源文件至工程内容面板后进行数据导入。

中文示例	英文示例

• 导出

  在工程内容-角色分类下选中某个角色形象数据文件，点击右键菜单中导出按钮，在资源管理器中选择导出路径后将该数据导出。

中文示例	英文示例