startSubtitle method

FutureOr<int> startSubtitle(
  1. ByteRTCSubtitleConfig subtitleConfig
)

@valid since 3.52 @detail api @author qiaoxingwang @brief 识别或翻译房间内所有用户的语音,形成字幕。
调用该方法时,可以在 ByteRTCSubtitleMode{@link #ByteRTCSubtitleMode} 中选择语音识别或翻译模式。如果选择识别模式,语音识别文本会通过 rtcRoom:onSubtitleMessageReceived:{@link #ByteRTCRoomDelegate#rtcRoom:onSubtitleMessageReceived} 事件回调给你;
如果选择翻译模式,你会同时收到两个 rtcRoom:onSubtitleMessageReceived:{@link #ByteRTCRoomDelegate#rtcRoom:onSubtitleMessageReceived} 回调,分别包含字幕原文及字幕译文。
调用该方法后,用户会收到 rtcRoom:onSubtitleStateChanged:errorCode:errorMessage:{@link #ByteRTCRoomDelegate#rtcRoom:onSubtitleStateChanged:errorCode:errorMessage} 回调,通知字幕是否开启。 @param subtitleConfig 字幕配置信息。参看 ByteRTCSubtitleConfig{@link #ByteRTCSubtitleConfig}。 @return - 0: 成功。 - < 0: 失败。查看 ByteRTCReturnStatus{@link #ByteRTCReturnStatus} 获得更多错误说明。 @note - 使用字幕功能前,你需要在 RTC 控制台 开启实时字幕功能。 - 如果你需要使用流式语音识别模式,你应在 语音技术控制台 创建流式语音识别应用。创建时,服务类型应选择 流式语音识别,而非 音视频字幕生成。创建后,在 RTC 控制台 上启动流式语音识别,并填写创建语音技术应用时获取的相关信息,包括:APP ID,Access Token,和 Cluster ID。 - 如果你需要使用实时语音翻译模式,你应开通机器翻译服务,参考 开通服务。完成开通后,在 RTC 控制台 上启用实时语音翻译模式。
* + 此方法需要在进房后调用。 - 如需指定源语言,你需要在调用 joinRoom 接口进房时,通过 extraInfo 参数传入格式为"语种英文名": "语种代号" JSON 字符串,例如设置源语言为英文时,传入 "source_language": "en"。如未指定源语言,SDK 会将系统语种设定为源语言。如果你的系统语种不是中文、英文和日文,此时 SDK 会自动将中文设为源语言。 - 识别模式下,你可以传入 RTC 控制台上预设或自定义的语种英文名和语种代号。识别模式下支持的语言参看识别模式语种支持。 - 翻译模式下,你需要传入机器翻译规定的语种英文名和语种代号。翻译模式下支持的语言及对应的代号参看翻译模式语言支持

Implementation

FutureOr<int> startSubtitle(ByteRTCSubtitleConfig subtitleConfig) async {
  return await nativeCall('startSubtitle:', [subtitleConfig]);
}