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

宏定义
#define	TgVdpSendReq(handle, cmd, data, size)
	发送请求

#define	TgVdpSendResp(handle, cmd, data, size)
	发送应答

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

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

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

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

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

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

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

TG_PUBLIC int	TgVdpCallEx (struct CalleeEx callees, int size, int timeout, TGVDPCALLBACK cb, const char whoami, uint32_t uCallFlags)
	呼叫.

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

TG_PUBLIC int	TgVdpAccept2 ()
	被叫接听, 等同于 TciAcceptInCall2().

TG_PUBLIC int	TgVdpReject2 ()
	被叫拒接, 等同于 TciRejectInCall2().

TG_PUBLIC int	TgVdpSend (void handle, int cmd, const void data, size_t size)
	发送请求或应答.

TG_PUBLIC int	TgVdpSendRespStatus (void *handle, int cmd, int status)
	发送状态应答.

呼叫标志.

#define	TVC_F_SHOW_CALLER 0x00000001
	允许设备端被叫(CALLTYPE_TANGE)接听前看到主叫的视频. 门口机呼叫室内机时可以打开此选项。

#define	TVC_F_PULL_HIRES 0x00000002
	从设备端被叫(CALLTYPE_TANGE)拉取高清码流

#define	TVC_F_PUSH_HIRES 0x00000004
	向设备端被叫(CALLTYPE_TANGE)推送高清码流

详细描述

结构体说明

◆ CalleeEx

struct CalleeEx

被叫

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

成员变量
int	type	被叫类型 CALLTYPE_TANGE 或 CALLTYPE_WEIXIN 或 CALLTYPE_EVENT
char *	token	被叫标识. CALLTYPE_WEIXIN: 为微信用户的 open id CALLTYPE_TANGE: 设备的连接token CALLTYPE_EVENT: 如果为NULL, 呼叫全部App用户; 如果非空，则为指定App用户的 user id
void *	hConn	该值为输出参数. 呼叫被接听后(收到 TVCS_ACCEPTED), hConn为与对端的连接句柄，可以调用TgVdpSend()来发送数据。该返回值也可能为NULL, 表示无法与对端进行音视频之外的通信。仅当 type 为 CALLTYPE_TANGE 或 CALLTYPE_EVENT, hConn 才会非NULL.
RTMSGCALLBACK	msg_cb	弃用 *从rev.349起统一通过命令处理回调接收, 不再需要此回调* 本回调用于接收对端的音视频之外的数据. type = CALLTYPE_TANGE, 用于接收对端通过 TciSendRtMsg(.., RTM_USER, ...) 发过来的 RTM_USER 消息 type = CALLTYPE_WEIXIN, 不支持
int	err	该值为输出参数. 当status = TVCS_FAILED 时, err 为错误码. 错误码取值同被叫类型有关: 微信呼叫错误范围 -10008, -20~20, 说明在 wx_err.h Tange呼叫错误码在 TgCloudConst.h
void *	pUser	用于向回调中传入用户自己的额外数据

宏定义说明

◆ TVC_F_SHOW_CALLER

#define TVC_F_SHOW_CALLER 0x00000001

允许设备端被叫(CALLTYPE_TANGE)接听前看到主叫的视频. 门口机呼叫室内机时可以打开此选项。

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

◆ TVC_F_PULL_HIRES

#define TVC_F_PULL_HIRES 0x00000002

从设备端被叫(CALLTYPE_TANGE)拉取高清码流

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

◆ TVC_F_PUSH_HIRES

#define TVC_F_PUSH_HIRES 0x00000004

向设备端被叫(CALLTYPE_TANGE)推送高清码流

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

◆ TgVdpSendReq

#define TgVdpSendReq	(	handle,
		cmd,
		data,
		size )

值:

TgVdpSend(handle, (cmd)&0xfffe, data, size)

TgVdpSend

TG_PUBLIC int TgVdpSend(void *handle, int cmd, const void *data, size_t size)

发送请求或应答.

发送请求

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

◆ TgVdpSendResp

#define TgVdpSendResp	(	handle,
		cmd,
		data,
		size )

值:

TgVdpSend(handle, (cmd)|1, data, size)

发送应答

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

类型定义说明

◆ RTMSGCALLBACK

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

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

参数

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

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

◆ TGVDPCALLBACK

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

