结构体
struct	CalleeEx
	被叫更多...

类型定义
typedef void(*	RTMSGCALLBACK) (const RTMSG_t msg, int len, struct CalleeEx callee)
	被叫端传过来的命令数据.

typedef int(*	TGVDPCALLBACK) (int status, struct CalleeEx *pCallee)
	呼叫/通话状态回调.

枚举
enum	CALLEETYPE
	呼叫对象类型更多...

enum	EVDPCALLSTATE
	呼叫/通话状态更多...

函数
int	TgVdpInit (const char cfg_path, struct TciCB cbs)
	VDP 初始化.

void	TgVdpSetCmdHandler (TGCMDHANDLER func)
	设置p2p命令处理回调, 代替 TciSetCmdHandler().

int	TgVdpStart (int isBound, const char *uuid)
	开启VDP 服务.

void	TgVdpStop ()
	停止VDP服务, 释放资源会调用 TciStop()/TciCleanup()

int	TgVdpCallEx (struct CalleeEx *callees, int size, int timeout, TGVDPCALLBACK cb)
	呼叫.

int	TgVdpHangup ()
	结束呼叫或通话.

int	TgVdpAccept (struct InCallInfo *)
	被叫接听, 等同于 TciAcceptInCall().

int	TgVdpReject (struct InCallInfo *)
	被叫拒接, 等同于 TciRejectInCall().

详细描述

结构体说明

◆ CalleeEx

struct CalleeEx

被叫

在文件 vdp.h 第 60 行定义.

成员变量
int	type	被叫类型 CALLEETYPE
char *	token	被叫标识
void *	hConn	该值为输出参数. 呼叫被接听后(收到 TVCS_ACCEPTED), hConn为与对端的连接句柄，用于进行更多通信。该返回值也可能为NULL, 表示无法与对端进行音视频之外的通信。 type = CALLEE_TANGE, hConn类型为 HP2PCLT, 可以用来调用 icam_p2p.h 中的接口. type = CALLEE_WEIXIN, hConn = NULL
RTMSGCALLBACK	msg_cb	本回调用于接收对端的音视频之外的数据. type = CALLEE_TANGE, 用于接收对端通过 TciSendRtMsg(.., RTM_USER, ...) 发过来的 RTM_USER 消息 type = CALLEE_WEIXIN, 不支持
int	err	该值为输出参数. 当status = TVCS_FAILED 时, err 为错误码. 错误码取值同被叫类型有关: 微信呼叫错误范围 -10008, -20~20, 说明在 wx_err.h Tange呼叫错误码在 TgCloudConst.h
void *	pUser	用于向回调中传入用户自己的额外数据

类型定义说明

◆ RTMSGCALLBACK

typedef void(* RTMSGCALLBACK) (const RTMSG_t *msg, int len, struct CalleeEx *callee)

被叫端传过来的命令数据.

参数

msg	消息头
len	消息长度
callee	同回调相匹配的 CalleeEx 结构

在文件 vdp.h 第 57 行定义.

◆ TGVDPCALLBACK

typedef int(* TGVDPCALLBACK) (int status, struct CalleeEx *pCallee)

呼叫/通话状态回调.

参数

status	状态 EVDPCALLSTATE
pCallee	status=TVCS_ACCEPTED为被叫指针，其于时候为NULL. 注意，这个指针不同于调用 TgVdpCall()时传入的数组元素的地址，因为那个数组会被复制

返回: 未用到, Always return 0

在文件 vdp.h 第 107 行定义.

枚举类型说明

◆ CALLEETYPE

enum CALLEETYPE

呼叫对象类型

枚举值
CALLEE_TANGE	接入本SDK的设备
CALLEE_WEIXIN	微信小程序

在文件 vdp.h 第 46 行定义.

◆ EVDPCALLSTATE

enum EVDPCALLSTATE

呼叫/通话状态

枚举值
TVCS_CALLING	呼叫中
TVCS_REJECTED	拒接
TVCS_ACCEPTED	接听
TVCS_TIMEDOUT	呼叫超时
TVCS_REMOTE_HANGUP	对端挂断
TVCS_FAILED	呼叫失败

在文件 vdp.h 第 92 行定义.

函数说明

◆ TgVdpInit()

int TgVdpInit	(	const char *	cfg_path,
		struct TciCB *	cbs )

VDP 初始化.

会调用 TciInit()/TciSetCallback().

参数

cfg_path	配置文件保存路径，要可读写
cbs	必需的回调结构

返回: 0:成功

◆ TgVdpSetCmdHandler()

void TgVdpSetCmdHandler ( TGCMDHANDLER func )

设置p2p命令处理回调, 代替 TciSetCmdHandler().

被叫端(室内机)才会通过此回调接收命令。主叫端通过Caller接口(iCamP2pXxxx)发送命令和接收应答.

参数

p2pCmdHandler p2p命令处理回调。

注解: TgVdpInit()会设置一个内部命令处理回调，只把不处理的命令传给本回调.
如果应用很简单，除了音视频外没有额外的交互，可以不提供

◆ TgVdpStart()

int TgVdpStart	(	int	isBound,
		const char *	uuid )

开启VDP 服务.

参数

isBound	设备本地保存的是否绑定的标志。如果为0(没有绑定), 需要走绑定流程
uuid	设备的 UUID

返回: 0:成功; 非0:错误码

◆ TgVdpCallEx()

int TgVdpCallEx	(	struct CalleeEx *	callees,
		int	size,
		int	timeout,
		TGVDPCALLBACK	cb )

呼叫.

参数

callees	被叫对象数组
size	数组大小
timeout	等待时间。单位: 秒
cb	状态回调

返回: 0: 成功发起呼叫. 非0: 错误码。不能发起呼叫

注解: 每一次成功的呼叫要调用一次 TgVdpHangup();

◆ TgVdpHangup()

int TgVdpHangup ( )

结束呼叫或通话.

对主叫端，可以在调用 TgVdpCall()成功后的任何时候调用本接口, 从而实现取消呼叫、结束通话、响应对方挂断的功能.
对被叫端，调用本接口实现通话中挂断的功能, 实际调用了TciHangup().

返回: 0