本文介绍如何使用阿里云智能语音服务提供的微信小程序SDK，包括SDK的安装方法及SDK代码示例。
前提条件
在使用SDK前，请先阅读接口说明，详情请参见接口说明。
下载安装
微信基础库要求2.4.4及以上版本。
请确认已经安装微信小程序开发环境，并完成基本配置。具体可参见微信开发者工具。
需要提前将如下URL添加到微信小程序后台服务器域名中：
request合法域名：
https://nls-meta.cn-shanghai.aliyuncs.comsocket合法域名：
wss://nls-gateway.cn-shanghai.aliyuncs.com
下载并安装SDK。
通过Github下载对应SDK代码，或直接下载alibabacloud-nls-wx-sdk-master.zip。
导入SDK。
您可将下载好的代码放入工程合适目录下，然后根据目录位置通过require进行导入。
获取Token
getToken
获取Token并以akid和akkey为key缓存对应Token，如果缓存的Token过期则自动刷新并获取。缓存机制请参见微信小程序文档的数据缓存部分。
参数说明：无。
返回值：String类型的Token。
getTokenInner
直接获取Token，不带任何缓存机制，适用于用户自定义缓存方式。
频繁调用该接口会被服务端拒绝访问。
参数说明：无。
返回值：String类型的Token。
语音合成
Class: SpeechSynthesizer
SpeechSynthesizer类用于进行语音合成。
构造函数参数说明：
参数 | 类型 | 参数说明 |
config | Object | 连接配置对象。 |
config object说明：
参数 | 类型 | 参数说明 |
url | String | 服务URL地址。 |
token | String | 访问Token，详情可参见获取Token概述。 |
appkey | String | 对应项目Appkey。 |
defaultStartParams(voice)
返回一个默认的推荐参数，其中voice为您自行提供，采样率为16000 Hz，格式为WAV，音量50，语速语调皆为0，不开启字幕。您在拿到默认对象后可以根据自身需求，结合接口说明中的参数列表来添加和修改参数。
参数说明：
参数
类型
参数说明
voice
String
发音人。
返回值：
object类型对象，字段如下：
{ "voice": voice, "format": "wav", "sample_rate": 16000, "volume": 50, "speech_rate": 0, "pitch_rate": 0, "enable_subtitle": false }
on(which, handler)
设置事件回调。
参数说明：
参数 | 类型 | 参数说明 |
which | String | 事件名称。 |
handler | Function | 回调函数。 |
支持的回调事件如下：
事件名称 | 事件说明 | 回调函数参数个数 | 回调函数参数说明 |
meta | 字幕回调。 | 1 | String类型，字幕信息。 |
data | 合成音频回调。 | 1 | Arraybuffer类型，合成音频数据。 |
completed | 语音合成完成。 | 1 | String类型，完成信息。 |
closed | 连接关闭。 | 0 | 无。 |
failed | 错误。 | 1 | String类型，错误信息。 |
返回值：无。
async start(param)
根据param发起一次一句话识别，param可以参考defaultStartParams方法的返回，具体参数见接口说明。
参数说明：
参数 | 类型 | 参数说明 |
param | Object | 语音合成参数。 |
返回值： Promise对象，当started事件发生后触发resolve，并携带started信息；当任何错误发生后触发reject，并携带异常信息。
代码示例
以下代码示例仅供参考，代码中使用微信小程序自带录音功能，实际使用时，需要考虑微信小程序的限制，以及前端页面设计和具体业务功能。
// pages/tts/tts.js
const app = getApp()
const AKID = "Your AKID"
const AKKEY = "Your AKKEY"
const SpeechSynthesizer = require("../../utils/tts")
const formatTime = require("../../utils/util").formatTime
const sleep = require("../../utils/util").sleep
const getToken = require("../../utils/token").getToken
const fs = wx.getFileSystemManager()
Page({
/**
* 页面的初始数据
*/
data: {
ttsStart: false,
ttsText: ""
},
/**
* 生命周期函数--监听页面加载
*/
onLoad: async function (options) {
try {
this.data.token = await getToken(AKID, AKKEY)
} catch (e) {
console.log("error on get token:", JSON.stringify(e))
return
}
let tts = new SpeechSynthesizer({
url: app.globalData.URL,
appkey:app.globalData.APPKEY,
token:this.data.token
})
tts.on("meta", (msg)=>{
console.log("Client recv metainfo:", msg)
})
tts.on("data", (msg)=>{
console.log(`recv size: ${msg.byteLength}`)
//console.log(dumpFile.write(msg, "binary"))
if (this.data.saveFile) {
try {
fs.appendFileSync(
this.data.saveFile,
msg,
"binary"
)
console.log(`append ${msg.byteLength}`)
} catch (e) {
console.error(e)
}
} else {
console.log("save file empty")
}
})
tts.on("completed", async (msg)=>{
console.log("Client recv completed:", msg)
await sleep(500)
fs.close({
fd : this.data.saveFd,
success: (res)=> {
let ctx = wx.createInnerAudioContext()
ctx.autoplay = true
ctx.src = this.data.saveFile
ctx.onPlay(() => {
console.log('start playing..')
})
ctx.onError((res) => {
console.log(res.errMsg)
console.log(res.errCode)
fs.unlink({
filePath: this.data.saveFile,
success: (res)=>{
console.log(`remove ${this.data.saveFile} done`)
this.data.saveFile = null
this.data.saveFd = null
},
failed: (res)=>{
console.log("remove failed:" + res.errMsg)
}
})
})
ctx.onEnded((res)=>{
console.log("play done...")
fs.unlink({
filePath: this.data.saveFile,
success: (res)=>{
console.log(`remove ${this.data.saveFile} done`)
this.data.saveFile = null
this.data.saveFd = null
},
failed: (res)=>{
console.log("remove failed:" + res.errMsg)
}
})
})
},
fail : (res)=>{
console.log("saved file error:" + res.errMsg)
}
})
})
tts.on("closed", () => {
console.log("Client recv closed")
})
tts.on("failed", (msg)=>{
console.log("Client recv failed:", msg)
})
this.data.tts = tts
},
/**
* 生命周期函数--监听页面初次渲染完成
*/
onReady: function () {
},
/**
* 生命周期函数--监听页面显示
*/
onShow: function () {
},
/**
* 生命周期函数--监听页面隐藏
*/
onHide: function () {
},
/**
* 生命周期函数--监听页面卸载
*/
onUnload: function () {
},
/**
* 页面相关事件处理函数--监听用户下拉动作
*/
onPullDownRefresh: function () {
},
/**
* 页面上拉触底事件的处理函数
*/
onReachBottom: function () {
},
/**
* 用户点击右上角分享
*/
onShareAppMessage: function () {
},
textInput: function(e) {
this.setData({
ttsText:e.detail.value
})
},
onTtsStart: function() {
if (!this.data.ttsText || !this.data.tts) {
console.log("text empty")
wx.showToast({
title: "文本为空",
icon: "error",
duration: 1000,
mask: true
})
return
}
if (this.data.ttsStart) {
wx.showToast({
title: "正在合成请稍候",
icon: "error",
duration: 1000,
mask: true
})
return
} else {
this.data.ttsStart = true
}
console.log("try to synthesis:" + this.data.ttsText)
let save = formatTime(new Date()) + ".wav"
let savePath = wx.env.USER_DATA_PATH + "/" + save
console.log(`save to ${savePath}`)
fs.open({
filePath:savePath,
flag : "a+",
success: async (res)=> {
console.log(`open ${savePath} done`)
this.data.saveFd = res.fd
this.data.saveFile = savePath
let param = this.data.tts.defaultStartParams()
param.text = this.data.ttsText
param.voice = "aixia"
try {
await this.data.tts.start(param)
console.log("tts done")
this.data.ttsStart = false
} catch(e) {
console.log("tts start error:" + e)
}
},
fail: (res)=> {
console.log(`open ${savePath} failed: ${res.errMsg}`)
}
})
}
})