CRI ADX  Last Updated: 2024-07-17 10:48 p
从 Cue创建信息CSV 创建Cue

“从Cue创建信息CSV创建Cue”是从简单的CSV创建Cue的功能。
加载包含Cue创建信息的 CSV 并创建Cue。

从 CSV 创建的优点

创建大量具有相同参数和结构但使用不同材质播放的Cue表时
您可以像模板一样使用 CSV。
材料替换是通过将 CSV 导入 Excel 或文本编辑器并替换来完成的。

作为Cue源的 CSV 数据可以在CRI Atom Craft外部创建。
这使得分工更加容易。
请对CRI Atom Craft上的Cue进行最后的微调。

操作流程

  1. 启动CRI Atom Craft
  2. 打开项目
  3. 注册素材(例如,将包含波形的文件夹拖放到素材根目录下)
  4. 准备要加载的Cue表
  5. 打开Cue创建信息 CSV
    右键单击Cue表,然后选择“从Cue创建信息 CSV 创建Cue”菜单。
    (此 CSV 文件中指定的材料必须在 (3.) 的时间提前准备好。)
  6. Cue已被添加

通过拖放打开Cue创建信息CSV

  • 创建并阅读Cue表
    当您将“Cue创建 CSV 格式”的 CSV 文件拖放到工作单元树的Cue表文件夹中时,将使用 CSV 文件名创建Cue表。

输入输出

  • 输入:文本文件(扩展 CSV 格式)
  • 输出:Cue

文本格式

基本

基本指定方法如下。

输入 csv

0,gun1.wav,枪声
1,bomb1.wav,爆炸

结果

Cue ID Cue名
0 gun1
1 bomb1


请按照“Cue ID、材质名称、文本”的顺序指定项目。 每行可以创建一个Cue。

“文本”部分是可选的。该文本可在下面描述的扩展中找到。

在一个Cue中指定多个波形

如果连续指定相同的CueID,它们将合并为一个Cue。在这种情况下,Cue名称将是第一个。

输入 csv

0,footstep1.wav
0,footstep2.wav
0,footstep3.wav

结果

Cue ID Cue名
0 footstep1

关于Cue名称

Cue名称是指定的材质名称,不带扩展名(包括句点)。

关于 CSV 分隔符

在Cue创建信息 CSV 中,逗号和制表符被视为分隔符。 另一方面,请注意空格被视为普通字符。

评论说明

以“//”开头的行被识别为注释。
与多人共享 CSV 时,您可以为其他成员撰写评论。
注释行通常被忽略。

// 这一行是注释。下面的三个被创建为相同的Cue“footstep1”。
#CopyTextTo CueComment
0,footstep1.wav,脚步声1
0,footstep2.wav,脚步声2
0,footstep3.wav,脚步声3
1,cancel.wav,系统取消声音
2,ok.wav,系统判定声音

结果

CueID Cue名 评论
0 footstep1 脚步声3
1 cancel 系统取消声音
2 ok 系统确认音

关于文字

以“::”开头的行被识别为扩展命令。
扩展命令允许您将文本写入指定项目(Cue注释或用户数据)。
如果Cue名称相同,则会被后面指定的队列名称覆盖。

扩展命令 动作
#CopyTextTo CueComment 写入文本以Cue评论
#CopyTextTo UserData 将文本写入用户数据

如果文本为空,则不会执行任何处理。
但是,如果指定“UseBlank”,则可以将空字符写入Cue注释和用户数据。

扩展命令 动作
#CopyTextTo CueComment UseBlank 写入文本以Cue评论。如果文本为空,则写入一个空白字符
#CopyTextTo UserData UseBlank 将文本写入用户数据。如果文本为空,则写入一个空白字符

样本

#MaterialPath voice/
//===================================================
// CSV格式测试
//===================================================
#CopyTextTo CueComment
1, TEST_01_A.wav,这个会被覆盖
1, TEST_01_B.wav,作为Cue注释
#CopyTextTo UserData
2, TEST_02_C.wav,作为用户数据1
3, TEST_03_D.wav,作为用户数据2
4, sin.wav,这是正弦波形
#CopyTextTo CueComment UseBlank
5, TEST_05_E.wav,用空格覆盖
5, TEST_05_E.wav,

结果

CueID Cue名称 评论 用户数据
1 TEST_01_A 作为Cue评论
2 TEST_02_C 作为用户数据 1
3 TEST_03_D 作为用户数据 2
4 sin     这是正弦波形
5 TEST_05_E

添加时参考初始值

请参阅“工具设置”中的“初始值设置”。

扩展命令

CSV 中以“::”开头的行被识别为扩展命令。扩展命令包括文本处理,包括:

项目 内容 描述
#CopyTextTo CueComment 将 CSV 文本项复制到Cue注释字段。 这也是未指定扩展命令时的默认行为。
#CopyTextTo CueComment UseBlank 如果 CSV 文本字段为空,则将空白文本复制到Cue注释字段。 当有多个轨道时,可以用空白覆盖。
#CopyTextTo UserData 将 CSV 文本字段复制到Cue的用户数据字段。
#CopyTextTo UserData UseBlank 将 CSV 文本字段复制到Cue的用户数据字段。 当有多个曲目时,可以用空白覆盖。
#MaterialPath 指定材质的路径。 示例:#MaterialPath system/

