音频播放器(AUDIO PLAYER)¶
1. 概述¶
SDK内置组件轻量级音频播放器是一个非常重要的组件,CI231X系列芯片作为一款语音识别芯片,在语音交互上语音播报是不可缺失的一环。该组件具有轻量、易用、可扩展的特点。播放组件可以支持解码器注册式扩展,用户可以自行注册音频解码器,例如MP3、ACC、FLAC,完成相关解码器注册后即可使用通用播放器接口进行音频播放。播放器数据源获取已支持spiflash、sd卡、http网络下载和扩展写入接口。若是使用spiflash、sd卡、http网络下载可以直接使用相关api接口直接启动播放。而使用数据写入接口则可以自由调用写入函数将数据写入缓冲器,无需关心解码和硬件播放可以完成播放任务。
2. 使用说明¶
2.1. 代码结构¶
源文件 | 说明 |
---|---|
audio_play_api.c audio_play_api.h |
播放器接口函数 |
audio_play_decoder.c audio_play_decoder.h |
解码器接口 |
audio_play_device.c audio_play_device.h |
声卡硬件 |
audio_play_os_port.c audio_play_os_port.h |
os抽象层 |
audio_play_process.c audio_play_process.h |
播放器调度主任务 |
get_play_data.c get_play_data.h |
音频数据源获取 |
2.2. 解码器注册¶
播放器提供音频播放格式需要解码器的提供,解码器结构定义在audio_play_decoder中,在系统初始化时,需将使用到的音频格式相应的解码器通过registe_decoder_ops函数注册到播放器组件。
registe_decoder_ops(&prompt_decoder); //注册prompt解码器
registe_decoder_ops(&mp3_decoder); //注册mp3解码器
registe_decoder_ops(&aac_decoder); //注册aac解码器
registe_decoder_ops(&ms_wav_decoder); //注册ms_wav解码器
registe_decoder_ops(&flac_decoder); //注册flac解码器
提示
相关音频播放格式需要解码器的提供,这里只提供注册ops接口。
2.3. 预置数据源播放API¶
2.3.1. 播放audio¶
play_audio函数提供了从SD卡和网络url播放音频文件的功能,使用示例如下:
//播放来自文件系统/test128.mp3,0代表播放启始偏移,"mp3"为解码器类型带ID3V2头的标准mp3文件可以填NULL,播放器可以自动识别文件类型,NULL为播放完成时的回调函数注册
play_audio("/", "test128.mp3", 0, "mp3",NULL);
//播放来自网络192.168.31.1/test128.mp3,第二个参数填NULL,"mp3"为解码器类型,0代表播放启始偏移,NULL为播放完成时的回调函数注册
play_audio("192.168.31.1/test128.mp3", NULL, 0, "mp3",NULL);
2.3.2. 播放语音命令词¶
play_prompt函数提供了从spiflash中播放adpcm播报词的功能,使用示例如下:
//0x4000为flash内adpcm播报词音频地址,1为播放音频数量,NULL为播放完成时的回调
play_prompt(0x4000,1,NULL);
提示
关于播报词音频在flash内的地址如何获取请使用cmd_info内的播放接口,目前播放器内接口已基本做为内部播放使用。
2.4. 外部自定义数据源的使用¶
在audio_play_api中还提供了一组outside_*的接口,其目的是用于创建一个外部数据流,通过向数据流写入原始音频数据,就可以通过播放器的解码器到播放器实现播放功能。
接口名称 | 功能说明 |
---|---|
play_with_outside | 请求播放外部数据 |
outside_init_stream | 创建外部数据流服务,需要传递数据流描述符和数据结束描述符 |
outside_destroy_stream | 销毁数据流 |
set_curr_outside_handle | 设置当前播放器使用的数据流描述符 |
outside_send_end_sem | 发送数据结束信号 |
outside_write_stream | 向数据流写入数据 |
outside_clear_stream | 清理数据流 |
这组接口中outside_init_stream函数可以创建一个外部数据流服务,通过set_curr_outside_handle设置当前播放器使用的数据流,即可通过outside_write_stream函数向数据流写入数据,此时调用播放接口播放器将自动从数据流中获取音频数据,并进行解码播放,当数据end时,使用outside_send_end_sem函数发送信号,这样在全部数据播放完成时,播放end回调函数将正常结束。使用外部数据流方式页同样可以使用播放器的开始暂停查询进度等接口。如图所示:
- 启动播放流程:
- 用户主动暂停/停止播放:
- 用户主动继续播放:
- 用户音频数据结束发出数据结束信号停止:
注意
这组接口的数据管理需要用户自我管理,播放器将不负责数据进度信息。