项目中使用了TTS（语音合成功能）刚开始自己准备使用科大讯飞的TTS SDK 但是公司经过半天调研（省钱）决定使用灵云的SDK。但是灵云的文档和Demo不是很完善而且网上资料很少，避免下次挖坑自己封装了一个TtsManage。
灵云的TTS分为在线模式和本地模式，在线的可以通过修改配置更改发音人，离线模式只能通过在项目中的发音人文件发音。

一、引入SDK和so文件

http://www.hcicloud.com/dev/appendix/evninstall

二、配置Manifest文件

在工程AndroidManifest.xml文件中添加如下权限：

 <!—如果使用录音机API时，需要RECORD_AUDIO权限，否则不需要 --><uses-permission android:name="android.permission.RECORD_AUDIO" /><!—通常需要设置一些sd卡路径（例如日志路径）为可写，因此需要能够写外部存储 --><uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" /><!—以下访问网络的权限均需要打开--><uses-permission android:name="android.permission.INTERNET" /><uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" /><uses-permission android:name="android.permission.ACCESS_WIFI_STATE" /><uses-permission android:name="android.permission.CHANGE_NETWORK_STATE" /><uses-permission android:name="android.permission.READ_PHONE_STATE"/><!—以下访问权限可选--><uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION"/><uses-permission android:name="android.permission.ACCESS_FINE_LOCATION"/>

三、制作本地发音人文件

下载地址

为了便于应用的发布与管理，灵云SDK也支持将本地资源文件随应用安装在内部存储上， 但此种存放方法需要开发者满足以下要求，灵云SDK才能正常访问这些资源文件：

1) 对资源文件进行特殊命名。以本地能力（tts.local.xiaokun）所需要的TTS资源文件为例，以下示例了这种命名规则：

libXiaoKun.voclib.so（在原文件名前加lib前缀与.so后缀）
libLetter_XiaoKun.voclib.so（在原文件名前加lib前缀与.so后缀）

2) 将重新命名过的本地资源文件拷贝到libs根目录下。

3) 在能力初始化时，指定dataPath参数为 /data/data/appname/lib （appname为应用包的名称）

4) 在能力初始化时，指定fileFlag参数为android_so（默认为none）

所有需要的本地资源文件都需要按以上规则进行名字的改动，并拷贝到libs目录下。 通过这种方式，这些资源文件会被打包在APK中，并在安装时，被放在 /data/data/appname/lib 下。 通过指定fileFlag为android_so，灵云SDK就会按照特殊的命名方式来读取这些文件。

把这4个文件拷贝到Lib目标下，我们的环境就算搭建好了！下面开始写代码。
1.配置信息

