腾讯云语音合成Android SDK 基础_AI解决方案_同尘科技

说明： 当前页面为 v2.x.x 版本 SDK 开发文档。 离线 SDK 包含在线 SDK 功能，在线部分请参考 v2.x.x 版本在线 SDK 开发文档。

开发相关

开发准备

支持 Android 4.1 以上版本 API LEVEL 16，支持手机与平板。按设备授权方式需要手机能够连接网络（3/4/5G 或 Wi-Fi 网络等）。建议使用 Android Studio 进行开发。

下载安装 SDK

请参考开通授权，根据指引开通并下载 SDK 文件。解压后即是示例代码工程，目录 sdk 下的 aar 文件即 SDK 包。用 Android Studio 打开工程查看语音合成示例代码。

环境配置

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

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

接口说明

获得 TTS 合成器实例

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

初始化引擎

mTtsController.init(Context context,TtsMode mode,TtsResultListener listener) 

TTS 合成器工作模式参数

如果您下载的压缩包为”xxx_offline.zip”，则支持以下三种模式，如果为”xxx_online.zip”，则仅支持在线模式。

在线模式参数配置(不使用则不需要配置)

TtsController 配置参数方法

示例

mTtsController.setAppId(0L);mTtsController.setSecretId("AKIDs*********LbFHp7");mTtsController.setSecretKey("D9tdAM******Lmxvc2");mttsController.setToken(null);mTtsController.setOnlineVoiceSpeed(mVoiceSpeed);mTtsController.setOnlineVoiceVolume(1.0);mTtsController.setOnlineVoiceType(1001);mTtsController.setOnlineVoiceLanguage(1);mTtsController.setOnlineCodec("mp3");mTtsController.setConnectTimeout(15 *1000);mTtsController.setReadTimeout(30 *1000);

离线模式参数配置（不使用则不需要配置）

TtsController 配置参数方法

按设备授权

示例：

String secret_id = "AKID********************9SXO";String secret_key ="f5********************05xa";String lic_key = "AI8********************064";String lic_pk = "hg9********************2BO";mTtsController.setOfflineAuthParamDoOnline(secret_id,secret_key,lic_key,lic_pk);

按应用授权

示例：

String lic = "PLK********************YEoeO1EEUoTDH/R/mk=";String lic_sign = "PoTpR********************g0ucFkOQOU=";String lic_pk = "hg9********************2BO";mTtsController.setOfflineAuthParamDoOffline(lic,lic_sign,lic_pk);

TtsController 配置参数方法

示例：

mTtsController.setOfflineResourceDir("/sdcard/res");mTtsController.setOfflineVoiceSpeed(1.0f);mTtsController.setOfflineVoiceVolume(1.0f);mTtsController.setOfflineVoiceType("pb");

混合模式参数配置(不使用则不需要配置)

混合模式提供一种策略会在离线合成和在线合成之间进行切换。在线模式下根据网络情况会切换自动离线模式（SDK 判断网络较差时会切换），离线模式下每隔一段时间会尝试切回在线模式。

TtsController 授权配置

混合模式需要在线和离线均有授权，授权配置参照在线模式与离线模式的方法（两个都需要配置）。

TtsController 配置参数方法

在线模式配置和离线模式配置会影响混合模式下处于相应状态时合成行为。以下为混合模式特有配置会影响策略的选择：

示例：

[ttsEngine setCheckNetworkIntervalTime:5 * 60];

合成文本入参接口

示例：

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

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

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

onError()方法签名说明

onOfflineAuthInfo()方法签名说明

示例

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) {        // 您可以在这里添加错误后处理        //注：实际业务上判断一下，如果是混合模式下返回在线合成的后端错误码，应当忽略，可不做处理，SDK内会调用离线合成继续工作    }      @Override    public void onOfflineAuthInfo(QCloudOfflineAuthInfo offlineAuthInfo) {          //offlineAuthInfo 返回离线sdk授权信息，包含错误码、到期时间、当前设备ID           //注意，如果使用离线模式，需要收到此回调后再调用合成接口，否则可能会因授权失败导致合成失败！！！   }}

初始化播放器

如果 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);



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

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

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

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