======智能硬件接口介绍======
=====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 的值需要谨慎使用。 |