/*** 灵云配置信息*/
public final class ConfigUtil {/*** 灵云APP_KEY*/public static final String APP_KEY = "005d5493";/*** 开发者密钥*/public static final String DEVELOPER_KEY = "36599a64ff4cb08ffa916544f38c9002";/*** 灵云云服务的接口地址*/public static final String CLOUD_URL = "test.api.hcicloud.com:8888";/*** 需要运行的灵云能力*/// 离线语音合成public static final String CAP_KEY_TTS_LOCAL = "tts.local.synth";// 云端语音合成public static final String CAP_KEY_TTS_CLOUD = "tts.cloud.wangjing";}

2.初始化TTS

import android.content.Context;
import android.os.Environment;
import android.util.Log;
import android.widget.Toast;import com.sinovoice.hcicloudsdk.api.HciCloudSys;
import com.sinovoice.hcicloudsdk.common.AuthExpireTime;
import com.sinovoice.hcicloudsdk.common.HciErrorCode;
import com.sinovoice.hcicloudsdk.common.InitParam;import java.io.File;
import java.text.SimpleDateFormat;
import java.util.Date;
import java.util.Locale;public class TtsUtil {private final String TAG = this.getClass().getSimpleName();private  InitParam initParam;private final boolean isSaveLog=false;public TtsUtil(Context context) {setInitParam(context);checkStatus(context);}public boolean checkStatus(Context context) {// 初始化int errCode = HciCloudSys.hciInit(initParam.getStringConfig(), context);if (errCode != HciErrorCode.HCI_ERR_NONE && errCode != HciErrorCode.HCI_ERR_SYS_ALREADY_INIT) {Toast.makeText(context, "hciInit error: " + HciCloudSys.hciGetErrorInfo(errCode), Toast.LENGTH_SHORT).show();return false;}// 获取授权/更新授权文件 :errCode = checkAuthAndUpdateAuth();if (errCode != HciErrorCode.HCI_ERR_NONE) {// 由于系统已经初始化成功,在结束前需要调用方法hciRelease()进行系统的反初始化Toast.makeText(context, "CheckAuthAndUpdateAuth error: " + HciCloudSys.hciGetErrorInfo(errCode), Toast.LENGTH_SHORT).show();HciCloudSys.hciRelease();return false;}if (isSaveLog) {saveLog(context.getPackageName(), initParam);}return true;}/*** 加载初始化信息** @return 系统初始化参数*/private void setInitParam(Context context) {String authDirPath = context.getFilesDir().getAbsolutePath();// 前置条件：无initParam= new InitParam();// 授权文件所在路径，此项必填initParam.addParam(InitParam.AuthParam.PARAM_KEY_AUTH_PATH, authDirPath);// 是否自动访问云授权,详见 获取授权/更新授权文件处注释initParam.addParam(InitParam.AuthParam.PARAM_KEY_AUTO_CLOUD_AUTH, "no");// 灵云云服务的接口地址，此项必填initParam.addParam(InitParam.AuthParam.PARAM_KEY_CLOUD_URL, ConfigUtil.CLOUD_URL);// 开发者Key，此项必填，由捷通华声提供initParam.addParam(InitParam.AuthParam.PARAM_KEY_DEVELOPER_KEY, ConfigUtil.DEVELOPER_KEY);// 应用Key，此项必填，由捷通华声提供initParam.addParam(InitParam.AuthParam.PARAM_KEY_APP_KEY, ConfigUtil.APP_KEY);}public void saveLog(String packageName, InitParam initparam) {// 配置日志参数String sdcardState = Environment.getExternalStorageState();if (Environment.MEDIA_MOUNTED.equals(sdcardState)) {String sdPath = Environment.getExternalStorageDirectory().getAbsolutePath();String logPath = sdPath + File.separator + "sinovoice" + File.separator + packageName + File.separator + "log" + File.separator;// 日志文件地址File fileDir = new File(logPath);if (!fileDir.exists()) {fileDir.mkdirs();}// 日志的路径，可选，如果不传或者为空则不生成日志initparam.addParam(InitParam.LogParam.PARAM_KEY_LOG_FILE_PATH, logPath);// 日志数目，默认保留多少个日志文件，超过则覆盖最旧的日志initparam.addParam(InitParam.LogParam.PARAM_KEY_LOG_FILE_COUNT, "5");// 日志大小，默认一个日志文件写多大，单位为Kinitparam.addParam(InitParam.LogParam.PARAM_KEY_LOG_FILE_SIZE, "1024");// 日志等级，0=无，1=错误，2=警告，3=信息，4=细节，5=调试，SDK将输出小于等于logLevel的日志信息initparam.addParam(InitParam.LogParam.PARAM_KEY_LOG_LEVEL, "5");}}private int checkAuthAndUpdateAuth() {// 获取系统授权到期时间int initResult;AuthExpireTime objExpireTime = new AuthExpireTime();initResult = HciCloudSys.hciGetAuthExpireTime(objExpireTime);if (initResult == HciErrorCode.HCI_ERR_NONE) {// 显示授权日期,如用户不需要关注该值,此处代码可忽略Date date = new Date(objExpireTime.getExpireTime() * 1000);SimpleDateFormat sdf = new SimpleDateFormat("yyyy-MM-dd", Locale.CHINA);Log.i(TAG, "expire time: " + sdf.format(date));if (objExpireTime.getExpireTime() * 1000 > System.currentTimeMillis()) {// 已经成功获取了授权,并且距离授权到期有充足的时间(>7天)Log.i(TAG, "checkAuth success");return initResult;}}// 获取过期时间失败或者已经过期initResult = HciCloudSys.hciCheckAuth();if (initResult == HciErrorCode.HCI_ERR_NONE) {Log.i(TAG, "checkAuth success");return initResult;} else {Log.e(TAG, "checkAuth failed: " + initResult);return initResult;}}/*** 释放*/public void hciRelease(){HciCloudSys.hciRelease();}
}

3.初始化语音播放

import android.app.Activity;
import android.util.Log;
import android.widget.Toast;import com.sinovoice.hcicloudsdk.android.tts.player.TTSPlayer;
import com.sinovoice.hcicloudsdk.common.asr.AsrInitParam;
import com.sinovoice.hcicloudsdk.common.hwr.HwrInitParam;
import com.sinovoice.hcicloudsdk.common.tts.TtsConfig;
import com.sinovoice.hcicloudsdk.common.tts.TtsInitParam;
import com.sinovoice.hcicloudsdk.player.TTSCommonPlayer;
import com.sinovoice.hcicloudsdk.player.TTSPlayerListener;/*** Created by kqw on 2016/8/12.* 初始化语音合成能力*/
public class TtsPlayUtil {private static final String TAG = "HciUtil";private Activity mActivity;private TTSPlayer mTtsPlayer;public TtsPlayUtil(Activity activity) {mActivity = activity;}/*** 初始化播放器*/public boolean initPlayer(TTSPlayerListener ttsPlayerListener) {// 构造Tts初始化的帮助类的实例TtsInitParam ttsInitParam = new TtsInitParam();// 获取App应用中的lib的路径String dataPath = mActivity.getBaseContext().getFilesDir().getAbsolutePath().replace("files", "lib");Log.e("path",dataPath);ttsInitParam.addParam(TtsInitParam.PARAM_KEY_DATA_PATH, dataPath);// 此处演示初始化的能力为tts.cloud.xiaokun, 用户可以根据自己可用的能力进行设置, 另外,此处可以传入多个能力值,并用;隔开ttsInitParam.addParam(AsrInitParam.PARAM_KEY_INIT_CAP_KEYS, ConfigUtil.CAP_KEY_TTS_LOCAL);// 如果使用本地能力，需要设置本地音库文件路径// 使用lib下的资源文件,需要添加android_so的标记ttsInitParam.addParam(HwrInitParam.PARAM_KEY_FILE_FLAG, HwrInitParam.VALUE_OF_PARAM_FILE_FLAG_ANDROID_SO);mTtsPlayer = new TTSPlayer();// 配置TTS初始化参数mTtsPlayer.init(ttsInitParam.getStringConfig(), ttsPlayerListener);return mTtsPlayer.getPlayerState() == TTSPlayer.PLAYER_STATE_IDLE;}// 云端合成,不启用编码传输(默认encode=none)public void synth(String text) {// 配置播放器的属性。包括：音频格式，音库文件，语音风格，语速等等。详情见文档。TtsConfig ttsConfig = new TtsConfig();// 音频格式ttsConfig.addParam(TtsConfig.BasicConfig.PARAM_KEY_AUDIO_FORMAT, "pcm16k16bit");// 指定语音合成的能力(云端合成,发言人是XiaoKun)ttsConfig.addParam(TtsConfig.SessionConfig.PARAM_KEY_CAP_KEY, ConfigUtil.CAP_KEY_TTS_LOCAL);//ttsConfig.addParam(TtsConfig.BasicConfig.PARAM_KEY_SPEED, "5");// property为私有云能力必选参数，公有云传此参数无效
//        ttsConfig.addParam("property", "cn_xiaokun_common");if (mTtsPlayer.getPlayerState() == TTSCommonPlayer.PLAYER_STATE_PLAYING || mTtsPlayer.getPlayerState() == TTSCommonPlayer.PLAYER_STATE_PAUSE) {mTtsPlayer.stop();}if (mTtsPlayer.getPlayerState() == TTSCommonPlayer.PLAYER_STATE_IDLE) {mTtsPlayer.play(text, ttsConfig.getStringConfig());} else {Toast.makeText(mActivity, "播放器内部状态错误", Toast.LENGTH_SHORT).show();}}/*** 释放*/public void release() {if (null != mTtsPlayer) {mTtsPlayer.release();}}}

5.最后一步在UI进行交换

import android.support.v7.app.AppCompatActivity;
import android.os.Bundle;
import android.text.TextUtils;
import android.view.View;
import android.widget.Button;
import android.widget.EditText;
import android.widget.Toast;import com.sinovoice.hcicloudsdk.player.TTSCommonPlayer;
import com.sinovoice.hcicloudsdk.player.TTSPlayerListener;import net.yeah.liliLearn.utils.TtsPlayUtil;
import net.yeah.liliLearn.utils.TtsUtil;public class MainActivity extends AppCompatActivity implements TTSPlayerListener {private TtsPlayUtil mTtsPlayUtil;private TtsUtil mInitTts;private boolean isInitPlayer;private EditText mInputMsgEdit;private Button mPlayerButton;@Overrideprotected void onCreate(Bundle savedInstanceState) {super.onCreate(savedInstanceState);setContentView(R.layout.activity_main);initView();initTts();}private void initView(){mInputMsgEdit= (EditText) findViewById(R.id.input_msg_edit);mPlayerButton= (Button) findViewById(R.id.player_btn);mPlayerButton.setOnClickListener(new View.OnClickListener() {@Overridepublic void onClick(View view) {synth(mInputMsgEdit.getText().toString());}});}private void initTts(){// 灵云语音工具类mInitTts = new TtsUtil(this);// 语音合成能力工具类mTtsPlayUtil = new TtsPlayUtil(this);// 初始化语音合成isInitPlayer = mTtsPlayUtil.initPlayer(this);}@Overridepublic void onPlayerEventStateChange(TTSCommonPlayer.PlayerEvent playerEvent) {}@Overridepublic void onPlayerEventProgressChange(TTSCommonPlayer.PlayerEvent playerEvent, int i, int i1) {}@Overridepublic void onPlayerEventPlayerError(TTSCommonPlayer.PlayerEvent playerEvent, int i) {}public void synth(String msg) {if (!isInitPlayer) {Toast.makeText(this, "语音播报初始化失败", Toast.LENGTH_SHORT).show();return;}if (TextUtils.isEmpty(msg)) {Toast.makeText(this, "语音播报合成内容为空", Toast.LENGTH_SHORT).show();return;}mTtsPlayUtil.synth(msg);}@Overrideprotected void onDestroy() {super.onDestroy();if (mTtsPlayUtil != null) {mTtsPlayUtil.release();}if (null != mInitTts) {mInitTts.hciRelease();}}
}

打完收工！

Demo地址：https://github.com/liliLearn/TtsManage-master