使用说明

本文档主要介绍微信语音合成接口(Android 版)使用方法,利用 SDK 可以直接完成从录音到网络传输、云端语音识别、结果获取、语音合成等一系列动作。

本文属于入门级文档,旨在帮助开发者快速学习 Android SDK 的使用并应用到自身开发工作。具体 API 可到“资源下载 ”页下载《微信语音SDK(Android版)开发手册》进行查询。

准备工作

第一步 创建移动应用

请到“管理中心”中点击“创建移动应用”,填写相关资料,然后将该应用提交审核,只有审核通过的应用才能进行开发。

申请资料中需要提交应用签名值,可前往“资源下载”页下载签名生成工具。

注册完毕,我们会在 7 个工作日内完成审核工作。 审核通过之后,开放平台将分配给该移动应用全局唯一的AppID

第二步 下载 Android SDK

进入“资源中心”的“资源下载”页下载 Android SDK,压缩包中包括 Demo+SDK+开发文档。其中的 Demo 使用 SDK 的各功能 API;SDK 包括.so 和.jar 文件。

Demo介绍

为了更好的理解微信语音 SDK 的使用,下面将通过一个简单的实例来讲解一下 SDK 各个关键 API 接口的使用。

1. 开发工具

Android 开发工具有很多,开发者可以根据自身的喜好来选择。在讲解本示例的时候,我们将使用 Eclipse 来一步步分析。

2. 工程配置

首先新建一个示例工程,按以下步骤进行配置。

i. 引入.so 文件:如下图,在 libs\armeabi 目录下粘贴 libWXVoice.so 文件。

语音合成界面截图

ii. 引入 jar 包:

在工程属性->Java Build Path->Libraries 中选择“Add External JARs”,选定 wxvoice.jar,确定后返回,完成后的效果如图1所示。

3. AndroidManifest.xml 设置

i. 添加必要的权限支持:

<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE"></uses-permission>
<uses-permission android:name="android.permission.INTERNET"></uses-permission>
<uses-permission android:name="android.permission.ACCESS_WIFI_STATE"></uses-permission>
<uses-permission android:name="android.permission.CHANGE_WIFI_STATE"></uses-permission>
<uses-permission android:name="android.permission.READ_PHONE_STATE"></uses-permission>
<uses-permission android:name="android.permission.RECORD_AUDIO"></uses-permission>
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE"/>

4. 语音合成 Demo

i. 初始化

SpeechSynthesizer.shareInstance().setListener(this);
SpeechSynthesizer.shareInstance().setFormat(0)
SpeechSynthesizer.shareInstance().setVolume(1.0f);
mInitSucc = SpeechSynthesizer.shareInstance().init(this, screKey);
if (mInitSucc != 0) {

oast.makeText(this, "初始化失败",
Toast.LENGTH_SHORT).show()
}

注:setFormat 函数用于设置请求的音频类型 0:mp3, 1:wav, 2:amr;setVolume 函数用于设置返回音频音量的大小, 范围在 0 – 2 之间的浮点数值。

ii. 开始合成

int ret =SpeechSynthesizer.shareInstance().start(mSynWords);
if (0 == ret) {
return;
}
else if (-402 == ret) {
Toast.makeText(this, "ErrorCode = " + ret +"; 文本不能为空", Toast.LENGTH_LONG).show();
}
else if (-403 == ret) {
Toast.makeText(this, "ErrorCode = " + ret +"; 字符数超过1024", Toast.LENGTH_LONG).show();
}
else {
Toast.makeText(this, "ErrorCode = " + ret, Toast.LENGTH_LONG).show();
}

iii. 取消合成

SpeechSynthesizer.shareInstance().cancel()

此接口的如果返回非0值, 则表示cancel过程结束, 否则其状态将通过public void onGetVoiceRecordState(TextSenderState state)回调获取。

iv. 实现 TextSenderListener, 并重写其函数

直接在 Activity 类中实现 TextSenderListener,重写 TextSenderListener 各函数如下所示:

@Override
public void onGetResult(TextSenderResult arg0) {
SpeechSynthesizerResult result = (SpeechSynthesizerResult)arg0;
byte [] speech = result.speech;
}
@Override
public void onGetError(int errorCode) {
// TODO Auto-generated method stub
}
@Override
public void onGetVoiceRecordState(TextSenderState state) {
// TODO Auto-generated method stub
}

v. 释放系统资源

SpeechSynthesizer.shareInstance().destroy();

注:调用此函数,需要确保识别过程或者cancel过程已经结束,否则会出现问题。

vi. Demo 截图

语音合成界面截图

更多内容在“资源下载”页下载SDK+Demo+开发文档。