腾讯云语音合成Android SDK_AI解决方案_同尘科技

说明当前页面为新版（V2.0.0及以上）SDK 开发文档。新客户可直接按当前文档接入新版 SDK。旧版（V1.5.3版本及以下）开发文档已于2022年9月5日下线。正在使用旧版 SDK 的客户，可前往 控制台 查看开发文档。新版 SDK 在稳定性、功能健全性、接口自由度等方面都有所优化。我们将继续支持旧版（V1.5.3版本及以下）SDK，但建议正在使用旧版 SDK 的客户及时升级到新版，以获取更好的使用体验。Android SDK 支持模拟器。

开发相关

开发准备

支持 Android 4.1 以上版本 API LEVEL 16，支持手机与平板。合成实时流式语音，需要手机能够连接网络（3/4/5G 或 Wi-Fi 网络等）。建议使用最新版本 Android Studio 进行开发。服务端 API 文档。

下载安装 SDK

语音合成 Android SDK。解压后即是示例代码工程，目录 sdk 下的 aar 文件即 SDK 包。用 Android Studio 打开此工程查看语音合成示例代码。

环境配置

添加实时语音识别 SDK aar 包 放在 libs 目录下，在 App 的 build.gradle 文件中添加以下代码。

 implementation(name: 'libqcloudtts-release', ext: 'aar')

在 AndroidManifest.xml 添加如下权限：

接口说明

获得 TTS 合成器实例

//获得实例TtsController mTtsController = TtsController.getInstance();  
//销毁实例TtsController.release();

初始化引擎

//第二个参数固定传入 TtsMode.ONLINE//TtsResultListener: 合成监听器，用于获取合成结果mTtsController.init(Context context,TtsMode.ONLINE,TtsResultListener listener) 

合成监听器，用于获取合成结果

实例化 TtsResultListener 时，默认需要重写 onSynthesizeData() 和 onError() 方法。
onSynthesizeData()方法签名说明

onError()方法签名说明

示例

TtsResultListener listener = new TtsResultListener() {
    @Override    public void onSynthesizeData(byte[] bytes, String utteranceId, String text, int engineType) {        // 您可以在这里将音频保存或者送入播放接口播放，可调用播放器入参接口入参    }
    @Override    public void onError(TtsError error, String utteranceId, String text) {      // 您可以在这里添加错误后处理    }
    @Override    public void onOfflineAuthInfo(QCloudOfflineAuthInfo offlineAuthInfo) {      //离在线SDK保留接口，请忽略，如果您后续升级为离线SDK或者离在线SDK，此接口将用于返回授权信息   }}

合成文本入参接口

示例

//内部有维护队列，可持续添加语句，SDK内将依次合成TtsError error = null;//当返回的error不为null时，入参失败error = mTtsController.synthesize("今天天气不错","第1句");error = mTtsController.synthesize("腾讯云语音合成","第2句");error = mTtsController.synthesize("腾讯云AI","第3句");error = mTtsController.synthesize("腾讯云AI","第4句");
//取消未合成的任务并清空内部队列mTtsController.cancel();

TtsController 配置参数方法

示例

mTtsController.setSecretId("AKIDs*********LbFHp7");mTtsController.setSecretKey("D9tdAM******Lmxvc2");mTtsController.setOnlineVoiceSpeed(0.0); //配置语速mTtsController.setOnlineVoiceVolume(1.0);//配置音量mTtsController.setOnlineVoiceType(1001); //配置音色id mTtsController.setOnlineVoiceLanguage(1);//配置主语言mTtsController.setOnlineCodec("mp3"); //配置合成格式mTtsController.setConnectTimeout(15 *1000); //连接超时时间mTtsController.setReadTimeout(30 *1000); //读取超时时间

播放接口

初始化播放器

如果 SDK 的内置播放器无法满足您的需求，您也可以使用自己实现的播放器替换。demo 中也额外提供了一份播放器源码，您可以修改播放器逻辑，源代码位于 MediaPlayerDemo.java，与 SDK 内置播放器一致。

//使用SDK中提供的播放器QCloudMediaPlayer mediaPlayer = new QCloudMediaPlayer(new QCloudPlayerCallback() { 
    @Override    public void onTTSPlayStart() {        Log.d(TAG, "开始播放");    }
    @Override    public void onTTSPlayWait() {        Log.d(TAG, "播放完成，等待音频数据");    }
    @Override    public void onTTSPlayResume() {        Log.d(TAG, "恢复播放");    }
    @Override    public void onTTSPlayPause() {        Log.d(TAG, "暂停播放");    }
    @Override    public void onTTSPlayNext(String text, String utteranceId) {        Log.d(TAG, "开始播放: " + utteranceId + "|" + text);    }
    @Override    public void onTTSPlayStop() {        Log.d(TAG, "播放停止，内部队列已清空");    }
    @Override    public void onTTSPlayError(QPlayerError error) {        Log.d(TAG, "播放器发生异常:"+error.getmCode() + ":" + error.getmMessage());    }
    /**     * @param currentWord 当前播放的字符（此为预估值）     * @param currentIndex 当前播放的字符在所在的句子中的下标（此为预估值）     */    @Override    public void onTTSPlayProgress(String currentWord, int currentIndex) {        Log.d(TAG, "onTTSPlayProgress: " + currentWord + "|" + currentIndex);    }});

播放器入参

enqueue()方法签名说明

示例

//通过音频数据入参QPlayerError err = mediaPlayer.enqueue(byte[] bytes,String text,String utteranceId);
//通过音频文件入参QPlayerError err = mediaPlayer.enqueue(File audio,String text,String utteranceId);

暂停、恢复或停止播放

mediaPlayer.PausePlay();mediaPlayer.ResumePlay();mediaPlayer.StopPlay();

客户端错误码

服务端错误码

请参考 语音合成 API 文档。

对解决方案有疑惑？想了解解决方案收费？ 联系解决方案专家

腾讯云限时活动1折起，即将结束： 马上收藏

同尘科技为腾讯云授权服务中心，购买腾讯云享受折上折，更有现金返利:同意关联，立享优惠

阿里云解决方案也看看？： 点击对比阿里云的解决方案