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

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

开发相关

开发准备

支持 iOS 9.0 及以上版本，不支持 bitcode 版本。合成实时流式语音，需要手机能够连接网络（3/4/5G 或 Wi-Fi 网络等）。语音合成 iOS SDK 。服务端 API 文档。

导入 SDK

SDK 文件夹内的 QCloudTTS.framework 即为 SDK，引入 及 即可调用 SDK 相关接口。

接口说明

获得 TTS 合成器实例

//获得实例QCloudTTSEngine *ttsEngine = [QCloudTTSEngine getShareInstance];
//销毁实例[QCloudTTSEngine instanceRelease];

初始化引擎

-(void) engineInit:(TtsMode)mode Delegate:(id _Nonnull) delegate; //TtsMode: 固定填入 TTS_MODE_ONLINE//QCloudTTSEngineDelegate: TTS合成器代理，用于获取合成结果

QCloudTTSEngineDelegate: TTS合成器代理，用于获取合成结果

onSynthesizeData 方法签名说明

onError方法签名说明

示例

-(void) onSynthesizeData:(NSData *_Nullable)data UtteranceId:(NSString *_Nullable)utteranceId Text:(NSString *_Nullable)text EngineType:(NSInteger)type{    // 您可以在这里将音频保存或者送入播放接口播放，可调用播放器入参接口入参}
-(void) onError:(TtsError *_Nullable)error UtteranceId:(NSString *_Nullable)utteranceId Text:(NSString *_Nullable)text{    // 您可以在这里添加错误后处理}

- (void)onOfflineAuthInfo:(QCloudOfflineAuthInfo * _Nonnull)OfflineAuthInfo {    //离在线SDK保留接口，请忽略，如果您后续升级为离线SDK或者离在线SDK，此接口将用于返回授权信息}

合成文本入参接口

示例

//内部有维护队列，可持续添加语句，SDK内将依次合成TtsError error = nil;error = [ttsEngine synthesize:@"今天天气不错".text UtteranceId:@"第1句"];error = [ttsEngine synthesize:@"腾讯云语音合成".text UtteranceId:@"第2句"];error = [ttsEngine synthesize:@"腾讯云AI".text UtteranceId:@"第3句"];error = [ttsEngine synthesize:@"腾讯云".text UtteranceId:nil];
//取消未合成的任务并清空内部队列[ttsEngine cancel];

QCloudTTSEngine配置参数方法

示例

  [ttsEngine setOnlineAuthParam:123 SecretId:@"AK****Hp7" SecretKey:@"D9***c2" Token:nil];  [ttsEngine setOnlineVoiceSpeed:0.0];//配置语速  [ttsEngine setOnlineVoiceType:1001];//配置音色id   [ttsEngine setOnlineVoiceLanguage:1];//配置主语言  [ttsEngine setOnlineVoiceVolume:0];//配置音量  [ttsEngine setTimeoutIntervalForRequest:15 *1000];  [ttsEngine setTimeoutIntervalForResource:30 *1000];

播放接口

初始化播放器

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

//使用SDK中提供的播放器
 QCloudMediaPlayer player = [[QCloudMediaPlayer alloc]init];
//---------QCloudPlayerDelegate---------//播放开始-(void) onTTSPlayStart{    NSLog(@"onTTSPlayStart");}
//队列所有音频播放完成，音频等待中-(void) onTTSPlayWait{    NSLog(@"onTTSPlayWait");}
//恢复播放-(void) onTTSPlayResume{    NSLog(@"onTTSPlayResume");}
//暂停播放-(void) onTTSPlayPause{
    NSLog(@"onTTSPlayPause");}//播放中止-(void)onTTSPlayStop{    NSLog(@"onTTSPlayStop");
}//播放器异常-(void)onTTSPlayError:(QCPlayerError* _Nullable)playError{    NSLog(@"playError.code==%@,playError.massage==%@",@(playError.mCode),playError.message);}
//即将播放播放下一句，即将播放音频对应的句子，以及这句话utteranceId-(void) onTTSPlayNextWithText:(NSString* _Nullable)text UtteranceId:(NSString* _Nullable)utteranceId{    NSLog(@"text==%@,utteranceId==%@",text,utteranceId);}
// 当前播放的字符,当前播放的字符在所在的句子中的下标.// currentWord 当前读到的单个字，是一个估算值不一定准确// currentIdex 当前播放句子中读到文字的下标-(void)onTTSPlayProgressWithCurrentWord:(NSString*_Nullable)currentWord CurrentIndex:(NSInteger)currentIdex{    NSLog(@"CurrentWord==%@,currentIdex==%@",currentWord,@(currentIdex));}


播放器入参

示例

//通过音频数据入参QCPlayerError err = [_player enqueueWithData:data Text:text UtteranceId:utteranceId];
//通过音频文件入参 NSString *str = [self filePathWithName:@"tmp.mp3"]; NSURL * url = [NSURL URLWithString:str];QCPlayerError err = [_player enqueueWithFile:url Text:text UtteranceId:utteranceId];

客户端错误码

服务端错误码

请参考 语音合成 API 文档。

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

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

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

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