SDK回调概览

云机回调(SessionObserver)

接口名称	接口描述
onConnected	网络连接成功
onDisconnected	网络断开连接
onClose	网络远端关闭
onScreenChange	收到云机宽、高、角度变化回调
onClipboardMessage	收到云机实列返回的剪贴板数据回调
onFirstVideoFrame	启动云手机实列，订阅到视频流后的视频首帧回调
onLocalScreenshot	调用screenshot(true)后的视频帧回调
onNetworkQuality	当前网络状态回调
onIdeTimeout	当前云手机实列无操作超时回调
onError	当前云手机错误回调
onCameraChanged	当前云手机摄像头状态回调

视频帧回调(VideoRenderSink)

接口名称	接口描述
onFrame	视频帧回调

批量拉流回调(BatchControlObserver)

接口名称	接口描述
onBatchPodStartResult	批量拉流结果回调
onError	批量拉流错误回调

视频帧(VideoFrame)

接口名称	接口描述
width	视频帧宽度，单位PX
height	视频帧高度，单位px
rotation	视频帧旋转角度（0度、90度、180度、270度）
buffer	视频帧数据
size	视频帧大小

云机回调(SessionObserver)

接口名称	接口描述
onConnected	网络连接成功
onDisconnected	网络断开连接
onClose	网络远端关闭
onScreenChange	收到云机宽、高、角度变化回调
onClipboardMessage	收到云机实列返回的剪贴板数据回调
onFirstVideoFrame	启动云手机实列，订阅到视频流后的视频首帧回调
onLocalScreenshot	调用screenshot(true)后的视频帧回调
onNetworkQuality	当前网络状态回调
onIdeTimeout	当前云手机实列无操作超时回调
onError	当前云手机错误回调
onCameraChanged	当前云手机摄像头状态回调

视频帧回调(VideoRenderSink)

接口名称	接口描述
onFrame	视频帧回调

批量拉流回调(BatchControlObserver)

接口名称	接口描述
onBatchPodStartResult	批量拉流结果回调
onError	批量拉流错误回调

视频帧(VideoFrame)

接口名称	接口描述
width	视频帧宽度，单位PX
height	视频帧高度，单位px
rotation	视频帧旋转角度（0度、90度、180度、270度）
buffer	视频帧数据
size	视频帧大小

SDK回调详细说明

连接成功回调

描述： 网络连接成功

语法：

void onConnected();

断开连接回调

描述： 网络断开连接

语法：

void onDisconnected();

连接关闭回调

描述： 网络远端关闭

语法：

void onClose();

分辨率变化回调

描述： 收到云机宽高变化

语法：

void onScreenChange(int width, int height, int rotation);

参数：

参数名	类型	描述
width	int	云机宽度
height	int	云机高度
rotation	int	云机旋转角度

剪切板回调

描述： 收到云机实例返回的剪贴板数据

语法：

void onClipboardMessage(const std::string& text);

参数：

参数名	类型	描述
text	string	云手机剪贴板文本（UTF-8编码）

视频首帧回调

描述： 启动云手机实例，订阅到视频流后的首帧回调

语法：

void onFirstVideoFrame();

本地截图回调

描述： 调用 screenshot(true) 后的视频帧回调

语法：

void onLocalScreenshot(std::shared_ptr<VideoFrame>& frame);

参数：

参数名	类型	描述
frame	`std::shared_ptr<VideoFrame>`	视频帧数据，参考 VideoFrame

网络状态回调

描述： 当前网络状态回调

语法：

void onNetworkQuality(int rtt);

参数：

参数名	类型	描述
rtt	int	网络延迟（ms）

空闲超时回调

描述： 当前云手机实例无操作超时

语法：

void onIdeTimeout();

云机错误回调

描述： 云手机实例错误回调

语法：

void onError(int error, const std::string& msg);

参数：

参数名	类型	描述
error	int	错误码
msg	string	错误描述

摄像头状态回调

描述： 云手机摄像头状态变化回调

语法：

void onCameraChanged(bool isFront, bool isOpen);

参数：

参数名	类型	描述
isFront	bool	是否前置摄像头
isOpen	bool	是否打开

视频帧回调

描述： 实时视频帧回调

语法：

void onFrame(std::shared_ptr<VideoFrame>& frame);

参数：

参数名	类型	描述
frame	`std::shared_ptr<VideoFrame>`	视频帧数据，参考 VideoFrame

批量拉流结果回调

描述： 批量拉流启动结果回调

语法：

void onBatchPodStartResult(int error, const std::string& msg, const std::vector<std::string>& podList);

参数：

参数名	类型	描述
error	int	批量拉流结果
msg	string	批量拉流错误信息
podList	std::vectorstd::string	批量拉流的云机列表

批量拉流错误回调

描述： 批量拉流过程中的错误回调

语法：

void onError(int error, const std::string& msg);

参数：

参数名	类型	描述
error	int	批量拉流结果
msg	string	批量拉流错误信息

VideoFrame 接口

视频帧宽度

描述： 获取视频帧宽度（单位：像素）

语法：

uint32_t width();

视频帧高度

描述： 获取视频帧高度（单位：像素）

语法：

uint32_t height();

视频帧旋转角度

描述： 获取视频帧旋转角度（0°、90°、180°、270°）

语法：

uint32_t rotation();

视频帧数据

描述： 获取视频帧原始数据指针

语法：

uint8_t* buffer();

视频帧大小

描述： 获取视频帧数据大小（字节数）

语法：

// 注意：原内容中未提供完整语法，推测为
uint32_t size();