前面创建的脚本都是在脚本内直接编写工作单元、Cue Sheet等操作目标对象的名称。
然而，采用这种方法时，如果想要一边更改操作对象，一边应用相同的处理，就需要直接编辑代码，可能会很繁琐或出现打字错误。
为了减少繁琐的操作，CRI Atom Craft Robot上装有叫做脚本编辑器的扩展格式的功能。
该功能可以在脚本列表和菜单中显示脚本内编写的注释信息，或通过编辑器GUI操作来轻松更新用脚本定义的变量。
通过使用脚本编辑器用的扩展格式，可以减少修改脚本的繁琐和错误。

本教程将使用脚本编辑器的扩展格式的用户变量功能，通过GUI操作来更改Cue的“音高”参数的脚本。

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

脚本文件的准备

选择脚本菜单上的“脚本列表...”显示脚本列表窗口。
按脚本列表窗口的“新建”按钮，使用以下名称创建脚本文件。

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

脚本说明

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

# --Description:[教程]使用用户变量更改Cue的“音高”参数

模块的导入

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

import cri.atomcraft.project
import cri.atomcraft.project as acproject
import cri.atomcraft.debug as acdebug

导入 Project模块以进行项目操作，同时导入 debug模块以输出日志。
定义操作对象的用户变量时，需要导入未替换导入名的cri.atomcraft.project。

定义作为用户变量使用的变量

首先，为了决定用户变量的范围，在脚本的代码内编写 “# –BeginUserVariable ~ # –EndUserVariable”。
在“# –BeginUserVariable ~ # –EndUserVariable”范围内定义了的变量将在从脚本编辑器运行脚本中作为用户变量使用。

为了更改Cue的音高，需要在“# –BeginUserVariable ~ # –EndUserVariable”内编写以下变量。

用于变更参数的Cue的变量
用于设置要变更的参数字段名的变量
用于设置参数值的变量

具有一系列内容时，可以如下编写脚本。

# --BeginUserVariable
VARIABLE_CUE = None
VARIABLE_PARAMETER_NAME = ""
VARIABLE_PARAMETER_VALUE = 0
# --EndUserVariable

事先为定义了的变量设置初始值。

定义在用户变量设置中显示的信息

定义了在用户变量画面上显示所定义的用户变量时所需的信息。
如下所示，在用三重双引号"""括住的docstring中，于定义的变量前编写变量名、种类、说明。

"""
变量名:
  type: 变量的种类
  comment: 参数的说明
"""

type有以下3种，根据变量的内容来更改要指定的种类。

类型的种类	说明
object	变量为对象时指定
string	变量为字符串时指定
number	变量为数值时指定

脚本编写如下：

# --BeginUserVariable
"""
VARIABLE_CUE:
  type: object
  comment: 要更改参数的Cue
VARIABLE_PARAMETER_NAME:
  type: string
  comment: 参数的字段名
VARIABLE_PARAMETER_VALUE:
  type: number
  comment: 参数值
"""
VARIABLE_CUE = None
VARIABLE_PARAMETER_NAME = ""
VARIABLE_PARAMETER_VALUE = 0
# --EndUserVariable

此处通过从脚本编辑器的工具栏按钮单击[更新]按钮后，脚本编辑器右侧的“用户变量”中会显示在脚本编辑器中编写的用户变量信息。

对用户变量设置参数

脚本编辑器的“用户变量”中显示在脚本中设置的用户信息后，设置各用户变量。
从CRI Atom Craft的树状列表中，拖放至VARIABLE_CUE进行设置。
在VARIABLE_PARAMETER_NAME、VARIABLE_PARAMETER_VALUE中设置以下值。

变量名	值
VARIABLE_PARAMETER_NAME	Pitch
VARIABLE_PARAMETER_VALUE	100

单击[应用]后，脚本中会反映脚本编辑器的“用户变量”的内容。

使用定义的“用户变量”来更新Cue的参数

以上介绍了如何使用用户变量功能来设置用户变量值。
请使用用户变量来更新Cue的参数
使用脚本编写Cue的参数更新处理时，会如下所示。

acproject.set_value(VARIABLE_CUE, VARIABLE_PARAMETER_NAME, VARIABLE_PARAMETER_VALUE)
 
acdebug.log("[教程]使用用户变量的Cue的“音高”参数更新完成")

脚本的保存和执行

本教程的脚本编写到此为止。
请保存并执行脚本。
正常运行脚本后，Cue的音高值将被更新为在用户变量画面中设置的值，如下所示。

以上教程介绍了使用用户变量功能来更新Cue的音高的脚本。
本脚本的对象不仅是Cue，还能指定音轨等。
此外，也可以指定音高以外的其他参数名。
您可以编辑脚本以测试不同的效果。