CRIWARE Unity Plugin Manual  Last Updated: 2024-07-12
[CriAtom]McDSP插件

示例内容

概述

使用McDSP效果器的示例。

cri4u_samples_criatom_expansion01_main.png

操作方法

  • 按左侧的“Play Cue 1”/“Play Cue 2”按钮后,将循环播放音频。

  • 按右侧带有效果名称的按钮后,播放的音频将被切换为带有效果的状态。
    • 按“MasterOut”按钮后,将切换为不带效果的原有的音频。

  • 按“Snapshot1”/“Snapshot2”按钮后,效果参数将在3秒钟内,从当前状态逐渐变化为DSP总线快照的设置值。

  • 右下方的文本框中会显示有效的效果名和应用的快照名。

  • 按“Stop All”按钮后,将停止所有音频播放。

  • 按“Reset Effect”按钮后,将重置效果和快照设置。

场景信息


中间件 CRI ADX (CRI Atom)
示例 Expansion示例
存储位置 /CRIWARE/SDK/unity/samples/UnityProject/Assets/Scenes/criatom/expansion/
场景文件 Scene_01_McDSP_Preview.unity
ACF文件 /CRIWARE/SDK/unity/samples/UnityProject/Assets/StreamingAssets/McDSP/ForMcDSPSample.acf
ACB文件 /CRIWARE/SDK/unity/samples/UnityProject/Assets/StreamingAssets/McDSP/ForMcDSPSample.acb


程序说明

本示例中使用了支持McDSP效果的ACF/ACB文件。
脚本Scene_01_McDSP_Preview.cs会将将各效果相应的DSP总线的发送电平调整为0或1,来切换输出音频。
效果的应用和切换按照以下步骤进行:
  1. McDSP效果的初始化通过Assets/Plugins/CriWare/Expansions/CriAfxMcDspInitializer.cs在启动时自动执行。如需手动注册,请使用CriAfxMcDspInitializer.AddInterfaces()。
    • 请务必在ACF文件注册前执行AddInterfaces()。

  2. 使用CriAtomEx.AttachDspBussetting(string dspBusSettingName),应用McDSP的总线设置。
    • 请根据数据的设置值设置DSP总线名。

  3. 使用CriAtomSource.SetBusSendLevel(string busName, float level),设定要输出的效果的总线发送电平。
    • 本示例根据数据的设置,在effectList数组中定义各效果的总线名称等。

  4. 可以使用CriAtomEx.ApplyDspBusSnapshot(string snapshotName, int timeMs),将效果的参数经过所指定的timeMs(毫秒),从当前状态逐渐变化为快照的设置值。
    • 请根据数据的设置值设置快照名。
    • 快照设置会影响到所有效果总线。

  5. 通过执行CriAtomEx.DetachDspBusSetting(),可以清除目前的效果和快照的状态。