API接口#
所有API接口定义均位于SDTerminalSdk.h文件中。1、系统环境初始化,仅需调用一次#
2、系统退出时调用一次反初始化#
3、创建客户端SDK对象#
4、销毁客户端SDK对象#
5、登录服务器#
本API为阻塞式同步登录 接口,登录失败的超时时间较长,请避免在UI线程中调用。若需要异步登录接口,请参考SDTerminal_OnlineAsync,后者即刻返回,并通过回调接口通知外层登录结果。
6、下线服务器#
下线服务器,若此时用户在音视频位置上,将同时从位置上下来(自动调用OffPosition)。
7、请求上传音视频到指定位置#
8、请求从位置上下来#
本接口只能在Online成功后调用。SDTerminal_Offline内部自带本API功能,客户端下线可以不用单独调用本API,直接调用SDTerminal_Offline即可。
9、上传视频数据#
发送视频码流,一次传入一帧带起始码(0x 00 00 00 01或0x00 00 01)的码流。
10、上传音频数据#
发送音频码流,一次传一帧ADTS码流。内部将校验ADTS头合法性。
11、设置音视频下行掩码#
12、设置音视频传输参数#
13、获取当前SDK版本信息#
14、获取当前丢包率数据#
15、获取当前视频通道的实时RTT#
设置回调接口#
内部状态、接收的远端音视频数据均通过回调函数的方式交给外层,SDK提供了相关的回调函数设置接口。1、通知型回调函数中应尽可能快的退出,不进行耗时操作。
2、数据型回调函数中允许进行解码处理
1、设置系统状态通知回调#
2、设置视频数据接收回调#
SDK内部是在独立于网络接收线程之外的线程中调用本接口,所以外层可以将一定耗时的操作(比如解码)放置在此。
3、设置音频数据接收回调#
SDK内部 是在独立于网络接收线程之外的线程中调用本接口,所以外层可以将一定耗时的操作(比如解码)放置在此。
4、设置远端请求IDR通知回调#
注意SDK内部是在网络接收线程中调用本回调,因此外层不应在回调中执行耗时操作,应尽快返回。
5、设置码率自适应通知回调#
注意SDK内部是在网络接收线程中调用本回调,因此外层不应在回调中执行耗时操作,应尽快返回。