5. 变音音效(vo_pitch)

AD16N 和 AW30N SDK均提供变音音效(vo_pitch)音效,该功能由 app_modules_h.c 里的 VO_PITCH_EN 宏控制开关。

本节主要介绍变音音效,其包含一下几种音效:

  • ① 两种机器人声;

  • ② 两种变速变调;

  • ③ 两种rap;

  • ④ 卡通音效;

  • ⑤ 混响音效;


5.1. 变音音效参数配置

"图1 变音音效参数配置"

图1 变音音效参数配置

变音音效的参数配置如图1 变音音效参数配置

但是在选择不同的变声效果时,在某些效果下有些参数无效,如图2所示

其他音效模式具体参照SDK中的文件apps/app/bsp/common/sound_effect/vo_pitch_api.c中各个音效参数配置函数的注释说明。

"图2 变调模式参数配置"

图2 变调模式参数配置


5.2. 变音音效算法链路链接函数

SDK提供下面的函数,传递不同的CMD参数可以实现不同的音效。

5.2.2. 函数void *voice_pitch_api(void *obuf, u32 cmd, void **ppsound)

该函数用于初始化变音音效相关参数,由函数link_voice_pitch_sound()调用即可;
该函数内部会调用函数vp_cmd_case(),用于配置所选的变音音效以及其参数。

5.2.3. 函数void rap_callback(void *priv, int pos)

该函数为RAP模式的回调函数,由解码器调用。其中的参数pos表示RAP模式的状态;
RAP模式初始化后,pos会处于RAP_PREPARE状态等待输入音源;
当输入音源大于所设置的noise_dc能量阈值后,会触发RAP模式,此时pos在会PAR_START状态;
当RAP播放结束后,pos会在RAP_END状态循环。若需要重置RAP状态,需调用函数rap_reopen()。

5.2.4. 函数void rap_reopen(void)

该函数用于RAP模式播放结束后,让RAP重回RAP_PREPARE状态。


5.3. 变音音效算法参数函数

通过配置不同的参数,可以实现不同的音效,其中关键的函数有以下:

1、音效参数选择函数:

bool vp_cmd_case(VP_CMD cmd, VOICE_PITCH_PARA_STRUCT *p_vc_parm);

2、rap音效参数配置函数:

void vp_cmd_rap(p_vc_parm);

3、实时rap音效参数配置函数;

void vp_cmd_rap_realtime(VOICE_PITCH_PARA_STRUCT *p_vc_parm);

4、平调机器人音效参数配置函数;

void vp_cmd_robot(VOICE_PITCH_PARA_STRUCT *p_vc_parm);

5、变调机器人音效参数配置函数;

void vp_cmd_robot2(VOICE_PITCH_PARA_STRUCT *p_vc_parm);

6、变速变调音效参数配置函数;

void vp_cmd_pitchshift(VOICE_PITCH_PARA_STRUCT *p_vc_parm);

7、变速变调2音效参数配置函数;

void vp_cmd_pitchshift2(VOICE_PITCH_PARA_STRUCT *p_vc_parm);

8、卡通音效参数配置函数;

void vp_cmd_echo(VOICE_PITCH_PARA_STRUCT *p_vc_parm);

9、混响音效参数配置函数;

void vp_cmd_echo(VOICE_PITCH_PARA_STRUCT *p_vc_parm);


5.4. 两种RAP音效的区别

RAP与实时RAP的音效是一样的,都是在输入音频数据流有能量时进行一次变音;但是他们在使用控制时有较大的区别;

1、RAP在调用启动后,会在输入的音频信号有能量时进行一次变音,再之后就会停止;下次启动变音需要调用回调函数,回调函数中调用rap_reopen可以再次启动RAP;

2、实时RAP在启动后,变音会一直工作;

5.5. RAP和RAP_REALTIME模式文件替换说明

用户可以通过替换该音效依赖的midi文件表来进行播出不同的音调,midi文件表位于头文件midi_file0_h.h。

"midi_file0_headfile.png"

用户可以通过get_miditabs工具生成midi文件表,首先将需要使用的midi文件表放入工具目录,然后点击t.bat生成头文件

"get_miditabs.png"

打开头文件可以看到生成的midi文件表

"midi_tab.png"

最后将生成的文件表复制到SDK的头文件midi_file0_h.h,然后在函数初始化设置配置文件表,图中以rap_realtime模式为例

"rap_realtime_config.png"