app_player 内存音频播放示例

功能说明

演示如何使用 app_player 组件通过 mem:// 协议播放存储在 Flash 内存中的音频文件，包括基本的播放、暂停、恢复和停止控制。

硬件连接

PA27: PA（功放）控制引脚，用于控制音频功放的开关

示例步骤

将音频文件预先烧录到 Flash 指定地址（默认 0x30100000）
初始化 app_player 模块并配置 PA 控制回调
创建播放器实例并注册事件回调
构造 mem:// 协议 URL 指定音频数据地址和大小
播放内存中的音频数据
演示暂停、恢复、停止等控制操作

编译

重要提示：在编译前，请先确认您使用的开发板型号。SDK 目前支持以下开发板：

arcs_evb - ARCS EVB 评估板
arcs_mini - ARCS Mini 开发板

根据您的开发板型号，选择对应的编译命令：

在示例目录下执行编译:

# 使用 arcs_evb 开发板
./build.sh -C -DBOARD=arcs_evb

# 或使用 arcs_mini 开发板
./build.sh -C -DBOARD=arcs_mini

Note

如果在 SDK 根目录执行，需要指定示例路径:

# 使用 arcs_evb 开发板
./build.sh -C -S samples/<示例路径> -DBOARD=arcs_evb

# 或使用 arcs_mini 开发板
./build.sh -C -S samples/<示例路径> -DBOARD=arcs_mini

Note

确保已安装对应的工具链。

烧录

编译完成后，使用 SDK tools 目录下的 cskburn 工具烧录固件:

./tools/burn/cskburn -s /dev/ttyUSB0 -b 3000000 0x0 build/arcs.bin -C arcs

Note

烧录参数说明：

-s /dev/ttyUSB0：串口设备路径，需要根据实际情况修改 - Linux 系统：通常是 /dev/ttyUSB0 或 /dev/ttyACM0 - 可通过 ls /dev/tty* 命令查看可用串口设备 - 不同开发板或 USB 转串口芯片可能使用不同的设备名
-b 3000000：烧录波特率（3Mbps）
0x0：烧录起始地址
build/arcs.bin：编译生成的固件路径
-C arcs：芯片类型

注意事项：

确保开发板已正确连接到电脑
如果无法识别串口设备，请检查 USB 连接线是否正常，或尝试其他 USB 端口

预期输出

=== Memory Audio Playback Sample ===
Audio Flash Address: 0x30100000
Audio Data Size: 8192 bytes
PA OFF
Memory URL: mem://addr=806355570size=8192

=== Scenario 1: Play memory audio ===
Playing audio from memory...
PA ON
Player prepared
Player playing

=== Scenario 2: Pause playback ===
Audio paused
Player paused

=== Scenario 3: Resume playback ===
Audio resumed
Player playing

=== Scenario 4: Stop playback ===
Audio stopped
Player stopped
PA OFF

=== Sample completed ===

核心 API

API	说明
`app_player_init()`	初始化 app_player 模块
`app_player_create()`	创建播放器实例
`app_player_register_callback()`	注册播放事件回调函数
`app_player_play()`	播放指定 URL 的音频（支持 `mem://` 协议）
`app_player_pause()`	暂停播放
`app_player_resume()`	恢复播放
`app_player_stop()`	停止播放（同步接口）
`app_player_destroy()`	销毁播放器实例

关键代码

/* 构造 mem:// URL */
char mem_url[64];
snprintf(mem_url, sizeof(mem_url), "mem://addr=%usize=%u",
         AUDIO_FLASH_ADDR, AUDIO_DATA_SIZE);

/* 初始化播放器 */
app_player_config_t config = { .pa_ctrl_callback = pa_control_callback };
app_player_init(&config);

/* 创建播放器并播放 */
app_player_t *player = app_player_create("mem_demo");
app_player_register_callback(player, player_event_callback, NULL);
app_player_play(player, mem_url);

注意事项

地址对齐: Flash 地址 AUDIO_FLASH_ADDR 必须与烧录工具的地址一致
文件大小: AUDIO_DATA_SIZE 必须设置为实际文件大小，否则可能导致播放失败
分区冲突: 确保音频存储地址不与固件或其他数据的 Flash 分区冲突
音频格式: 支持 MP3、WAV、AAC、M4A、PCM 格式，推荐 16kHz、16bit、单声道
PA 回调必填: app_player_init() 时必须提供 pa_ctrl_callback，用于控制功放开关