CRI ADX  Last Updated: 2024-07-17 10:48 p
游戏数据(ACF, ACB)的输出

本教程将使用在 项目的创建和在Cue上注册波形文件 教程中创建的项目,编写用于创建游戏数据( ACF文件ACB文件 )的脚本。

本教程使用了 项目的创建和在Cue上注册波形文件 教程中创建的项目。
没有打开项目时,请打开项目,或执行 项目的创建和在Cue上注册波形文件 所创建的脚本后开始此教程。

脚本文件的准备

在脚本菜单中选择“脚本列表...”,显示出脚本列表窗口。
单击脚本列表窗口中的新建按钮,按以下名称创建脚本文件。

脚本的保存目标 脚本文件名
tutorials [CRI] tutorial04-1_build_acb.py

脚本说明

双击已创建的脚本,用 从脚本编辑器运行脚本 打开。
要通过脚本列表窗口确认脚本概要,按照以下脚本说明来编写。

# --Description:[教程]游戏数据(ACF, ACB)的输出


模块的导入

编写脚本说明后,导入以下模块来用脚本操作CRI Atom Craft。

import cri.atomcraft.project as acproject
import cri.atomcraft.build as acbuild

除了用于操作CRI Atom Craft项目数据的 Project模块 之外,还需导入用于创建游戏数据的 build模块
CRI Atom Craft将创建游戏数据称作“构建”。

构建所需信息的获取

构建Cue Sheet并创建ACB文件时,需要使用以下对象。

  • Cue Sheet
  • 目标配置:输出目标的平台设置
  • 语言设置 :本地化设置(可省略)

在脚本中编写构建所需的各信息获取。

Cue Sheet的获取

参数的更改和预览 教程相同,先获取工作单元,然后获取其中的Cue Sheet。

# 获取工作单元
workunit = acproject.get_workunit("WorkUnit_Tutorial")["data"]
# 获取Cue Sheet根文件夹
cuesheet_rootfolder = acproject.get_cuesheet_rootfolder(workunit)["data"]
# 获取Cue Sheet文件夹“WorkUnit_Tutorial”
cuesheet_folder = acproject.get_child_object(cuesheet_rootfolder, "CueSheetFolder", "WorkUnit_Tutorial")["data"]
# 获取Cue Sheet
cuesheet = acproject.get_child_object(cuesheet_folder, "CueSheet", "Tutorial")["data"]

目标配置的获取

目标配置是用于管理平台的构建设置的对象,在总体设置中进行管理。
使用以下函数,从总体设置中获取目标配置文件夹。

函数名 说明
get_global_folder 获取总体设置正下方的各对象文件夹

使用以上函数进行目标配置的获取时,可以如下编写脚本。

# 目标配置文件夹的获取
target_config_folder = acproject.get_global_folder("TargetConfigFolder")["data"]
# PC目标配置的获取
target_config_pc = acproject.get_child_object(target_config_folder, "TargetConfigPc", "PC")["data"]

目标配置的获取说明

要获取用 全局设置 管理的各对象时,首先使用 get_global_folder 函数, 从总体设置获取对象文件夹。
get_global_folder 函数中指定“对象的文件夹类型”。
获取了对象文件夹后,使用 get_child_object 函数,获取所需的目标配置。

语言设置的获取

用于本地化的数据构建需要指定语言设置,但在本教程中不使用。
与目标配置相同,语言设置也是通过总体设置进行管理。
要获取时,与获取目标配置相同,请使用 get_global_folder 函数获取语言设置文件夹, 针对所获取的文件夹,使用 get_child_object 函数获取所需的语言设置。

游戏数据的构建

以上步骤显示了如何成功获取构建所需的“Cue Sheet”和“目标配置”信息。
使用 build模块 的以下函数构建Cue Sheet。

函数名 说明
build_cuesheet 构建指定的Cue Sheet

使用此函数进行Cue Sheet的构建时,可以如下编写脚本。

print("开始构建Cue Sheet “Tutorial”")
result = acbuild.build_cuesheet(cuesheet, target_config_pc, None)
if result["succeed"]:
print("Cue Sheet “Tutorial”构建完成。")
else:
print("Cue Sheet “Tutorial”构建失败。")

Cue Sheet构建的解说

构建游戏数据时,请使用 build_cuesheet 函数。
build_cuesheet 函数中指定“Cue Sheet信息”、“目标配置信息”和“语言设置信息”(可省略,省略时指定为None)。
运行函数后,构建所指定的Cue Sheet并创建ACB文件,同时将构建总体设置并创建ACF文件。
函数的返回值是构建是否成功。result将会存放在变量中,作为日志输出条件使用。

脚本的保存和执行

本教程的脚本编写到此为止。
请保存并执行脚本。
正常完成构建后,将会输出“CueSheet “Tutorial”构建完成。”的日志,同时将在与项目文件在同一层级中创建的“PC”目标文件夹中输出ACF文件和ACB文件。