剧本

剧本是在 DataMesh Studio 中编辑完成的工程文件，类似于 PPT 演示文稿。它可以包含多个场景，每个场景可以包含多个模型、图片等附件资源，以及字幕、组件等工具资源。在剧本中可以设置场景之间的跳转关系，实现交互式场景切换。剧本的格式为 .dirpkg，可以在 DataMesh Studio 中进行新建、编辑、保存、导入和导出。剧本的管理可在 DataMesh FactVerse 平台中的数字资产模块中进行。

新建剧本

您可以在主页中点击【新建】按钮。系统将会打开剧本编辑界面并创建一个全新的剧本。新建的剧本默认包含一个光源和一个摄影机角色。

如果您已经在编辑界面中进行剧本编辑，也可以通过点击文件菜单，选择新建剧本来创建一个新的剧本。注意：在这种情况下，您将被提示保存当前正在编辑的剧本。

打开云端剧本

您可以使用以下步骤打开云端剧本：

1. 在主页中，点击【打开】按钮。

2. 在打开剧本窗口中，选择一个云端已有的剧本并点击【打开】。

如果您正在编辑界面中编辑剧本，也可以通过点击文件菜单，选择打开来打开云端的剧本。注意：在这种情况下，您将被提示保存当前正在编辑的剧本。

保存剧本

您可以通过以下步骤将剧本同步至 DataMesh FactVerse 平台：

1. 在 DataMesh Studio 的剧本编辑界面中，点击工具栏中的保存按钮 ，或者点击文件菜单并选择保存选项。

2. 如果这是第一次保存剧本，请在弹出的窗口中填写剧本名称，选择存储路径，并点击【确认】按钮即可完成保存。

导入本地剧本

要导入本地剧本，请按照以下步骤进行操作：

1. 在 DataMesh Studio 的主页界面中，点击【导入】按钮。这将打开一个本地资源窗口。

2. 在本地资源窗口中，选择要导入的剧本文件并点击【打开(O)】按钮。

3. 在打开的窗口中，选择存放剧本资源（模型文件、图片、音频等资源）的路径，剧本资源会按照原剧本目录结构存放在FactVerse 资源库中。

4. 点击【确认】完成剧本内资源的导入。

5. DataMesh Studio 的编辑界面中，将自动加载并打开剧本，您可以浏览、编辑和保存这个剧本。

导出剧本

要导出剧本，可以在编辑界面中，通过点击文件菜单并选择导出，即可打开导出剧本窗口。在导出窗口中，可以选择导出的资源项是否包含加速附件。

• • 导出内容：导出 .dirpkg 格式的剧本索引文件和剧本中使用的资源文件。此选项导出的文件较小，但导入时需要重新进行资源加速处理。
  • 加速附件：导出剧本包含的加速附件。导入后可直接使用已加速的资源，但上传时间会比默认导出选项更长。

播放（预览）剧本

DataMesh Studio 支持三种播放方式：

• • 从头播放：在编辑界面中，可以通过以下方式播放一个完整的剧本：
    • • 点击播放菜单并选择从头播放；
      • 点击缩略图区第一场景为当前页，然后点击工具栏的播放按钮 。
  • 从当前场景播放：在编辑界面中，可以通过以下方式播放从当前页开始的全部场景：
    • • 选中缩略图区某个场景，然后点击工具栏的播放按钮；
      • 点击播放菜单并选择从当前场景播放。
  • 播放当前场景：在编辑界面中，选中缩略图区某个场景，点击播放菜单并选择播放当前场景，可仅播放当前选中的场景。

在播放时，显示界面为全屏状态。按下键盘上的【Esc】或点击 DataMesh Studio 右上角的关闭按钮，即可退出播放。

修改剧本渲染环境

剧本的渲染环境是指在虚拟场景中为剧本设置的环境背景和光照效果，用于模拟光线在场景中的传播、反射和折射现象。它可以影响物体的外观、光照和阴影效果，增强场景的真实感和逼真度。