呼叫/通话状态回调.

参数

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

返回: 未用到, Always return 0

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

枚举类型说明

◆ EVDPCALLSTATE

enum EVDPCALLSTATE

呼叫/通话状态

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

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

函数说明

◆ TgVdpInit()

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

VDP 初始化.

会调用 TciInit()/TciSetCallback().

参数

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

返回: 0:成功

◆ TgVdpSetCmdHandler()

TG_PUBLIC void TgVdpSetCmdHandler ( TGCMDHANDLER func )

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

对端(只能另一个VDP设备)的请求和应答都通知本回调接收.

参数

func	p2p命令处理回调。

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

◆ TgVdpStart()

TG_PUBLIC int TgVdpStart	(	int	isBound,
		const char *	uuid )

开启VDP 服务.

参数

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

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

◆ TgVdpCallEx()

TG_PUBLIC int TgVdpCallEx	(	struct CalleeEx *	callees,
		int	size,
		int	timeout,
		TGVDPCALLBACK	cb,
		const char *	whoami,
		uint32_t	uCallFlags )

呼叫.

参数

callees	被叫对象数组.
size	数组大小
timeout	等待时间。单位: 秒. 建议此处传0，然后主被叫都通过能力 CallTime 设置一个相同的超时值, 以保持行为一致。– 2025/6/5
cb	状态回调
whoami	呼叫者标识, 内容自定义。
uCallFlags	0 或呼叫标志的组合

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

注解: 被叫对象数组中可以有多个CALLTYPE_TANGE型，其它最多一个.
每一次成功的呼叫要调用一次 TgVdpHangup();

◆ TgVdpHangup()

TG_PUBLIC int TgVdpHangup ( )

结束呼叫或通话.

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

返回: 0

注解: 不要在回调里调用

◆ TgVdpAccept2()

TG_PUBLIC int TgVdpAccept2 ( )

被叫接听, 等同于 TciAcceptInCall2().

注解: 不要在回调里调用.

◆ TgVdpReject2()

TG_PUBLIC int TgVdpReject2 ( )

被叫拒接, 等同于 TciRejectInCall2().

注解: 不要在回调里调用

◆ TgVdpSend()

TG_PUBLIC int TgVdpSend	(	void *	handle,
		int	cmd,
		const void *	data,
		size_t	size )

发送请求或应答.

只能对设备发送，目前不支持对小程序发送数据。

参数

handle	连接句柄. 来自不同地方, 见下面注释
cmd	命令码。用户可用命令范围为0x9000~0xffff 请求的命令码最低位为0 应答的命令码为请求命令码最低位置1。
data	请求或应答的数据
size	数据长度

注解

连接句柄handle的获取规则如下:

对主叫端, 当呼叫被接听时, 连接句柄为TVCS_ACCEPTED 状态回调的 struct CalleeEx::handle.
对被叫端, 连接句柄为呼入回调(STATUS_INCALL2)的参数 INCALLINFO::tg::ptr
对主叫和被叫, 如果不是要主动发送请求, 可以从命令处理回调(TGCMDHANDLER)的第一个参数获取

不要使用 TciSendCmdXxxx 接口来发送 !

◆ TgVdpSendRespStatus()

TG_PUBLIC int TgVdpSendRespStatus	(	void *	handle,
		int	cmd,
		int	status )

发送状态应答.

参数

status	TCI_OK 或 TCI_E_xxx, 参见通用错误码
handle	参见 TgVdpSend()
cmd	请求命令

结构体

宏定义

类型定义

枚举

函数

呼叫标志.

详细描述

结构体说明

◆ CalleeEx

宏定义说明

◆ TVC_F_SHOW_CALLER

◆ TVC_F_PULL_HIRES

◆ TVC_F_PUSH_HIRES

◆ TgVdpSendReq

◆ TgVdpSendResp

类型定义说明

◆ RTMSGCALLBACK

◆ TGVDPCALLBACK

枚举类型说明

◆ EVDPCALLSTATE

函数说明

◆ TgVdpInit()

◆ TgVdpSetCmdHandler()

◆ TgVdpStart()

◆ TgVdpCallEx()

◆ TgVdpHangup()

◆ TgVdpAccept2()

◆ TgVdpReject2()

◆ TgVdpSend()

◆ TgVdpSendRespStatus()