第一次接觸訊飛語音,是因為專案裡需要把一段文字唸出來。它提供的服務很多,這篇先記錄最常用到的語音合成(文字轉語音)流程。
iflyMSC.framework
libz.dylib(Xcode 7.x 為 libz.tbd)
AVFoundation.framework
SystemConfiguration.framework
Foundation.framework
CoreTelephony.framework
AudioToolbox.framework
UIKit.framework
CoreLocation.framework
AddressBook.framework
QuartzCore.framework
CoreGraphics.framework
坦白說清單很長,而且大半在單純做語音合成時用不到。不過考慮到後續可能擴充語音辨識等功能,一次列齊反而省事。
所有服務啟動前,必須先執行 createUtility,且 appid 一定要傳入。
// 設定 log 等級,輸出位置由下面的工作路徑決定 [IFlySetting setLogFile:LVL_ALL]; // 打開 console 輸出的 log 開關 [IFlySetting showLogcat:YES]; // 設定 SDK 工作路徑 NSString *paths = NSSearchPathForDirectoriesInDomains(NSCachesDirectory, NSUserDomainMask, YES)[0]; [IFlySetting setLogFilePath:paths]; // 建立語音配置,appid 為必填,整個生命週期只需執行一次 NSString *initString = [[NSString alloc] initWithFormat:@"appid=%@", APPID_VALUE]; [IFlySpeechUtility createUtility:initString];
合成物件用單例取得,並需要設定代理以接收狀態回呼:
@interface ViewController () <IFlySpeechSynthesizerDelegate>
{
// 實作 IFlySpeechSynthesizerDelegate 以接收合成會話的狀態
IFlySpeechSynthesizer *_iFlySpeechSynthesizer;
}
@end
- (IBAction)read:(UIButton *)sender {
// 1. 建立合成物件
_iFlySpeechSynthesizer = [IFlySpeechSynthesizer sharedInstance];
_iFlySpeechSynthesizer.delegate = self;
// 2. 設定合成參數
// 工作模式:雲端
[_iFlySpeechSynthesizer setParameter:[IFlySpeechConstant TYPE_CLOUD]
forKey:[IFlySpeechConstant ENGINE_TYPE]];
// 音量,範圍 0~100
[_iFlySpeechSynthesizer setParameter:@"50" forKey:[IFlySpeechConstant VOLUME]];
// 語速
[_iFlySpeechSynthesizer setParameter:@"42" forKey:[IFlySpeechConstant SPEED]];
// 發音人,預設 xiaoyan,可選值參閱「合成發音人列表」
[_iFlySpeechSynthesizer setParameter:@"xiaoyan" forKey:[IFlySpeechConstant VOICE_NAME]];
// 合成音檔輸出路徑,設為 nil 或空字串表示不存檔;預設位於 library/cache
[_iFlySpeechSynthesizer setParameter:@"tts.pcm" forKey:[IFlySpeechConstant TTS_AUDIO_PATH]];
// 3. 啟動合成會話
[_iFlySpeechSynthesizer startSpeaking:_world.text];
}
// 合成結束
- (void)onCompleted:(IFlySpeechError *)error {
NSLog(@"結束代理");
}
// 合成開始
- (void)onSpeakBegin {
NSLog(@"合成開始");
}
// 合成緩衝進度
- (void)onBufferProgress:(int)progress message:(NSString *)msg {
NSLog(@"合成緩衝進度");
}
// 合成播放進度
- (void)onSpeakProgress:(int)progress {
NSLog(@"合成播放進度");
}
第一,createUtility 只能呼叫一次,重複呼叫會造成行為異常,建議放在 AppDelegate 啟動流程中。第二,雲端模式需要網路,離線場景要改用本地引擎並提前下載發音人資源。第三,TTS_AUDIO_PATH 若要在背景播放,記得在 AudioSession 中設定適當的 category,否則靜音鍵一打開就沒聲音。