播放进度回调

SDK 支持细粒度的播放进度回调。开发者可以在收到 SETtsPlaybackProgress 状态回调时，解析附加的 data 字段，获得播放进度（单位：百分比），格式如下：

{
    "progress": 0.3,
    "reqid": "bb081d44-0671-4789-8df5-0050edae517b",
}

准确性

SDK 返回的播放进度是当句已播放的音频长度除以该句音频的总长度：

• 如果正在播放的句子已经合成结束，那么它的总长度是准确的，计算出的播放进度也是准确的；
• 如果正在播放的句子正在合成，即边合成边播放的情况，该句的总长度为算法预估值，与真实值有一定偏差，据其得出的播放进度也不完全准确；
• 分句策略会影响预估的准确性；

综上，如果开发者想要获得准确的播放进度，建议根据标点(;!?。！？；…)对文本进行分割，分句提前合成进行缓存。该策略下，已完成合成的句子，后续的播放进度为准确值。

SDK 支持鉴权证书下载功能，因为没有必要每次初始化都重新下载证书，所以下载只可能在以下几种情况才会触发：

1. 指定的目录不存在证书文件；
2. 证书文件损坏；
3. 证书过期；
4. 该证书可授权的功能中不包含当前申请的功能（只使用语音合成能力的客户不存在这种情况）；

如果需要语音合成 SDK 在后台播报，就可能遇到其他应用使用播放器或录音机的场景。针对这几种情况，我们推荐开发者参考下面的示例代码进行处理，篇幅有限故仅展示核心代码，完整样例程序可参考 Demo 源码。以下示例代码实现了几种效果：

• 其他应用 需要录音 ：开始录音，语音合成播报暂停；录音结束，语音合成播报恢复；
• 其他应用 需要播放（微信消息） ：开始播放，语音合成播报暂停；播放结束，语音合成播报恢复；
• 其他应用 播放音乐（QQ 音乐） ：开始播放歌曲，语音合成播报暂停；停止播放歌曲，语音合成播报不再恢复；

通过接收音频终端通知来完成相应的处理：

- (void)addNotification {
  [[NSNotificationCenter defaultCenter] addObserver:self
                       selector:@selector(audioInterruptionHandler:)
                         name:AVAudioSessionInterruptionNotification
                        object:nil];
}
- (void)audioInterruptionHandler:(NSNotification*)notification {
  AVAudioSessionInterruptionType interruptionType = (AVAudioSessionInterruptionType)[[notification.userInfo objectForKey:AVAudioSessionInterruptionTypeKey] unsignedIntegerValue];
  AVAudioSessionInterruptionOptions intertuptionOptions = [[notification.userInfo objectForKey:AVAudioSessionInterruptionOptionKey] unsignedIntValue];
  NSLog(@"Receive audio interruption notification, type: %lu, options: %lu.", (unsigned long)interruptionType, (unsigned long)intertuptionOptions);
  if (interruptionType == AVAudioSessionInterruptionTypeBegan) {
    NSLog(@"Audio session interruption began");
    @synchronized (self) {
      int ret = [self.curEngine sendDirective:SEDirectivePausePlayer];
      NSLog(@"Pause player return value: %d", ret);
    }
  } else if (interruptionType == AVAudioSessionInterruptionTypeEnded) {
    @synchronized (self) {
      NSLog(@"Audio session interruption ended");
      if (intertuptionOptions == AVAudioSessionInterruptionOptionShouldResume) {
        AVAudioSession *session = [AVAudioSession sharedInstance];
        AVAudioSessionCategoryOptions cur_options = session.categoryOptions;
        // AudioQueueStart() will return AVAudioSessionErrorCodeCannotInterruptOthers if options didn't contains AVAudioSessionCategoryOptionMixWithOthers
        if (!(cur_options & AVAudioSessionCategoryOptionMixWithOthers)) {
          AVAudioSessionCategoryOptions readyOptions = AVAudioSessionCategoryOptionMixWithOthers | cur_options;
          [session setCategory:AVAudioSessionCategoryPlayback withOptions:readyOptions error:nil];
        }

        int ret = [self.curEngine sendDirective:SEDirectiveResumePlayer];
        NSLog(@"Resume player return value: %d", ret);

        cur_options = session.categoryOptions;
        // Remove AVAudioSessionCategoryOptionMixWithOthers, or the playback will not be interrupted any more
        if (cur_options & AVAudioSessionCategoryOptionMixWithOthers) {
          [session setCategory:AVAudioSessionCategoryPlayback withOptions:((~AVAudioSessionCategoryOptionMixWithOthers) & cur_options) error:nil];
        }
      }
    }
  }
}