在 DataMesh Studio 中，您可以选择系统提供的内置的渲染环境或者自定义制作场景的渲染环境，使虚拟场景更加逼真和具有沉浸感。

要修改剧本的渲染环境，您可以按照以下步骤进行操作：

1. 点击剧本菜单，在下拉菜单中选择更改渲染环境。这将打开更改渲染环境窗口。

2. 在更改渲染环境窗口中，您可以选择系统内置的渲染环境，当选择无时，则剧本没有特定的环境反射效果。

您也可以通过自定义剧本渲染环境，选择不同的天空盒图像，创建适合剧本的环境背景和天空效果，以适应不同场景需求和创作目的。

自定义渲染环境的步骤如下：

1. 准备六张天空盒图片：这些图片应该分别对应于天空盒的前、后、左、右、上和下方向。图片应该是 PNG 格式的，并且遵循英文命名规范（Front、Back、Left、Right、Top、Bottom）。

2. 将这些图片压缩成一个 zip 文件，并将其后缀名改为 .dmcm。

3. 在 DataMesh FactVerse 平台上将这个 .dmcm 文件上传到资源库中。

4. 在 DataMesh Studio 中，点击剧本菜单，在下拉菜单中选择更改渲染环境，打开更改渲染环境窗口。

5. 在更改渲染环境窗口中，选择自定义标签，点击选择渲染环境。

6. 在选择渲染环境的窗口中，找到已上传的 .dmcm 文件。

7. 选择文件后，点击【确认】按钮完成自定义剧本渲染环境。

管理剧本结构

在 DataMesh Studio 中，场景目录和场景缩略图可以用于展示和管理当前剧本的结构和章节目录。

通过点击场景中的场景目录图标 ，您可以快速浏览整个剧本，了解剧情结构和章节内容，以及快速导航到所需的章节和场景。

以下是管理剧本结构的基本操作：

• • 创建章节：场景目录中的每个章节都代表一个独立的场景或情节。在 DataMesh Studio中，您可以在场景的缩略图上点击右键，选择创建章节，打开创建章节窗口，填写章节名称后即可在该场景前添加一个新章节。

如果在创建章节窗口中取消继承前场景内容选项，则可以创建一个空白场景，以便您在其中添加新的元素和内容。这使得剧本的结构更加灵活。

• • 删除章节：在缩略图区右键点击某个章节名称，选择删除章节来删除该章节。
  • 编辑（重命名）章节：在缩略图区右键点击某个章节名称，选择编辑章节对该章节进行重命名。

制作多语言剧本

DataMesh Studio 支持用户为剧本添加多语言文本内容，从而创建多语言剧本。在 DataMesh One 中播放剧本时，剧本中的文本内容将根据播放端的界面语言进行呈现。多语言文本功能支持以下语言：简体中文、英语、繁体中文和日语。

多语言剧本标题

您可以通过以下步骤为剧本标题添加多语言文本内容：

1. 点击【剧本】菜单，选择修改剧本标题。

2. 在剧本标题编辑框中，填写剧本标题。

3. 点击剧本标题编辑框中的多语言图标 ，打开文本多语言窗口。

文本多语言窗口右上角的语言列表中为源文本的语言，您可以通过此语言列表切换源文本语言。

4. 填写剧本标题的源文本和多语言文本内容。

a) 具有 FactVerse AI 权限的用户可以使用 AI 转译功能将剧本标题分别转译成四种语言的内容，或者使用一键转译功能一键式快速转译四种语言的文本内容。

注意：

• • 使用 AI 转译功能，每种语言的每次转译都会消耗一定数量的令牌。消耗的令牌数量根据内容长度计算。
  • 使用一键转译功能，只对非源文本语言消耗令牌。消耗的令牌数量根据内容长度计算。与源文本语言相同的文本框直接显示源文本内容，因此不消耗令牌。

b) 不具有 FactVerse AI 权限的用户需要手工填写文本内容。

5. 点击【确认】保存剧本标题的多语言文本内容。

