Android SDK 基础

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

<uses-permission android:name="android.permission.INTERNET"/>
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />

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

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

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


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

[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 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中提供的播放器
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);
    }
});

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

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