startSubtitle abstract method

Future<int?> startSubtitle(
  1. SubtitleConfig subtitleConfig
)

v3.54.1 新增。

识别或翻译房间内所有用户的语音，形成字幕。
语音识别或翻译的结果会通过 RTCRoomEventHandler.onSubtitleMessageReceived 事件回调给你。
调用该方法后，你会收到 RTCRoomEventHandler.onSubtitleStateChanged 回调，通知字幕是否开启。

subtitleConfig：字幕配置信息。

返回值：

  • 0：调用成功。
  • !0：调用失败。失败原因参看 ReturnStatus。

注意：

  • 使用字幕功能前，你需要开通机器翻译服务并前往 RTC 控制台，在功能配置页面开启字幕功能。
  • 此方法需要在进房后调用。
  • 如需指定源语言，你需要在调用 joinRoom 接口进房时，通过 extraInfo 参数传入 "source_language": "zh" JSON 字符串，设置源语言为中文；传入 "source_language": "en"JSON 字符串，设置源语言为英文；传入 "source_language": "ja" JSON 字符串，设置源语言为日文。如未指定源语言，SDK 会将系统语种设定为源语言。如果你的系统语种不是中文、英文和日文，此时 SDK 会自动将中文设为源语言。
  • 调用 RTCRoom.stopSubtitle 可以关闭字幕。

Implementation

Future<int?> startSubtitle(SubtitleConfig subtitleConfig);