io.agora.rtc.IVideoFrameObserver接口 参考

  • Java

更新时间

IVideoFrameObserve 类。

成员函数说明

onPreEncodeVideoFrame()

int io.agora.rtc.IVideoFrameObserver.onPreEncodeVideoFrame(AgoraVideoFrameObserver agora_video_frame_observer, VideoFrame frame)

每次获取本地视频编码前的视频数据时触发。

成功注册视频数据 observer 后,SDK 会在捕捉到每个视频帧时触发该回调。你可以在回调中获取编码前的视频数据,然后根据场景需要,对视频数据进行处理。

完成处理后,你可以在该回调中,通过 videoFrame 参数传入处理后的视频数据将其发送回 SDK。

该回调获取的视频数据已经过预处理,即裁剪和旋转内容,优化图片。

参数
参数名描述
agora_video_frame_observer

一个 AgoraVideoFrameObserver 对象。

frame

视频帧数据。

表格内容超出当前宽度,可横向滚动查看更多列。

返回值

如果视频前处理失败,是否忽略该帧视频:

  • 0:不忽略。
  • 1:忽略,则该帧数据不再发送回 SDK。

onRenderVideoFrame()

int io.agora.rtc.IVideoFrameObserver.onRenderVideoFrame(AgoraVideoFrameObserver agora_video_frame_observer, String channel_id, int uid, VideoFrame frame)

每次接收到远端用户发送的视频帧时触发。

成功注册视频数据 observer 后,SDK 会在接收到每个视频帧时触发该回调。你可以在回调中获取编码前的视频数据,然后根据场景需要,对视频数据进行后处理。

完成处理后,你可以在该回调中,通过 videoFrame 参数传入处理后的视频数据将其发送回 SDK。

参数
参数名描述
agora_video_frame_observer

一个 AgoraVideoFrameObserver 对象。

channel_id

频道名。

uid

发送该视频帧的远端用户的 ID。

frame

视频帧数据。

表格内容超出当前宽度,可横向滚动查看更多列。

返回值

如果视频后处理失败,是否忽略该帧视频:

  • true:不忽略。
  • false:忽略,则该帧数据不再发送回 SDK。

该接口的文档由以下文件生成:

  • IVideoFrameObserver.java

这个页面有帮助吗?