setAudioAlignmentProperty abstract method

Future<int?> setAudioAlignmentProperty({
  1. required RemoteStreamKey streamKey,
  2. required AudioAlignmentMode mode,
})

在听众端，设置订阅的所有远端音频流精准对齐后播放

streamKey：作为对齐基准的远端音频流。
一般选择主唱的音频流。
你必须在收到 RTCRoomEventHandler.onUserPublishStream，确认此音频流已发布后，调用此 API。

mode：是否对齐，默认不对齐。

返回值：

  • 0：调用成功；
  • <0：调用失败，具体原因参看 ReturnStatus。

注意：

  • 你必须在实时合唱场景下使用此功能。在加入房间时，所有人应设置 RoomProfile 为 chorus。
  • 订阅的所有远端流必须通过 RTCMediaPlayer.start 开启了背景音乐混音，并将 AudioMixingConfig 中的 syncProgressToRecordFrame 设置为 true。
  • 如果订阅的某个音频流延迟过大，可能无法实现精准对齐。
  • 合唱的参与者不应调用此 API，因为调用此 API 会增加延迟。如果希望从听众变为合唱参与者，应关闭对齐功能。

Implementation

Future<int?> setAudioAlignmentProperty({
  required RemoteStreamKey streamKey,
  required AudioAlignmentMode mode,
});