注意：在播放端中播放剧本时，将显示与播放端界面语言一致的剧本标题内容。当某种语言的内容为空时，在播放时则该内容不显示。

多语言场景名称

为场景添加多语言名称，请按照以下步骤操作：

1. 未选中任何角色情况下，从场景缩略图区选择要编辑的场景。

2. 在属性面板中，点击场景名旁的编辑图标 。

3. 点击场景名称编辑框中的多语言图标 ，打开文本多语言窗口。

4. 在文本多语言窗口中，填写场景名称的源文本和多语言文本内容。

5. 点击【确认】保存场景名称的多语言文本内容。

其他多语言文本内容

除了剧本标题和场景名称外，用户还可以为以下部分添加多语言文本内容：

• • 章节名：在创建章节或编辑章节窗口中，点击多语言图标 ，打开文本多语言窗口，为章节名添加多语言文本。

• • 文本框内容：点击文本框文本内容编辑框右上角的更多图标 ⋅⋅⋅，点选文本多语言选项，打开文本多语言窗口，为文本框内容添加多语言文本。

• • 标签文本：点击标签文本内容编辑框右上角的更多图标 ⋅⋅⋅，点选文本多语言选项，打开文本多语言窗口，为标签文本内容添加多语言文本。

• • 按钮文本：点击按钮文本内容编辑框右上角的更多图标 ⋅⋅⋅，点选文本多语言选项，打开文本多语言窗口，为按钮文本内容添加多语言文本。

剧本定位

通常情况下，剧本定位时默认使用剧本第一页的模型。此外，DataMesh Studio 还为剧本提供了两种定位方式：参考模型定位和二维码定位。

参考模型定位

参考模型定位是指使用一个或多个参考模型来辅助剧本编辑和空间定位。

使用参考模型定位的具体步骤如下：

1. 1. 点击菜单栏的剧本菜单，在下拉菜单中选择修改剧本定位，进入定位模式。

1. 2. 将资源库里的模型拖拽至场景区，作为编辑剧本的参考背景。

1. 3. 点击【退出】按钮退出定位模式，根据参考模型辅助定位剧本中其他模型的位置。

1. 4. 使用 DataMesh One 播放时，轮盘调整模式下进行剧本定位。

注意：在 DataMesh One 中，位置参照需要设置为首帧，以剧本首场景第一帧画面为参照进行定位。

1. 5. 点击 完成定位。

二维码定位

二维码定位是通过扫描或锚定方式，实现虚拟场景与现实空间的精准对齐。以下是如何在 DataMesh Studio 中添加、编辑和删除定位码的操作流程：

管理剧本中的定位码

1. 1. 进入定位模式：点击菜单栏的剧本菜单，在下拉菜单中选择修改剧本定位，进入定位模式。
   2. 添加定位码：新建的剧本中默认包含一个定位码“定位码_1”，当未选中任何角色时，可以通过属性面板中的【添加定位码】按钮来增加定位码。每次点击添加后，系统将在场景中沿 X 轴方向每隔 5 分米（dm）新增一个定位码。

每个剧本中最多可添加 20 个定位码。1-10 号定位码与 DataMesh Studio 5.5 之前版本的定位码通用。

1. 3. 编辑定位码：选中定位码后，属性面板中将显示该定位码的详细信息，包括：
      • 位置：可手动调整定位码的三维空间位置。
      • 旋转（Y 轴）：可修改定位码的 Y 轴旋转角度。
      • 快速方向设置：可通过属性面板快速设置定位码的方向。
   4. 删除定位码：选中定位码后，点击工具栏中的删除按钮 即可删除该定位码。注意：在一个剧本中，至少需要保留一个定位码。
   5. 退出定位模式：点击【退出】按钮退出定位模式。

您可以通过 DataMesh One 扫描添加的定位码，精确对齐虚拟模型与现实空间。也可以使用锚定定位功能进行定位。有关详细操作，请参考《DataMesh One 用户手册》。