本课程介绍如何开发进行本地音频的开发，包括对应的默认交互反馈提示音替换、自定义增加音频。

概述

本地音频：是指本地存储空间的音频，主要用作启动、配网前、高频快速回复语，作为静态的提示音存储到本地。其它动态音频一般是从云端TTS服务生成，设备获取并播放的。
路径：设备文件系统中/data/prompt/路径下。
空间分配：目前TG6000A为提示音分配了2.2MB左右的系统空间作为本地存储，且不支持调整。受到littlefs影响，不支持OTA修改此分区；

SDK默认音频

编号 播放场景 文本内容 备注
1.mp3 开机铃声 （无） 正常开机的第一个铃声
2.mp3 联网成功音效 （无） 开机之后的联网成功铃声
4.mp3 开机引导提示音 欢迎使用天猫精灵，为了更好的为您服务，请先用手机下载天猫精灵APP，再根据手机提示帮我联网哦 设备处于未配网激活状态下的第二个开机提示音
5.mp3 配网提示音 进入配网状态，请使用天猫精灵app为我配网哦，预计需要1到3分钟 手动触发配网后的提示音
6.mp3 收到wifi密码的提示音 收到密码，正在连接网络
7.mp3 配网失败提示音：wifi密码输入错误 您输入的密码好像不太对，请检查后再试一次
8.mp3 配网成功提示音 联网成功，欢迎使用天猫精灵
9.mp3 wifi已连接但服务器断开时的唤醒提示音 抱歉网络似乎开小差了，建议您检查网络后再试一 次 一般是网络不好导致服务器断连
10.mp3 wifi未连接状态的唤醒提示音 网络连接失败，建议您根据手机提示帮我联网
12.mp3 蓝牙配对开始提示音 蓝牙配对开始
13.mp3 蓝牙配对成功提示音 蓝牙配对成功
15.mp3 蓝牙连接失败提示音 蓝牙连接失败，请再试一次吧
16.mp3 默认的唤醒提示音 “我在，你说” 联网后会根据音色自动下载其它唤醒提示音，下载成功后每次唤醒随机播放其中一个。
17.mp3 二次开麦/按键唤醒提示音 等哒（铃声） 要求尽量简短，请不要更换，会影响语音交互
20.mp3 语音识别失败时的一个错误提示 您再讲一遍好不好，人家没听清楚 语音识别失败
21.mp3 一走神，连您的吩咐都听岔了 一走神连您的吩咐都听岔了，在说一次呗 语音识别超时
23.mp3 恢复出厂设置提示音 正在恢复出厂设置，请稍等片刻
40.mp3 设备未授权状态的唤醒提示音 这台设备没有授权，请使用天猫精灵app进行配网 一般在配网失败之后或者设备被解绑后唤醒会遇到，说明需要重新配网才能使用
41.mp3 配网失败提示音：配网信息好像不对 配网信息好像不对，请检查后再试一试 配网时收到的ssid、userid、token字段为空时会播报，一般是ssid未输入或者APP异常时触发，需要检查ssid是否输入正确或者尝试卸载重新安装天猫精灵APP
42.mp3 配网失败提示音：服务器连接失败 服务器连接失败，请检查网络，或联系客服 一般是网络不好导致连接服务器失败或者三元组信息不对
44.mp3 配网失败提示音：认证超时 认证超时，建议您检查网络，再试一次吧 一般是网络不好导致认证超时
45.mp3 配网失败提示音：路由器连接失败 路由器检查失败，建议您检查后再试一试 一般是5G wifi或者路由器信号不好等原因导致wifi无法连接。
50.mp3 抱歉，已超出音频长度了 抱歉，已超出音频长度 音乐快进超出音频长度时触发
66.mp3 闹钟兜底铃声 (无) 一般在网络不好等情况下，在线铃声播放失败时会播放该提示音，保证闹钟触发后肯定会有铃声响起
141.mp3 蓝牙连接成功提示音 蓝牙连接成功
151.mp3 退出自动配网状态的提示音 您已取消配网，如果想继续，建议根据手机提示为我联网 设备处于自动配网状态（设备首次开机或者恢复出厂设置之后）时，首次MUTE操作触发
172.mp3 配网失败提示音：没有扫描到wifi 没有找到您要连接的网络，请检查信号强度或是否为5G wifi 设备收到wifi信息之后，连续30秒都没扫描到wifi时触发配网失败并播报该提示音

注意：

  • 默认音频编号和场景请不要修改。
  • 保持音频编号不变的情况下，音频内容本身可以直接替换，方法见下文对应方法。

自定义修改音频

格式要求

自定义修改音频存在增加和替换两种情况，目前只支持mp3格式（采样率：16KHz，声道数：单声道，码率：40kbps以下）。
增加音频时，需以数字方式进行命名，1.mp3 ~ 999.mp3为AliGenieSDK内部预留，为避免冲突，自定义音频需要使用1000以后的数字，比如1000.mp3、1001.mp3。
替换音频时，保持音频编号不变的情况下，音频内容本身可以直接替换，但需满足音频开发系统基本要求（如存储）。

生成方法

可以使用真人录音或者其它TTS生成工具定制生成音频。
但为了用户体验，增加由于SDK默认的提示音音色生成工具生成，暂无对外工具，请先联系技术支持，提供文本，生成相同音色的对应音频文件。

存放路径

将准备好的mp3音频文件，拷贝到代码工程的project/genie_tg6000a/data/prompt/目录下，然后重新编译，此时的固件就包含了自定义提示音，重新烧录（务必重新烧录LITTLEFS）之后，可以在设备/data/prompt/路径下找到对应的提示音，如/data/prompt/1000.mp3、/data/prompt/1001.mp3。
通过以下命令查看设备系统中具体有哪些提示音

  1. ll /data/prompt

结果如下所示，
image.png

触发播放

参考《AliGenie SDK集成和接口说明》文档，调用2.1节中的int ag_audio_play(const char *url, const AG_AUDIO_TYPE type);接口，url传入完整的音频路径，type传入AG_AUDIO_TYPE_PROMPT即可播放，可参考Demo代码，详见代码工程的aligenieSDK/demo/ag_play.c。