首页 > 文档中心 > App开发 > 技术文档 > Android SDK > APIs 说明

回调接口

Android APIs - 回调接口 | TUTK P2P SDK 开发指南

KY_registerSDKListener

功能描述:
注册IOTC回调。

接口定义

public boolean KY_registerSDKListener(InterfaceCtrl.KY_SDKListener listener);

参数说明

暂无

KY_unRegisterSDKListener

功能描述:
注销IOTC回调。

接口定义

public boolean KY_unRegisterSDKListener(InterfaceCtrl.KY_SDKListener listener);

参数说明

暂无

KY_receiveBindInfo

功能描述:
Nebula绑定结果回调。当调用 KY_nebulaStartBind 进行对讲时，此接口会回调结果。

接口定义

void KY_receiveBindInfo(String uid, String credential, int KYDeviceState, int errorCode);

参数说明

参数	类型	说明
uid	string	当前设备的uid
credential	string	绑定设备产生的credential
KYDeviceState	int	绑定状态
errorCode	int	P2P SDK错误码

KY_DeviceStatus

功能描述:
指定通道的连线状态回调。当调用 KY_Connect 进行连线并出图成功时，此接口会回调结果。

状态码说明:

KY_STATE_CONNECTING = 1: 连接中
KY_STATE_CONNECTED = 2: 已连接
KY_STATE_DISCONNECTED = 3: 已断开
KY_STATE_UNKNOWN_DEVICE = 4: 未知设备
KY_STATE_WRONG_PASSWORD = 5: 密码错误
KY_STATE_TIMEOUT = 6: 超时
KY_STATE_UNSUPPORTED = 7: 不支持
KY_STATE_CONNECT_FAILED = 8: 连接失败
KY_STATE_UNKNOWN_LICENSE = 9: 未知授权
KY_STATE_SLEEP = 10: 设备休眠
KY_STATE_DEVICE_MAX_SESSION = 11: 设备连接数已满
KY_STATE_POOR_NETWORK_SIGNAL = 12: 网络信号差
KY_STATE_WRONG_AUTH_KEY = 13: 认证密钥错误
KY_STATE_SELF_DISCONNECT = 14: 主动断开

KY_UpdateDecodedImage

功能描述:
视频解码画面更新回调。当视频流解码出一帧新图像时调用。

接口定义

void KY_UpdateDecodedImage(String uid, int channel, long timestamp);

参数说明

参数	类型	说明
uid	string	当前设备的uid
channel	int	设备连线的channel，默认为0
timestamp	long	当前数据的时间戳

KY_DecodeVideoFramInfo

功能描述:
视频帧信息回调。提供当前视频流的详细参数。

接口定义

void KY_DecodeVideoFramInfo(String uid, int channel, int connectMode, int videoWidth, int videoHeight, int videoFPS, int bps, int onlineNm, int frameCount, int incompleteFrameCount, boolean isHwDecode, int sessionID, int avChannelIndex, int cmdNum, int cmdReturn);

参数说明

参数	类型	说明
uid	string	当前设备的uid
channel	int	设备连线的channel，默认为0
connectMode	int	连线模式 (-1:NONE, 0:P2P, 1:RELAY, 2:LAN)
videoWidth	int	视频宽
videoHeight	int	视频高
videoFPS	int	帧率 (fps)
bps	int	音视频码率 (bps)
onlineNm	int	在线人数
frameCount	int	接收帧数
incompleteFrameCount	int	丢帧数或不完整帧数
isHwDecode	boolean	是否是硬件解码
sessionID	int	连线返回的session号
avChannelIndex	int	开启通道返回的av通道
cmdNum	int	command指令类型值
cmdReturn	int	command指令返回值

KY_ReceiveFrameData

功能描述:
获取当前设备指定通道解码后的视频帧数据回调。

接口定义

void KY_ReceiveFrameData(String uid, int channel, AVFrame avFrame);

参数说明

参数	类型	说明
uid	string	当前设备的uid
channel	int	设备连线的channel，默认为0
avFrame	AVFrame	包含视频数据（如YUV）和帧信息的对象

KY_ReceiveAudioData

功能描述:
获取当前设备指定通道接收的音频帧裸流数据及帧信息回调。当调用 KY_StartListen 进行监听时，此接口会回调结果。

接口定义

void KY_ReceiveAudioData(String uid, int channel, AVFrame avFrame);

参数说明

参数	类型	说明
uid	string	当前设备的uid
channel	int	设备连线的channel，默认为0
avFrame	AVFrame	包含音频数据（如PCM）和帧信息的对象

KY_DidReceiveIOCtrlWithUid

功能描述:
获取设备回复Command的数据信息回调。当调用 KY_SendIOCtrlToChannel 发送Command时，此接口会回调结果。

接口定义

void KY_DidReceiveIOCtrlWithUid(String uid, int channel, int type, byte[] data, int dataSize);

参数说明

参数	类型	说明
uid	string	当前接收Command的uid
channel	int	设备连线的channel，默认为0
type	int	command指令值
data	byte[]	command对应指令的结构体数据
dataSize	int	command对应指令的结构体数据长度

KY_DidReceiveNebulaCtrlWithUid

功能描述:
获取设备回复Nebula Command的数据信息回调。当调用 KY_nebulaSendData 发送Nebula Command时，此接口会回调结果。

接口定义

void KY_DidReceiveNebulaCtrlWithUid(String uid, int channel, String jsonRequest, String jsonResponse);

参数说明

参数	类型	说明
uid	string	当前接收Command的uid
channel	int	设备连线的channel，默认为0
jsonRequest	string	发送的nebula command指令 (JSON格式)
jsonResponse	string	设备返回的nebula command响应 (JSON格式)

KY_DownloadUploadOutput

功能描述:
文件上传、下载进度回调。
- 连线成功之后，当调用 KY_startDownload 开始文件下载后，回调下载进度。
- 连线成功之后，当调用 KY_startUpload 开始文件上传后，回调上传进度。

接口定义

void KY_DownloadUploadOutput(Camera camera, int channel, String filePath, int progress, int loadType, int p2pCode);

参数说明

参数	类型	说明
camera	Camera	绑定的camera对象
channel	int	通道号
filePath	string	文件完整沙盒路径
progress	int	上传/下载进度 (0-100)
loadType	int	下载或上传类型 (`AVIOCTRLDEFs.FILETransferType_Download` / `AVIOCTRLDEFs.FILETransferType_Upload`)
p2pCode	int	P2P SDK返回值 (0通常表示成功)