Naninovel

中文

English
日本語

中文

English
日本語

外貌

配音 ​

要将语音片段暴露给引擎，请将其存储在 Resources/Naninovel/Voice 文件夹下（可以在音频配置下的 Loader 折叠项中更改）。如果您愿意，还可以使用子文件夹组织它们；在这种情况下，在脚本中引用它们时请使用正斜杠（/）。例如，存储为 Resources/Naninovel/Voice/Intro/Day/25.wav 的语音音频剪辑可以在脚本中引用为 Intro/Day/25。

也可以使用寻址资产系统手动暴露资源；有关更多信息，请参阅指南。

您可以使用任何Unity支持 ↗的音频格式作为语音剪辑。

语音播放行为可以使用 Naninovel -> Configuration -> Audio 上下文菜单进行配置；有关可用选项，请参阅配置指南。

在脚本中使用 @voice 命令后跟剪辑名称（路径）来播放语音，例如：

nani
@voice Hello

— 将播放存储在 Resources/Naninovel/Voice/Hello.wav 的语音剪辑资产。

注意

@voice 命令旨在偶尔在特定时刻播放语音剪辑，不适合实现完整的配音；有关如何在大多数文本行都有关联语音剪辑的项目中处理配音的更多信息，请参阅下面的“自动配音”部分。一些内置功能（例如，回想中的语音重播、配音文档等）仅适用于自动配音工作流程。

自动配音 ​

在全配音游戏中，为每个配音行指定 @voice 命令可能会变得繁琐。自动配音功能允许自动播放与配音文本行的唯一标识符关联的语音剪辑。要启用自动配音，请在音频配置菜单中启用 Enable Auto Voicing 开关。

语音音频剪辑与配音文本行之间的关联可以通过配音映射实用程序执行，也可以通过使用 Unity 的寻址资产系统为音频剪辑资产分配地址（或以其他方式将资产暴露给另一个资源提供者）来执行。

启用自动配音后，音频配置菜单中将出现“Open Voice Map Utility”按钮；您也可以通过 Naninovel -> Tools -> Voice Map 编辑器菜单访问该实用程序。

cover

首先，选择要为其映射语音剪辑的脚本文件。如果所选脚本包含任何打印命令（或通用文本行），它们将与音频剪辑字段成对列出。将语音剪辑拖放（或选择）到字段中以将其与文本关联。也可以自动映射剪辑；为此，将剪辑资产命名为匹配配音行文本的开头，并将剪辑（或包含它们的文件夹）拖到配音映射实用程序中。

WARNING

通过配音映射窗口分配剪辑时，请确保存储语音剪辑在任何“Resources”文件夹之外，以防止冲突。

要为非源语言环境关联语音剪辑，请使用 Localization Document 字段选择脚本本地化文档。选取有效文档后，分配的语音剪辑将自动加上存储文档的语言环境前缀，并在选择相应的语音语言时使用。

如果同一作者有相同的文本消息（在同一脚本中），这两条消息将关联到同一个语音剪辑。如果不需要这样，请向其中一条消息添加唯一的文本标识符，例如：

nani
Hello.
Hello.|#uniqueid|

TIP

使用编辑器菜单下的 Naninovel/Tools/Text Identifer 让 Naninovel 自动为所有可本地化的脚本文本（包括配音行）生成唯一 ID。这样您就不必手动为重复行分配 ID，并且编辑已映射的行也不会破坏关联。有关更多信息，请参阅文本标识。

要在不使用配音映射实用程序的情况下关联剪辑，请使用以脚本路径和语音加载器前缀（默认为 Voice）为前缀的文本 ID 作为资源名称，将资产暴露给资源提供者。要查找特定配音行的脚本路径和文本 ID，请使用配音文档。例如，要关联通过寻址资源提供者暴露的 Script01 路径脚本内的 2670eb4 文本 ID 的配音行，请使用以下地址：Naninovel/Voice/Script01/2670eb4。

