AgoraMediaMetadataDataSource
AgoraMediaMetadataDataSource 协议。
该类包含的所有回调均需要在引擎的关键线程中实现。因此我们建议你在关键线程中避免耗时操作。
metadataMaxSize
请求最大的 metadata 大小。
- (NSInteger)metadataMaxSize;
在成功调用 setMediaMetadataDelegate 完成注册后,SDK 会在发送每一个视频帧时触发一次该回调;你需要在该方法的返回值中指定 metadata 的最大数据大小。
返回值
指定 metadata 中 buffer 的最大数据大小,单位为 Byte,最大值不超过 1024。请确保在该返回值中进行传参。
readyToSendMetadataAtTimestamp
发送端已准备好发送 metadata。
- (NSData * _Nullable)readyToSendMetadataAtTimestamp:(NSTimeInterval)timestamp sourceType:(AgoraVideoSourceType)sourceType;
当 SDK 准备好发送 metadata 时,会触发该回调。
注意: 请确保在该方法中传入的 metadata 大小不超过 metadataMaxSize 中设定的值。
参数
- timestamp
- 时间戳。
- sourceType
- 视频数据类型。详见 AgoraVideoSourceType。
返回值
指定想要发送的 metadata ,格式为 NSData,由如下字段组成:
uid
:发送该 metadata 的远端用户的 ID。size
:metadata 的大小。buffer
:metadata 数据。timeStampMs
:metadata 发送时的 NTP 时间戳(ms)。