手说TTS开发指南 - PDF Free Download

版本时间作者说明 1.0 2010-11-15 张波 1.1 2010-12-27 在 ondestroy 方法 unbindservice 1.2 2010-12-30 1.3 2011-6-12 去掉 TTS 初始化 ; ttsservice.initialize() 方法调用添加接口方法 : void nextnopauseforcall()

目录 1 简介... 1 2 开发准备... 1 2.1 适用平台... 1 2.2 下载... 1 2.3 安装及初始化... 1 3 应用开发... 1 3.1 将客户端包导入工程... 1 3.2 进行代码编写... 1 第 0 页共 6 页

1 简介手说 TTS, 是 Android 平台下的中文语音引擎, 提供了中文文本到语音的转换使用手说 TTS 进行中文文本的朗读, 包括中文简繁体阿拉伯数字英文字母以及一些符号的混读开发人员可以使用手说 TTS 来开发需要中文语音的应用程序, 本手册介绍如何使用手说 TTS 来进行语音开发 2 开发准备 2.1 适用平台手说 TTS 适用于 Android1.5~Android2.2 系统的手机和移动终端 2.2 下载在下面位置 http://shoushuo.com/sstts.html 下载应用安装包 shoushuotts.apk 和客户端开发包 shoushuotts.jar 2.3 安装在 Android 设备上安装下载的 apk 文件点击应用应用图标, 进入 TTS 设置视图进入后聆听范例正常即可开发和部署中文语音应用了 3 应用开发 3.1 将客户端包导入工程将 shoushuotts.jar 导入工程 Build class path 3.2 进行代码编写以下以在一个 Activity 开发为例进行说明第 1 页共 6 页

3.2.1 在 Activity 声明 tts 接口和绑定标志 private ITts ttsservice; private boolean ttsbound; 3.2.2 声明 ServiceConnection private ServiceConnection connection = new ServiceConnection() { public void onserviceconnected(componentname classname, IBinder iservice) { ttsservice = ITts.Stub.asInterface(iservice); ttsbound = true; // 在应用第一个使用 TTS 的地方, 调用下面的 initialize 方法, 比如如果有 // 两个 Activity 都使用手说 TTS, 则第二个 Activity 在此不需要再调用 try { ttsservice.initialize(); catch (RemoteException e) { public void onservicedisconnected(componentname arg0) { ttsservice = null; ttsbound = false; ; 第 2 页共 6 页

注意 ttsservice.initialize() 方法只在第一个使用 TTS 的地方调用一次 3.2.3 处理 bindservice 和 unbindservice 下面在 onstart() 方法 bindservice, 在 ondestroy () 方法 unbindservice 特别注意 shoushuotts 的 Action 为 com.shoushuo.android.tts.intent.action.invoketts protected void onstart() { super.onstart(); if (!ttsbound ) { String actionname = "com.shoushuo.android.tts.intent.action.invoketts"; Intent intent = new Intent(actionName); this.bindservice(intent, connection, Context.BIND_AUTO_CREATE); protected void ondestroy () { if (ttsbound ) { ttsbound = false; this.unbindservice(connection); super. ondestroy (); 第 3 页共 6 页

3.2.4 服务接口方法调用服务绑定后, 可以使用 ttsservice 对服务接口调用来实现所需的语音功能方法描述如下 : public void speak(string text, int queuemode); 朗读文本 text, 文本内容 queuemode, 排队模式,0 或 TextToSpeech.QUEUE_FLUSH 为立即朗读 1 或 TextToSpeech. QUEUE_ADD 为等待前面的读完再读 public boolean isspeaking(); 是否当前正在朗读 public void stop(); 停止朗读 public void playsilence(long duration, int queuemode); 朗读一段时间静音 duration, 静音时间, 单位为毫秒 queuemode, 同前面 speak 方法的 queuemode void nextnopauseforcall(); 下一句朗读时不受来电影响, 一般来电等时间会是手说 TTS 的朗读暂停, 如果再调用 speak 方法前调用此方法, 则下句朗读不受来电影响 public void speaksyllable(string syllacontent, int queuemode); 朗读音节序列, 一个音节的形式为声母 _ 韵母 _ 声调, 音节序列为有空格隔开的多个第 4 页共 6 页

音节 syllacontent, 音节序列字符串 queuemode, 同前面 speak 方法的 queuemode 3.2.5 注册和响应事件 ITtsCallback 为 TTS 服务的一个回调接口, 回调接口的实例可以注册到 TTS 服务, 目前 ITtsCallback 提供了 speakcompleted() 回调方法, 当朗读完成时该回调方法被调用如果需要, 客户程序应该声明回调接口实例并实现该回调方法注意回调方法更新界面要通过 Handler 和 Message 来进行, 不能直接更新界面 private final ITtsCallback mcallback = new ITtsCallback.Stub() { public void speakcompleted() throws RemoteException { ttshandler.sendemptymessage(0); ; private Handler ttshandler = new Handler() { public void handlemessage(message msg) { Toast.makeText(SpeechTest.this, " 我的话说完了 ", Toast.LENGTH_LONG).show(); ; TTS 服务接口提供了回调接口实例的注册和注销的方法, 只有当注册后, 当事件发生后该回调接口实例的回调方法才能被调用下面修改前面的 ServiceConnection, 在 bindservice 后马上注册回调接口实例, 在 unbindservice() 前先注销该实例 private ServiceConnection connection = new ServiceConnection() { public void onserviceconnected(componentname classname, IBinder iservice) { 第 5 页共 6 页

ttsservice = ITts.Stub.asInterface(iservice); try { ttsservice.registercallback(mcallback); catch (RemoteException e) { ttsbound = true; public void onservicedisconnected(componentname arg0) { try { ttsservice.unregistercallback(mcallback); catch (RemoteException e) { ttsservice = null; ttsbound = false; ; 第 6 页共 6 页