要在游戏运行时查找与当前打印文本关联的自动配音 ID，请使用调试窗口：

auto voicingcover

要显示该窗口，请确保在引擎配置中打开了 Enable Development Console，然后在播放模式下按 ~ 键，输入 debug 并按 Enter。

示例

在自动配音示例中查找有关为多个语言环境设置自动配音的示例。

作者音量 ​

使用自动配音时，您可能希望让玩家控制特定角色或更准确地说是打印文本消息的作者的语音音量。例如，玩家可能决定静音主角的声音或使特定角色的声音更小。

要设置每个作者的语音控制，请创建自定义设置 UI，添加一个新的滑块（您可以复制预制件中已存在的“VoiceVolumeSlider”）并在 Author ID 字段中指定作者（角色）ID。

cover

添加的滑块现在将控制指定角色的语音音量。当作者 ID 字段未分配任何内容时，滑块将控制音频混音器的语音组的音量，从而影响所有语音。

语音语言 ​

当为不同的本地化添加配音时，可以允许玩家独立于主要本地化选择语音语言（例如，玩带有英文文本和 UI 但带有日文配音的游戏）。

要将语音语言下拉菜单添加到游戏设置，请在音频配置菜单中分配 Voice Locales 属性。添加您拥有相应语音资源的语言环境标记。例如，下面的示例将允许玩家在英语和日语语音之间进行选择：

cover

分配属性后，“Voice language”下拉菜单将出现在游戏设置菜单中：

cover

有关如何本地化游戏资源的更多信息，请参阅本地化指南。

配音文档 ​

配音文档旨在供录音工程师和演员在制作配音音频时使用。

使用通过 Naninovel -> Tools -> Voiceover Documents 访问的配音文档生成器实用程序来生成文档，其中包含来自 @print 命令和通用文本行的打印文本。每个打印文本消息都将与自动配音 ID 关联。

cover

Locale 属性允许选择要为其生成文档的特定语言环境（项目中应存在所选语言环境的本地化场景脚本）。

Format 属性控制要生成的配音文档的文件类型和格式：

  • Plaintext — 没有任何格式的纯文本文件。
  • Markdown — Markdown ↗ 文件，具有额外的格式以提高可读性。
  • CSV — 逗号分隔值 ↗文件，用于与表格处理程序（如 Google Sheets 或 Microsoft Excel）一起使用。

下面是以 Markdown 格式生成的配音文档示例。

cover

自定义生成器 ​

如果您希望以特殊方式格式化和/或序列化文档，可以注入自定义配音文档生成器。

要添加自定义生成器，请创建一个具有无参数构造函数并实现 IVoiceoverDocumentGenerator 接口的新 C# 类。该实用程序将自动选取此类并使用它代替内置生成器。

GenerateVoiceoverDocument 方法将由实用程序为所选语言环境的项目中找到的每个脚本调用。list 参数是脚本中包含的命令列表。locale 表示实用程序中选择的语言环境（语言）。outDir 是实用程序中选择的输出路径。

下面是一个自定义配音生成器的示例，它为脚本中找到的每个打印文本命令附加一个带有脚本路径和语言环境的标题，后跟 auto-voice id > author > text 行。

csharp
public class VoiceoverGenerator : IVoiceoverDocumentGenerator
{
    public void GenerateVoiceoverDocument (ScriptPlaylist list, string locale, string outDir)
    {
        var builder = new StringBuilder();
        builder.AppendLine($"Voiceover for '{list.ScriptPath}' ({locale} locale)");
        foreach (var cmd in list.OfType<PrintText>())
        {
            var voiceId = AutoVoiceResolver.Resolve(cmd.Text);
            builder.AppendLine($"{voiceId} > {cmd.AuthorId} > {cmd.Text}");
        }
        File.WriteAllText($"{outDir}/{list.ScriptPath}.txt", builder.ToString());
    }
}