盛大听听中心开发指南——Android语音播报服务软件.docVIP

盛大听听中心开发指南——Android语音播报服务软件 一、概述 二、开发前准备 2.1 申请权限 2.2 导入接口 三、绑定服务 四、接口调用 4.1 朗读 4.2 停止朗读 4.3 停止朗读所有 五、数据结构 5.1 朗读任务类 5.2 广播事件类型 六、使用高级语音设置 七、更多问题 ------------------------------------------- 一、概述 听听中心是一款由盛大语音创新院推出的Android语音播报服务软件，旨在让第三方软件方便的调用语音合成接口，使用盛大语音合成服务。朗读服务无需联网，安全免费无限制。本文定义了盛大Android语音合成接入方法和开放接口，供广大开发者做接入参考。 听听中心作为独立应用，安装后可作为远程服务，其他应用成功绑定后即可调用播报接口。如果想让用户进行一些高级的语音设置，可以调用听听中心的设置Activity进行 男女音选择，音色、音调、音速、音量调节以及播报时间窗口控制。 二、开发前准备 2.1 申请权限 所有开发者需要经过申请方可使用听听中心服务接口，填写《盛大听听中心合作申请表》并成功提交。请注意应用id填写正确，应用id在AndroidManifest.xml里 … 定义。经审核将根据应用id开通接入权限，3个工作日内邮件回复并附接口文件。如有应用id变更请提前邮件tingting@通知，否则会导致无法使用语音服务。 2.2 导入接口 在应用工程里面新建一个名为”com.snda.tts.service”（注意命名拼写要完全一致）的包，将确认邮件里提供的接口文件复制到这个包的下面 三、绑定服务 定义绑定器 private ITtsService mServiceBinder = null; 定义服务监控接口 ServiceConnection mSConnection = new ServiceConnection() { // 重写服务连接上时的回调函数 @Override public void onServiceConnected(ComponentName name, IBinder service) { // 获得绑定器，之后可以用来调用语音接口 mServiceBinder = ITtsService.Stub.asInterface(service); } // 重写服务断开时的回调函数 @Override public void onServiceDisconnected(ComponentName name) { mServiceBinder = null; } }; 绑定服务 context.bindService(new Intent(“com.snda.xxx”), mSConnection, Context.BIND_AUTO_CREATE); 解绑服务 context.unbindService(mSConnection); 1). 建议在应用生命周期内一直绑定，比如主要Activity的OnCreate()中，OnDestroy()时解绑。 2). 服务的绑定需要些许时间，如果这时候用户播报不会成功。可以在onServiceConnected()中监控到绑定成功的信息再允许接受播报行为。 3). 听听中心安装后第一次绑定会进行一些初始化工作，这时调用播报接口会返回错误码，初始化完成会发送广播通知 四、接口调用 4.1 朗读 播放TtsTask中定义的内容，如果当前有其他播放任务，会按先后顺序排队播放。 函数原型 int speak(in TtsTask ttsTask); 参数说明 ttsTask: 定义播放消息内容和调用者名称等，播放的开始和结束时都会按调用者名称发广播通知相应的调用者。高级使用者也可以传入消息内容id等信息，广播中会回传给调用者，用于实现一些复杂逻辑。 返回值 0 为成功，其他值表示调用失败 调用示例 int result; TtsTask task = new TtsTask(); task.content = “听我知世界”; task.caller = “com.xxx.caller”; if (mServiceBinder != null) { try { result = mServiceBinder.speak(task); } catch (RemoteException e) { // 处理异常 } } 4.2 停止朗读 根据调用者名称，停止当前正在读的消息。非该调用者的消息不会停止。 函数原型 int