Tween

作为在一定时间内更改AtomExPlayer的参数（音量和音高等）的方法， 可以使用Atom运行库的Tween功能。

关于Tween

Tween是用于将“特定参数”在“指定时间”“更改为目的值”的模块。
通过使用Tween，可以轻松实现例如“在0.5秒后将音量降至0”的操作。

将Tween添加到AtomExPlayer中使用。
具体操作步骤如下。

1. 用 criAtomExTween_Create 函数创建与想要操作的参数对应的Tween句柄。
2. 将已创建的Tween句柄用 criAtomExPlayer_AttachTween 函数添加到AtomExPlayer。
   （可根据需要，用 criAtomExPlayer_Start 函数等执行播放。）
3. 执行 criAtomExTween_MoveTo 函数并更改参数。

例如，可以使用以下代码，从而在0.5秒内降低音量。

    ：
/* 创建渐变音量的Tween */
CriAtomExTweenConfig config;
criAtomExTween_SetDefaultConfig(&config);
config.parameter_type = CRIATOMEX_PARAMETER_TYPE_BASIC;
config.id.parameter_id = CRIATOMEX_PARAMETER_ID_VOLUME;
CriAtomExTweenHn tween = criAtomExTween_Create(&config, NULL, 0);
 
/* 将Tween添加到Player */
criAtomExPlayer_AttachTween(player, tween);
 
/* 开始播放 */
criAtomExPlayer_Start(player);
    ：
/* 指示在0.5秒（＝500毫秒）内降低音量 */
criAtomExTween_MoveTo(tween, 500, 0.0f);
    ：

备注:

Tween是面向运行时的功能。
无法在工具上进行与Tween有关的设置。

关于可操作的参数

在创建Tween句柄时指定用Tween操作的参数。
指定参数大致可分为以下两种模式。

• CRIATOMEX_PARAMETER_TYPE_BASIC
• CRIATOMEX_PARAMETER_TYPE_AISAC

要控制音量、Pan、音高等常规参数，请在 CriAtomExTweenConfig 结构体的parameter_type中设置 CRIATOMEX_PARAMETER_TYPE_BASIC ，为 id.parameter_id指定想要控制的参数ID。
如果想要使用Tween控制AISAC控制值，请在 CriAtomExTweenConfig 结构体的parameter_type中设置 CRIATOMEX_PARAMETER_TYPE_AISAC ，为id.aisac_control_id指定想要控制的AISAC控制器ID。

备注:

关于指定 CRIATOMEX_PARAMETER_TYPE_BASIC 时可操作的参数列表，请参照 CriAtomExParameterId 。