AgoraMediaMetadataDataSource Protocol Reference

Conforms to NSObject
Declared in AgoraMediaMetadata.h

Overview

AgoraMediaMetadataDataSource 定义

Note: 该类包含的所有回调均需要在引擎的关键线程中实现。因此我们建议你在关键线程中避免耗时操作。

– metadataMaxSize required method

请求媒体附属信息的最大数据大小

- (NSInteger)metadataMaxSize

Return Value

指定附属信息中 buffer （详见 readyToSendMetadataAtTimestamp 中返回值的描述）的大小，单位为 Byte，最大值不超过 1024。请确保在该返回值中进行传参。

Discussion

在成功调用 setMediaMetadataDataSource 方法设置 Metadata Data Source 后，SDK 会触发该回调，你需要在该方法的返回值中设置想要使用的 Metadata 最大数据大小。

SDK 会在使用过程中多次返回该回调，你可以在新的回调中更新附属信息的最大值。

Declared In

AgoraMediaMetadata.h

– readyToSendMetadataAtTimestamp: required method

发送端已准备好发送媒体附属信息

- (NSData *_Nullable)readyToSendMetadataAtTimestamp:(NSTimeInterval)timestamp

Parameters

timestamp

当前附属信息的时间戳，单位为毫秒。

Return Value

指定想要发送的附属信息，格式为 NSData，由如下字段组成：

  • uid：发送该 Metadata 的远端用户的 ID
  • size：发送或收到的 Metadata 的数据大小
  • buffer：发送或收到的 Metadata 数据
  • timeStampMs：该 Metadata 的时间戳

请确保在该返回值中进行传参。

Discussion

当 SDK 准备好接收和发送附属信息数据时，会触发该回调方法；你需要在该方法的返回值中指定想要发送的附属信息。

Note: 请确保用户在该方法中传入的附属信息大小不超过 metadataMaxSize 中设定的值。

Declared In

AgoraMediaMetadata.h