XpaiInterfaceDelegate接口说明

该interface包含了一系列的回调函数,用于Lib在某些情况下触发客户端的一些行为,例如网络链接成功等。客户端应用需要根据实际情况,实现本Interface中的相应函数。

当视频文件上传完毕后,调用该函数。

  • 原型 - (void)didCompleteUpload:(SInt64)ID
  • 参数
    • ID 正在上传的视频streamID
  • 返回
    • 无。

当连接视频服务器成功后,调用本函数。

  • 原型 - (void)didConnectToServer
  • 参数
    • 无
  • 返回
    • 无。

当与服务器之间断开时,调用本函数。

  • 原型 - (void)didDisconnect
  • 参数
    • 无
  • 返回
    • 无。

尝试恢复直播上传失败。发生此回调时，一般在网络断开后，客户端重新连接服务器成功，但由于网络恢复时间较长，超过了设置的续传超时时间而导致直播恢复失败。

  • 原型 - (void)didResumeLiveFail:(int)errorCode`
  • 参数
    • errorCode 续传直播失败错误码，1表示未找到续传直播
  • 返回
    • 无。

尝试恢复直播成功，SDK通过此回调通知网络恢复连接，直接也恢复正常

  • 原型 - (void)didResumeLiveOk`
  • 参数
    • 无
  • 返回
    • 无。

当有数据传输到服务器端后,会调用该函数,该函数主要用于提示用户当前上载数据量。

  • 原型 - (void)didSendToServer:(SInt64)ID sentLen:(UInt64)sentLen currentPoint:(UInt32)currentPoint videoLen:(UInt32)videoLen
  • 参数
    • ID 正在上传的视频streamID
    • sentLen 已发送的数据长度,在4.1.1版本将参数类型改为UInt64
    • currentPoint 当前在上传的视频文件中的指针位置
    • videoLen 视频文件的长度,当视频还在录制过程中时,该长度为0,当录制完成后,该长度为视频文件的实际长度
  • 返回
    • 无。

当视频服务器成功获取到一定数据,生成直播流时,调用本函数,streamID为视频流的唯一标识。

  • 原型 - (void)didStreamIdNotify:(NSString *)streamId
  • 参数
    • streamId 视频流在服务器端的唯一标识
  • 返回
    • 无。

当直播过程中生成视频文件时，视频服务器成功获取到一定数据，生成直播流时，调用本函数，streamID为视频流的唯一标识。

  • 原型 - (void)didStreamIdAndLocalFilePathNotify:(NSString*)streamId localFilePath:(NSString*)path
  • 参数
    • streamId 视频流在服务器端的唯一标识
    • path 本地视频文件全路径
  • 返回
    • 无。

当拍摄照片成功后,调用该函数。

  • 原型 - (void)didTakePhoto:(NSString *)url
  • 参数
    • url 照片的保存地址
  • 返回
    • 无。

其作用类似于didTakePhoto,不过一般用户在拍摄视频时获取当前视频内容截图时回调此函数。

  • 原型 - (void)didTakeSnapshot:(NSString *)url
  • 参数
    • url 照片的保存地址
  • 返回
    • 无。

将照片上传到服务器成功后,调用该函数。

  • 原型 - (void)didUploadPhoto:(NSString *)url fileId:(int)fileId
  • 参数
    • url 照片的地址
    • fileId 照片在服务器端的唯一标识
  • 返回
    • 无。

当收到服务器发送的语音信息时,调用该函数。

  • 原型 - (void)doReceiveAudioMessage:(NSString *)userName msgFile:(NSString *)url
  • 参数
    • userName 发送语音信息的用户名
    • url 服务器发的语音信息会被lib保存为一个本地文件,url就是文件地址
  • 返回
    • 无。

当受到服务器下发的文字信息时,调用该函数。

  • 原型 - (void)doReceiveMessage:(NSString *)userName msg:(NSString *)message
  • 参数
    • userName 发送文字信息的用户名
    • message 服务器端发送来的文字信息
  • 返回
    • 无。

发现网络异常，直播中断，正在尝试重新建立连接以恢复当前直播。

  • 原型 - (void)doTryResumeLive
  • 参数
    • 无
  • 返回
    • 无。

注意，此回调只有在直播状态下，网络断开时才会被回调，在非直播状态下网络发生异常，sdk不会自动重连，也不会发出此回调。

当连接视频服务器失败后,调用本函数。

  • 原型 - (void)failConnectToServer:(int)failCode
  • 参数
    • failCode FAIL_QUERY_VS=1:查询VS服务器地址出错; FAIL_CONNECT_VS=2:无法连接到VS服务器; FAIL_PASSWORD=3:用户名密码认证错误; FAIL_GET_VS=4:获取VS服务器地址出错。
  • 返回
    • 无。