AgoraDataStreamConfig Class Reference

Inherits from NSObject
Declared in AgoraObjects.h

Overview

数据流设置。

syncWithAudio ordered SDK 行为
NO NO 接收端接收到数据包后,SDK 立刻触发 receiveStreamMessageFromUid 回调。
YES NO
  • 如果数据包的延迟在音频延迟的范围内,SDK 会在播放音频的同时触发与该音频包同步的 receiveStreamMessageFromUid 回调。
  • 如果某数据包的延迟超出了音频延迟,SDK 会在接收到该数据包时立刻触发 receiveStreamMessageFromUid 回调;此情况会造成音频包和数据包的不同步。
  • NO YES
  • 如果数据包的延迟在 5 秒以内,SDK 会修正数据包的乱序问题。
  • 如果数据包的延迟超出 5 秒,SDK 会丢弃该数据包。
  • YES YES
  • 如果数据包的延迟在音频延迟的范围内,SDK 会修正数据包的乱序问题。
  • 如果数据包的延迟超出音频延迟,SDK 会丢弃该数据包。
  •   ordered

    是否保证接收到的数据按发送的顺序排列。

    @property (assign, nonatomic) BOOL ordered

    Discussion

    • YES: 保证 SDK 按照发送方发送的顺序输出数据包。
    • NO: 不保证 SDK 按照发送方发送的顺序输出数据包。

    当需要数据包立刻到达接收端时,不能将该参数设置为 YES

    Declared In

    AgoraObjects.h

      syncWithAudio

    是否与本地发送的音频流同步。

    @property (assign, nonatomic) BOOL syncWithAudio

    Discussion

    • YES: 数据流与音频流同步。
    • NO: 数据流与音频流不同步。

    设置为与音频同步后,如果数据包的延迟在音频延迟的范围内,SDK 会在播放音频的同时 触发与该音频包同步的 receiveStreamMessageFromUid 回调。 当需要数据包立刻到达接收端时,不能将该参数设置为 YES。声网建议你仅在需要实现特殊场景,例如歌词同步时,设置为与音频同步。

    Declared In

    AgoraObjects.h