1、端测：硬件平台搭建
图1: HaaS100智能语音播放器系统框架
基于HaaS100开发“云端钉一体”的智能语音播放器，需要的硬件模块包括：
HaaS100开发版（电源/ WIFI天线）: 购买HaaS100硬件套装时已经提供。
microUSB数据线。
模拟MIC：硅麦一般有正负两级，HaaS100和硅麦的正/负极之间分别需要“1uF电容 + 2K电阻”上/下拉滤波，确保HaaS100可以采集到干净清晰的录音信号。具体连接方式参考上图。
喇叭：分为3线（VCC + GND + DIN）和4线（VCC + GND + DIN_P + DIN_N）两种经典的喇叭连接方式。上图中我们采用的是3线制喇叭，和HaaS100的连接参考上图。
2、端测：软件开发
2.1、AliOS Things开发环境准备
- AliOS Things基础工具：aos-cube, git工具安装。
- VS code IDE：《使用VS code IDE开发》
- HaaS100代码获取、编译、烧录：《HaaS100快速开始》
2.2、代码修改
2.2.1、源码介绍
图2: 云端钉一体智能语音播放器软件框架
云端钉一体智能语音播放器软件模块包括：
- audio_demo:主要打通HaaS100和阿里云物联网平台连接、通信，物模型解析，播放器功能逻辑的实现。
- uVoice组件：是AliOS Things上智能语音解决方案的核心组件，提供了本地音频，URL音频，TTS合成等基础功能，音频格式支持mp3, m4a, wav, opus等主流格式。
- A2SA组件：是AliOS Things上音频服务框架，兼容ALSA应用接口访问，支持音频硬件驱动抽象，多音频驱动加载/卸载，VFS接口支持等功能。多播放焦点管理，混音，softvol，重采样等功能设计中。
- 麦克风/喇叭硬件：HaaS100上已经集成了模拟麦和Speaker的硬件驱动。
2.2.2、application/example/audio_demo
在文件audio_demo/linkkit_example_solo.c中包含了HaaS100设备和阿里云物联网平台链接的关键密钥信息（四元组）。
图3: HaaS100开源SDK中修改audio_demo四元组信息
每位用户应该根据自己在"阿里云物联网平台"中创建的产品信息中可以获取到一下四元组信息。只有在audio_demo/linkkit_example_solo.c中填写了正确的四元组信息，HaaS100语音播放器才能正确连接用户自己账号的阿里云物联网平台。
- "ProductKey"：用户创建的产品类型的Key（唯一ID）
- "ProductSecret"：用户创建的产品类型的密钥（和ProductKey一一对应）
- "DeviceName": 该产品类型下的某个具体设备名字（某个产品类型下可以有很多量产设备）
- "DeviceSecret": 该产品类型下的名字为DeviceName设备的密钥（和DeviceName一一对应）
图4: 阿里云物联网平台获取四元组信息页面
2.2.3、components/service/uvoice
在我们的uvoice组件中集成了阿里巴巴的“智能语音交互”的部分功能，例如免费试用版的“语音合成”功能，需要商用的用户可以付费开通商用版。
用户需要登陆“智能语音交互”主页，并根据引导创建一个包含“语音合成”功能的项目。项目创建完成后，项目主页中会生成该项目的“Appkey”, 总览主页中可以获取到“AccessToken”两个重要信息。
图5: 创建智能语音交互项目和获取AppKey
图6: 获取智能语音交互AccessToken
在HaaS100 SDK的components/service/uvoice/test/test_tts.c中，我们需要填写正确的AppKey和AccessToken信息才可以使用阿里巴巴“智能语音交互 - 语音合成”功能。值得注意的是，AccessToken是动态刷新的，周期是每个用户账户可配置的，默认是2天变化一次。因此在功能开发阶段，需要周期性的更新固件中的AccessToken，否则可能出现语音合成功能访问失败的问题。如果是产品量产阶段，可以基于阿里云端一体的安全通道周期更新设备端AccessToken。
阿里云智能语音合成功能提供了Java/ C++/ Restful等多种SDK，开发者也可以自己下载SDK适配。
图7: uvoice组件中修改AppKey和AccessToken代码位置
2.3、代码编译、下载
编译audio_demo的命令如下，编译成功之后参考《HaaS100快速开始》文章将固件更新到HaaS100板子上。最新的版本支持Windows, Mac下刷机。
aos make clean && aos make distclean
aos make audio_demo@haas100 -c config
aos make
固件烧写成功后，可以通过以下方法快速验证HaaS100的喇叭和麦克风之间的硬件连接是否正常。
串口终端：insmod_audio_drv
串口终端：loopback 0 start
敲完以上两个命令之后，HaaS100进入录音/播放的loopback测试模式，用户靠近麦克风说话，喇叭正常有声音输出。
2.4、配网、连接物联网平台
HaaS100 WIFI配网方法如下。如果配网信息和四元组信息都正确的情况下，HaaS100和物联网平台连接成功后有如下HardwareError ping-pong日志打印。
netmgr -t wifi -c {ssid} {password}
例如： netmgr -t wifi -c EthanIPhone 12345678
图8: 连接物联网平台成功后的ping-pong日志打印
如果，有些开发者发现自己的HaaS100板子WIFI连接路由器困难，那么可以尝试以下方法排查。
- 更新github上的最新固件
- 串口终端：>> aos_mac WIFI，获取WIFI MAC地址，如果是全0，那么需要更新MAC地址
。 - HaaS VIP钉群中咨询@谷饮，获取唯一的WIFI MAC地址。
- 串口终端：>> aos_mac WIFI XX:XX:XX:XX:XX:XX，更新WIFI MAC地址。
3、阿里云IoT平台
阿里云物联网平台创建产品、设备的过程可以参考文章《阿里云物联网平台快速入门实践》。其中“云端钉一体的智能语音播放器”物模型设计可以参考：“智能语音播放器物模型”。
在开发者创建自己产品时，可以选择导入我们提供的“智能语音播放器物模型”来生成一个临时产品，从而快速的验证云端钉一体的智能语音播放器方案，请参考下图步骤。
图9: 创建产品时快速导入物模型
4、钉钉小程序
4.1、快速开始
参考文章《30分钟上手HaaS小程序开发》, 文中介绍了小程序开发工具IDE、HaaS钉钉小程序示例代码获取、钉钉小程序申请、小程序真机调试等基础内容。开发者可以根据这篇文章快速上手一个自己的小程序应用开发。
4.2、小程序：HaaS语音播放器
下载的“HaaS钉钉小程序示例代码”中包含了“HaaS智能语音播放器”示例源码。HaaS语音播放器中创建了2个page，分别是HaasAudioPlayer和playList。
-
HaasAudioPlayer页面功能有：加载/卸载HaaS100声卡，打开/关闭录音，TTS语音合成入口，当前播放音乐的基础信息（歌曲名、歌手名、专辑图片），播放模式选择，音效选择，音量控制，播放控制（播放、暂停、上一首、下一首）以及播放列表入口。
-
playList页面：自动从./mock/data.json中导入用户与设置好的播放列表信息。
4.2.1、小程序账号信息修改
要成功使用HaaS智能语音播放器小程序，开发者需要正确输入用户的账号信息，包括
- accessKeyId + accessKeySecret: 钉钉小程序访问用户“阿里云物联网平台”账户的密钥信息。修改代码路径是./pages/app.js。
图10: 访问阿里云物联网平台的密钥信息
- DeviceName + ProductKey：指定钉钉小程序需要控制的用户物联网平台中的某个HaaS100设备。修改代码路径是./pages/HaasAudioPlayer/HaasAudioPlayer.js
图11: 访问阿里云物联网平台某个HaaS设备的密钥信息
4.2.2、修改播放列表
开发者可以自己修改歌曲播放列表，配置文件位于./mock/data.json。每首歌曲信息包含:
- id: 歌曲在播放列表中的id
- copyrightId：歌曲版权信息，可忽略
- picS: 歌曲在播放页面中显示的图片信息
- songName: 歌曲名
- singerName: 歌手名
- url: 歌曲链接，可以是本地文件系统中的歌曲文件，例如fs:/data/6.mp3，也可以是浏览器可以直接播放的网络歌曲链接。
经过以上2个简单步骤，开发者就已经快速开发好一个简单的“HaaS智能语音播放器”了。真机调试方法可以参考文章《30分钟上手HaaS小程序开发》。祝您体验HaaS云端钉一体智能语音播放器方案愉快。
5、开发者技术支持
如需更多技术支持，可加入钉钉开发者群，或者关注微信公众号
更多技术与解决方案介绍，请访问阿里云AIoT首页
