用户工具

video_sdk:iossmartdevicefunc

智能硬件接口介绍

1、透传接口

1.1 发送透传数据

原型:

- (UCSTCPTransParentRequest *)sendTransParentData:(UCSTCPTransParentRequest *)request success:(void (^)(UCSTCPTransParentRequest *request))success failure:(void (^)(UCSTCPTransParentRequest *request, UCSError *error))failure;

功能:tcp sdk自定义透传数据

返回:UCSTCPTransParentRequest (返回当前透传数据的请求对象)

备注:自定义透传数据的长度不要超过256字节。

参数:

参数名 类型 约束 说明
request UCSTCPTransParentRequest 必选 请求类对象,详情参考UCSTCPTransParentRequest的定义。
success Block 必选 发送成功后回调
failure Block 必选 发送失败回调,具体失败可以参考error对象

1.2 透传数据回调通知

原型:- (void)didReceiveTransParentData:(UCSTCPTransParent *)objcts;

功能:tcp sdk收到透传数据

返回:无

备注:当收到透传数据的时候,会回调此函数。

参数:

参数名 类型 约束 说明
objcts UCSTCPTransParent 必选 透传数据的实体对象,包含发送者,消息唯一标识,内容等信息。

2、通话媒体流加密接口

2.1 设置通话媒体流加密状态(RTP)

原型:- (BOOL)setRTPEncEnable:(BOOL)enable;

功能:设置rtp包加密控制开关,默认不支持加密

返回:YES 成功,NO失败

备注:用于通话过程中rtp包的加解密(用户自定义加解密方式)。

参数:

参数名 类型 约束 说明
enable BOOL 必选 打开:YES,关闭:NO

2.2 通话媒体流加密代理(RTP)

原型:- (void)encryptCallBack:(char *)inMsg withOutMsg:(char *)outMsg withInLen:(int)inLen withOutLen:(int *)outLen;

功能:通话过程中rtp自定义加密

返回:无

备注:如果rtp加密状态打开,一定要实现此方法内容,否则会造成崩溃现象

参数:

参数名 类型 约束 说明
inMsg char * 必选 未加密前的rtp包内容
outMsg char * 必选 自定义加密后的rtp包内容(用户将加密后的包内容写入该指针中)
inLen int 必选 未加密前rtp包长度
outLen int * 必选 自定义加密后的rtp包长度(用户将加密后的包长度写入该指针中)

2.3 通话媒体流解密代理(RTP)

原型:- (void)decryptCallBack:(char *)inMsg withOutMsg:(char *)outMsg withInLen:(int)inLen withOutLen:(int *)outLen;

功能:通话过程中rtp自定义解密(用户将自己加密的rtp包解密)

返回:无

备注:如果rtp加密状态打开,一定要实现此方法内容,否则会造成崩溃现象

参数:

参数名 类型 约束 说明
inMsg char * 必选 未解密前的rtp包内容
outMsg char * 必选 自定义解密后的rtp包内容(用户将解密后的包内容写入该指针中)
inLen int 必选 未解密前rtp包长度
outLen int * 必选 自定义解密后的rtp包长度(用户将解密后的包长度写入该指针中)

3、音频3a算法接口

3.1 音频AGC增益控制接口

原型:- (BOOL)setAGCPlus:(int)compressionGain targetDbfs:(int)targetDbfs;

功能:设置AGC音效增益

返回:无

备注:建议通话前设置。

参数:

参数名 类型 约束 说明
compressionGain int 必选 自适应语音增益的压缩增益:取值范围: 1- 30,此值越大音量越大;建议值为6 - 12,6为小音量,9为默认音量,12为大音量, 1 - 6 或者 12 - 30 的值需要谨慎使用。
targetDbfs int 必选 自适应语音增益的目标电平: 取值范围:1—15; 此值越小音量越大;建议值为3 - 9,9为小音量,6为默认音量,3为大音量,1 - 3 或者 9 - 15 的值需要谨慎使用。

页面工具