| 项目 | 内容 | 如何指定列 | | — | — | — | — | | #GenerateCueNameBy MaterialName | 使用不带扩展名的材质名称作为Cue名称生成Cue。
这也是未指定扩展命令时的默认行为。 | 将列指定为“CueID、材质名称、文本”。
示例:0,gun1.wav,gunshot
Cue名称将为“gun1”。 | | #GenerateCueNameBy CueID | 使用“Cued(d 是CueID 号)”作为Cue名称生成Cue。 | 将列指定为“CueID、材质名称、文本”。
示例:0,gun1.wav,gunshot
Cue名称将为“Cue0”。 | | #GenerateCueNameBy CueName | 生成具有指定Cue名称的Cue。 | 将列指定为“Cue名称、材质名称、文本”。
示例:gun,gun1.wav,gunshot
Cue名称将为“gun”。 |

项目 内容
#SeqType 将序列类型设置为指定的类型。有关详细信息,请参阅下面的“关于::SeqType”部分。

列格式详细信息

CSV 各列的详细信息如下。

项目 描述 详细信息
Cue名称 Cue名称 如果指定了 CueName 的扩展命令,则此处指定的字符串将用作Cue名称。
如果多个列具有相同的名称,它们将被分组到同一个Cue中。
CueID CueID(数字) 代表Cue的数字 ID。如果指定了指定 CueID 的扩展命令,则此处指定的值将用作Cue名称。
如果多个列的编号相同,它们将被分到同一个Cue中。
材质名称 材质名称(路径名称) 从材质根搜索所有路径名称并使用找到的第一个。
文本 任何文本 通过指定扩展命令,可以将其视为Cue注释或用户数据。

#GenerateCueNameBy CueName 示例

Cue名称是根据第一个元素的字符串生成的。

输入 CSV

#GenerateCueNameBy CueName
#CopyTextTo CueComment
footsteps,footstep1.wav,脚步声1
footsteps,footstep2.wav,脚步声2
footsteps,footstep3.wav,脚步声3
cancel,cancel.wav,系统取消声音
ok,ok.wav,系统判定声音

结果

CueID Cue名称 评论
0 footsteps 脚步声3
1 cancel 系统取消声音
2 ok 系统确认音

CueID 是自动分配的。

#GenerateCueNameBy CueID 示例

将生成Cue名称,例如 Cue0。
将此用于仅按CueID 调用的项目。

输入 CSV

#GenerateCueNameBy CueID
0,gun1.wav
1,game.wav

结果

Cue ID Cue名称
0 Cue0
1 Cue1

#MaterialPath 示例

通过在素材参考路径前面添加字符串进行搜索。
如果未指定,所有搜索都将从材质根开始执行。

//素材文件夹路径 从system下搜索
#MaterialPath system/
0,ok.wav
1,cancel.wav
//素材文件夹路径 从weapon下搜索
#MaterialPath weapon/
1,gun1.wav
//素材文件夹路径 从bgm下搜索
#MaterialPath bgm/
2,title.wav
3,game.wav
4,gameover.wav

#关于 SeqType

您可以通过指定扩展命令“::SeqType”来指定序列类型。

项目 内容 描述
#SeqType Cue序列类型 和弦(如果未指定)。
#SeqType Polyphonic 和弦 序列类型变为复调。
#SeqType Sequential 顺序 序列类型变为连续的。
#SeqType Shuffle 随机播放 序列类型将被打乱。
#SeqType Random 随机 序列类型将是随机的。没有重量设置。
#SeqType RandomNoRepeat 随机不重复 序列类型将是随机的,不重复。
#SeqType Switch 开关 序列类型为开关。
#SeqType ComboSequential 组合顺序 序列类型变为组合序列。

输入 CSV

#GenerateCueNameBy CueName
#CopyTextTo CueComment
#SeqType RandomNoRepeat
footsteps,footstep1.wav,脚步声1
footsteps,footstep2.wav,脚步声2
footsteps,footstep3.wav,脚步声3
#SeqType Polyphonic
cancel,cancel.wav,系统取消音
ok,ok.wav,系统判定声音

结果

CueID Cue名称 评论
0 footsteps 脚步声3
1 cancel 系统取消声音
2 ok 系统确认音

footsteps的Cue是使用序列类型随机、不重复创建的。

错误处理和日志输出

如果在“根据Cue创建信息 CSV 创建Cue”过程中发生错误,错误详细信息将输出到日志视图。
如果输出错误,请更正 CSV 并重新导入,或者更正创建的Cue表以解决问题。
(如果不解决该问题,ACB构建过程中将再次出现错误,并且您将无法输出ACB数据。)
另外,如果在读取的CSV中指定相同的CueID来执行合并处理,则合并处理已被应用的事实将被输出到日志。
如果您得到意外结果,请检查您的日志和 CSV 并进行更正。

读取结果 错误原因
未生成Cue表 通过拖放添加时,与 csv 名称同名的Cue表已存在
Cue表中的Cue名称重复 CSV 中存在具有相同Cue名称(不同CueID)的元素
合并源中已存在相同的Cue名称
Cue表中的CueID 重复 CSV 中存在具有相同CueID 的元素
合并源中已存在相同的CueID
没有引用该材料 指定路径不存在材料