CRI ADX  Last Updated: 2024-07-17 10:48 p
关于调用CRI Atom Craft终端(命令行)

启动CUI工具,用以下格式输入命令。


[格式] criatomcraft Input_CRI_Atom_Craft_Project_filename Options
[输入] Input_CRI_Atom_Craft_Project_filename : 输入CRI Atom Craft项目文件名
  Options : 命令选项

输入CRI Atom Craft项目文件名

CRI Atom Craft项目文件。
用项目的当前目标和当前语言,构建所有的Cue Sheet。
如果指定的文件路径等含有空格,请用“"”指定。

命令选项

切换各种功能的选项。可以使用以下选项。
如果未在命令行中输入任何内容,则会显示命令的说明。

构建的相关选项

选项 说明
-target 指定目标。未指定时只输出PC。
-ingame 游戏内预览构建时指定。未指定时通常只输出二进制。
-cuesheet 指定Cue Sheet名构建时指定。未指定时输出打开的工作单元的所有Cue Sheet。
-language 指定语言时指定。
未指定时仅用与语言无关的Cue Sheet(素材中没有多语言及未指定音轨语言)构建。
-clean 清理后构建时指定。未指定时使用缓存构建。
-outdir 指定输出目标。
未指定时执行以下操作。
- (a) CRI Atom Craft最后构建的输出目标(必须在构建后保存)
- (b) 不满足(a)的条件时,项目的预设输出目标(项目下的文件夹)
-defaultoutdir 输出到项目下。
在希望不指定-outdir就输出到项目下的情况下使用。
指定了-outdir选项时,该选项被忽略。
-noclose 显示正在构建的窗口。用于在窗口检查命令是否正常工作。
-workunit 打开工作单元。指定作为构建目标的工作单元。
-workunitall 打开所有的工作单元。
当指定构建目标的工作单元复杂时,可以使用。
-noacf 不构建ACF,仅构建ACB。
-unity 输出Unity用文件。
-hierarchy 分层输出Cue Sheet文件夹。
-acbinfoxml 输出ACB的XML信息文件。
-csheader 输出CSharp(.cs)。
-json 输出对应ACB、ACF文件的JSON文件。

编辑的相关选项

选项 说明
-importCuesheetCsv 导入Cue Sheet CSV。
用逗号分隔,指定Cue Sheet CSV文件(绝对路径)和导入目标在CRI Atom Craft上的路径。
指定多个时,以
-importCuesheetCsv "C:/CueSheet_0.csv","WorkUnit_0/CueSheetFolder/","C:/CueSheet_1.csv","WorkUnit_0/CueSheetFolder/"
形式指定。
AtomCraft路径不存在时,将自动生成工作单元和Cue Sheet子文件夹。
引用Waveform的素材不存在时,则保存失败。
-importMaterialCsv 导入素材CSV。
用逗号分隔,指定素材CSV文件和导入目标在CRI Atom Craft上的路径。
指定多个时,以
-importMaterialCsv "C:/voice.csv","WorkUnit_0/MaterialRootFolder/","C:/voice2.csv","WorkUnit_0/MaterialRootFolder/"
形式指定。
AtomCraft路径不存在时,将自动生成工作单元和素材子文件夹。
素材引用的波形不存在时,构建将会失败,但可以保存。
-merge 在导入并合并Cue Sheet CSV和素材CSV的情况下指定。
对于不在CSV中的数据,合并并不会造成影响。
没有此标记时,使用CSV的内容新创建Cue Sheet下的数据。
-saveProject 保存项目。(仅在导入和构建没有出现问题时保存)
-nobuild 不执行ACB/ACF/AWB的构建。
在只准备通过导入生成数据而不构建时,与-saveProject一起使用。

Robot的相关选项

选项 说明
-script 执行脚本文件。
-script "scriptfile.py"
-scriptplugintype 指定脚本插件的类型。
可以指定pyhon3.7或python3.8。省略时,将使用在“脚本设置”中设置的插件。
-script plugintype python3.8
-scriptargument 为脚本文件指定其他新添的参数。
-scriptargument "Category_BGM"
指定的参数通过使用 get_script_argument 可以在脚本中获取。

关于Robot的详细信息,请参照 关于CRI Atom Craft Robot

选项示例

导入Cue Sheet CSV

在Windows系统下

-importCuesheetCsv
[CueSheetCSV FileName],[Path of AtomCraft].
ex. -importCuesheetCsv "C:/CueSheet_0.csv","WorkUnit_0/CueSheetFolder/"
Multiple Import [CueSheetCSV FileName(1)],[Path of AtomCraft(1)],[CueSheetCSV FileName(2)],[Path of AtomCraft(2)] ...
ex. -importCuesheetCsv "C:/CueSheet_0.csv","WorkUnit_0/CueSheetFolder/","C:/CueSheet_1.csv","WorkUnit_0/CueSheetFolder/"

在Mac系统下

-importCuesheetCsv
[CueSheetCSV FileName],[Path of AtomCraft].
ex. -importCuesheetCsv "/Users/(user_name)/CueSheet_0.csv","WorkUnit_0/CueSheetFolder/"
Multiple Import [CueSheetCSV FileName(1)],[Path of AtomCraft(1)],[CueSheetCSV FileName(2)],[Path of AtomCraft(2)] ...
ex. -importCuesheetCsv "/Users/(user_name)/CueSheet_0.csv","WorkUnit_0/CueSheetFolder/","/Users/(user_name)/CueSheet_1.csv","WorkUnit_0/CueSheetFolder/"

导入素材信息CSV

在Windows系统下

-importMaterialCsv
[MaterialCSV FileName],[Path of AtomCraft].
ex. -importMaterialCsv "C:/voice.csv","WorkUnit_0/MaterialRootFolder/"
Multiple Import [MaterialCSV FileName(1)],[Path of AtomCraft(1)],[MaterialCSV FileName(2)],[Path of AtomCraft(2)] ...
ex. -importMaterialCsv "C:/voice.csv","WorkUnit_0/MaterialRootFolder/","C:/voice2.csv","WorkUnit_0/MaterialRootFolder/"

在Mac系统下

-importMaterialCsv
[MaterialCSV FileName],[Path of AtomCraft].
ex. -importMaterialCsv "/Users/(user_name)/voice.csv","WorkUnit_0/MaterialRootFolder/"
Multiple Import [MaterialCSV FileName(1)],[Path of AtomCraft(1)],[MaterialCSV FileName(2)],[Path of AtomCraft(2)] ...
ex. -importMaterialCsv "/Users/(user_name)/voice.csv","WorkUnit_0/MaterialRootFolder/","/Users/(user_name)/voice2.csv","WorkUnit_0/MaterialRootFolder/"

指定工作单元

必须指定构建项目的哪个工作单元。
具体来说,请使用以下子命令之一。

  • -workunit
    -打开指定的工作单元并设为构建目标。
    如果没有指定,则将工具最后打开的工作单元作为目标。
  • -workunitall
    -打开所有的工作单元并设为构建目标。

此外,导入时根据导入参数的内容自动打开工作单元。(不存在时会提示错误。)

输出同名Cue Sheet

如果Cue Sheet文件夹与工作单元不同, 可以输出同名的Cue Sheet。
使用-hierarchy子命令,可以输出到不同的文件夹。