游戏数据（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文件。