初始化与监听

基本控制

高级控制

美颜相关

摄像头相关

音频相关

本地录制

发送SEI消息

插件接口

init

初始化推流

init({params}, function(ret, err))

params

licence:

• 类型: JSON对象
• 描述: (可选项) 许可证信息
• 内部字段:

{
    key: '00e374exxxx60e8cbb',
    url: 'http://licensxxxxiveSDK.licence'
}

• 字段详情:

key:

• 类型: 字符串类型
• 描述: (可选项) 许可证的key

url:

• 类型: 字符串类型
• 描述: (可选项) 许可证的地址

callback

ret:

• 类型: JSON对象
• 内部字段:

{
    status: true 	// 布尔类型, true表示操作成功
}

err:

• 类型: JSON对象
• 内部字段:

{
    code: -911, 	   // 整数类型, 错误码
    msg: '错误描述' 	// 字符串类型, 错误信息
}

代码示例

livePusher.init({
    licence: {
        'url': '00e37xxxxx8cbb',
        'key': 'http://license.vod2.mxxxxxx2eaa1/TXLiveSDK.licence'
    }
}, function(ret, err) {
    if (ret) {
        api.alert({msg: JSON.stringify(ret)});
    } else {
        api.alert({msg: JSON.stringify(err)});
    }
});

可用性

iOS系统，Android系统

可提供的1.0.0及更高版本

setPusherEventListener

设置推流监听

setPusherEventListener({}, function(ret, err))

callback

ret:

• 类型: JSON对象
• 内部字段:

{
    status: true 	// 布尔类型, true表示操作成功
}

回调事件:

{
    eventType: 'onPushBegin'
}

eventType:

• 类型: 字符串类型
• 描述: 推流事件
• 取值范围:
  • onConnectSucc: 已经成功连接到腾讯云推流服务器
  • onPushBegin: 与服务器握手完毕，一切正常，准备开始推流
  • onOpenCameraSucc: 推流器已成功打开摄像头（部分 Android 手机在此过程需要耗时1s - 2s）
  • onErrNetDisconnect: 网络断连，且经三次重连无效，更多重试请自行重启推流
  • onWarnNetBusy: 主播网络差，如果您需要 UI 提示，这个 WARNING 相对比较有用
  • onWarnServerDisconnect: 推流请求被后台拒绝，一般是由于推流地址里的 txSecret 计算错误，或者是推流地址被其他人占用（一个推流 URL 同时只能有一个端推流）

err:

• 类型: JSON对象
• 内部字段:

{
    code: -911, 	   // 整数类型, 错误码
    msg: '错误描述' 	// 字符串类型, 错误信息
}

代码示例

livePusher.setPusherEventListener({}, function(ret, err) {
    if (ret) {
        api.alert({msg: JSON.stringify(ret)});
    } else {
        api.alert({msg: JSON.stringify(err)});
    }
});

可用性

iOS系统，Android系统

可提供的1.0.0及更高版本

#removePusherEventListener

移除推流监听器

removePusherEventListener({}, function(ret, err))

callback

ret:

• 类型: JSON对象
• 内部字段:

{
    status: true 	// 布尔类型, true表示操作成功
}

err:

• 类型: JSON对象
• 内部字段:

{
    code: -911, 	   // 整数类型, 错误码
    msg: '错误信息' 	// 字符串类型, 错误信息
}

示例代码

livePusher.removePusherEventListener({}, function(ret, err) {
    if (ret) {
        api.alert({msg: JSON.stringify(ret)});
    } else {
        api.alert({msg: JSON.stringify(err)});
    }
});

可用性

iOS系统，Android系统

可提供的1.0.0及更高版本

#destroy

销毁

destroy({}, function(ret, err))

callback

ret:

• 类型: JSON对象
• 内部字段:

{
    status: true 	// 布尔类型, true表示操作成功
}

err:

• 类型: JSON对象
• 内部字段:

{
    code: -911, 	   // 整数类型, 错误码
    msg: '错误描述' 	// 字符串类型, 错误信息
}

示例代码

livePusher.destroy({}, function(ret, err) {
    if (ret) {
        api.alert({msg: JSON.stringify(ret)});
    } else {
        api.alert({msg: JSON.stringify(err)});
    }
});

可用性

iOS系统，Android系统

可提供的1.0.0及更高版本

#startPreview

开启摄像头预览

startPreview({params}, function(ret, err))

params

rect:

• 类型: JSON对象
• 描述: (必填项) 预览画面的位置和大小

callback

ret:

• 类型: JSON对象
• 内部字段:

{
    status: true 	// 布尔类型, true表示操作成功
}

err:

• 类型: JSON对象
• 内部字段:

{
    code: -911, 	   // 整数类型, 错误码
    msg: '错误描述' 	// 字符串类型, 错误信息
}

示例代码

livePusher.startPreview({
    rect: {
        x: 0,
        y: 0,
        w: api.winWidth / 2,
        h: api.winHeight / 2
    }
}, function(ret, err) {
    if (ret) {
        api.alert({msg: JSON.stringify(ret)});
    } else {
        api.alert({msg: JSON.stringify(err)});
    }
});

可用性

iOS系统，Android系统

可提供的1.0.0及更高版本

#startPush

摄像头推流

startPush({params}, function(ret, err))

注意: -5 返回码代表 license 校验失败，需要 license 校验通过才能工作。

params

rtmpUrl:

• 类型: 字符串类型
• 描述: (必填项)推流地址

callback

ret:

• 类型: JSON对象
• 内部字段:

{
    status: true 	// 布尔类型, true表示操作成功
}

err:

• 类型: JSON对象
• 内部字段:

{
    code: -911, 	   // 整数类型, 错误码
    msg: '错误描述' 	// 字符串类型, 错误信息
}

• 字段详情:

code:

• 类型: 字符串类型
• 描述: 错误码
• 取值范围:
  • -1: 启动失败;
  • -5: licence校验失败

示例代码

livePusher.startPush({
    rtmpUrl: 'rtmp://xxx.xxxx.xxx/xxx'
}, function(ret, err) {
    if (ret) {
        api.alert({msg: JSON.stringify(ret)});
    } else {
        api.alert({msg: JSON.stringify(err)});
    }
});

可用性

iOS系统，Android系统

可提供的1.0.0及更高版本

#pausePush

暂停摄像头采集并进入垫片推流状态

pausePush({}, function(ret, err))

SDK 会暂时停止摄像头（或屏幕）采集，并使用 TXLivePushConfig.pauseImg 中指定的图片作为替代图像进行推流，也就是所谓的“垫片”。 这项功能常用于 App 被切到后台运行的场景，尤其是在 iOS 系统中，当 App 切到后台以后，操作系统不会再允许该 App 继续使用摄像头。 此时就可以通过调用 pausePush() 进入垫片状态。

对于绝大多数推流服务器而言，如果超过一定时间不推视频数据，服务器会断开当前的推流链接。

注意: 请注意调用顺序：startPush => ( pausePush => resumePush ) => stopPush()，错误的调用顺序会导致 SDK 表现异常。

callback

ret:

• 类型: JSON对象
• 内部字段:

{
    status: true 	// 布尔类型, true表示操作成功
}

err:

• 类型: JSON对象
• 内部字段:

{
    code: -911, 	   // 整数类型, 错误码
    msg: '错误描述' 	// 字符串类型, 错误信息
}

示例代码

livePusher.pausePush({}, function(ret, err) {
    if (ret) {
        api.alert({msg: JSON.stringify(ret)});
    } else {
        api.alert({msg: JSON.stringify(err)});
    }
});

可用性

iOS系统，Android系统

可提供的1.0.0及更高版本

#resumePush

恢复 RTMP 推流

resumePush({}, function(ret, err))

callback

ret:

• 类型: JSON对象
• 内部字段:

{
    status: true 	// 布尔类型, true表示操作成功
}

err:

• 类型: JSON对象
• 内部字段:

{
    code: -911, 	   // 整数类型, 错误码
    msg: '错误描述' 	// 字符串类型, 错误信息
}

示例代码

livePusher.resumePush({}, function(ret, err) {
    if (ret) {
        api.alert({msg: JSON.stringify(ret)});
    } else {
        api.alert({msg: JSON.stringify(err)});
    }
});

可用性

iOS系统，Android系统

可提供的1.0.0及更高版本

#stopPush

停止 RTMP 推流

stopPush({}, function(ret, err))

callback

ret:

• 类型: JSON对象
• 内部字段:

{
    status: true 	// 布尔类型, true表示操作成功
}

err:

• 类型: JSON对象
• 内部字段:

{
    code: -911, 	   // 整数类型, 错误码
    msg: '错误描述' 	// 字符串类型, 错误信息
}

示例代码

livePusher.stopPush({}, function(ret, err) {
    if (ret) {
        api.alert({msg: JSON.stringify(ret)});
    } else {
        api.alert({msg: JSON.stringify(err)});
    }
});

可用性

iOS系统，Android系统

可提供的1.0.0及更高版本

#stopPreview

停止摄像头预览

stopPreview({}, function(ret, err))

callback

ret:

• 类型: JSON对象
• 内部字段:

{
    status: true 	// 布尔类型, true表示操作成功
}

err:

• 类型: JSON对象
• 内部字段:

{
    code: -911, 	   // 整数类型, 错误码
    msg: '错误描述' 	// 字符串类型, 错误信息
}

示例代码

livePusher.stopPreview({}, function(ret, err) {
    if (ret) {
        api.alert({msg: JSON.stringify(ret)});
    } else {
        api.alert({msg: JSON.stringify(err)});
    }
});

可用性

iOS系统，Android系统

可提供的1.0.0及更高版本

#isPushing

查询是否正在推流

isPushing({}, function(ret, err))

callback

ret:

• 类型: JSON对象
• 内部字段:

{
    status: true 	// 布尔类型, true表示操作成功
}

• 字段详情:

isPushing:

• 类型: 布尔类型
• 描述: true表示推流中, false表示没有推流

err:

• 类型: JSON对象
• 内部字段:

{
    code: -911, 	   // 整数类型, 错误码
    msg: '错误信息' 	// 字符串类型, 错误信息
}

示例代码

livePusher.isPushing({}, function(ret, err) {
    if (ret) {
        api.alert({msg: JSON.stringify(ret)});
    } else {
        api.alert({msg: JSON.stringify(err)});
    }
});

可用性

iOS系统

可提供的1.0.0及更高版本

#setVideoQuality

设置视频编码质量

setVideoQuality({params}, function(ret))

推荐设置: 秀场直播mode: 1；adjustBitrate: false。

params

mode:

• 类型: 整数类型
• 描述: (必填项) 画质类型
• 取值范围: 0: 标清 1: 高清 2: 超清 3: 蓝光 4: 连麦场景下的大主播使用 5: 连麦场景下的小主播（连麦的观众）使用

adjustBitrate:

• 类型: 布尔值
• 描述: (非必填) 动态码率开关
• 默认值: false

callback

ret:

• 类型: JSON对象
• 内部字段:

{
    status: true 	// 布尔类型, true表示操作成功
}

err:

• 类型: JSON对象
• 内部字段:

{
    code: -911, 	   // 整数类型, 错误码
    msg: '错误描述' 	// 字符串类型, 错误信息
}

示例代码

livePusher.setVideoQuality({
    mode: 0
}, function(ret, err) {
    if (ret) {
        api.alert({msg: JSON.stringify(ret)});
    } else {
        api.alert({msg: JSON.stringify(err)});
    }
});

可用性

iOS系统，Android系统

可提供的1.0.0及更高版本

#setRenderRotation

设置本地摄像头预览画面的旋转方向

setRenderRotation({params}, function(ret, err))

该接口仅能够改变主播本地预览画面的方向，而不会改变观众端的画面效果。 如果希望改变观众端看到的视频画面的方向，比如原来是540x960，希望变成960x540，则可以通过设置 init() 中的 homeOrientation 来实现。

params

rotation:

• 类型: 整数类型
• 描述: (必填项) 主播端摄像头预览视频的顺时针旋转角度
• 取值范围: 0-3 0: 旋转0度 1: 旋转90度 2: 旋转180度 3: 旋转270度

callback

ret:

• 类型: JSON对象
• 内部字段:

{
    status: true 	// 布尔类型, true表示操作成功
}

err:

• 类型: JSON对象
• 内部字段:

{
    code: -911, 	   // 整数类型, 错误码
    msg: '错误描述' 	// 字符串类型, 错误信息
}

示例代码

livePusher.setRenderRotation({
    rotation: 0
}, function(ret, err) {
    if (ret) {
        api.alert({msg: JSON.stringify(ret)});
    } else {
        api.alert({msg: JSON.stringify(err)});
    }
});

可用性

iOS系统，Android系统

可提供的1.0.0及更高版本

setMirror

设置视频镜像效果

setMirror({params}, function(ret, err))

由于前置摄像头采集的画面是取自手机的观察视角，如果将采集到的画面直接展示给观众，是完全没有问题的。 但如果将采集到的画面也直接显示给主播，则会跟主播照镜子时的体验完全相反，会让主播感觉到很奇怪。 因此，SDK 会默认开启本地摄像头预览画面的镜像效果，让主播直播时跟照镜子时保持一个体验效果。

setMirror 所影响的则是观众端看到的视频效果，如果想要保持观众端看到的效果跟主播端保持一致，需要开启镜像； 如果想要让观众端看到正常的未经处理过的画面（比如主播弹吉他的时候有类似需求），则可以关闭镜像。

params

isMirror:

• 类型: 布尔类型
• 描述: (必填项) true表示播放端看到的是镜像画面；false播放端看到的是非镜像画面

callback

ret:

• 类型: JSON对象
• 内部字段:

{
    status: true 	// 布尔类型, true表示操作成功
}

err:

• 类型: JSON对象
• 内部字段:

{
    code: -911, 	   // 整数类型, 错误码
    msg: '错误信息' 	// 字符串类型, 错误信息
}

示例代码

livePusher.setMirror({
    isMirror: true
}, function(ret, err) {
    if (ret) {
        api.alert({msg: JSON.stringify(ret)});
    } else {
        api.alert({msg: JSON.stringify(err)});
    }
});

可用性

iOS系统，Android系统

可提供的1.0.0及更高版本

#setBeautyStyle

设置美颜（磨皮）算法

SDK 内部集成了两套风格不同的磨皮算法，一套我们取名叫“光滑”，适用于美女秀场，效果比较明显。 另一套我们取名“自然”，磨皮算法更多地保留了面部细节，主观感受上会更加自然。

setBeautyStyle({params}, function(ret, err))

params

mode:

• 类型: 整数类型
• 描述: (必填项) 美颜风格，光滑或者自然，光滑风格磨皮更加明显，适合娱乐场景
• 取值范围:
  • 0: 光滑
  • 1: 自然

callback

ret:

• 类型: JSON对象
• 内部字段:

{
    status: true 	// 布尔类型, true表示操作成功
}

err:

• 类型: JSON对象
• 内部字段:

{
    code: -911, 	   // 整数类型, 错误码
    msg: '错误信息' 	// 字符串类型, 错误信息
}

##代码示例

livePusher.setBeautyStyle({
    mode: 0
}, function(ret, err) {
    if (ret) {
        api.alert({msg: JSON.stringify(ret)});
    } else {
        api.alert({msg: JSON.stringify(err)});
    }
});

可用性

iOS系统，Android系统

可提供的1.0.0及更高版本

#setBeautyLevel

设置美颜级别

setBeautyLevel({params}, function(ret, err))

params

level:

• 类型: 整数类型
• 描述: (必填项) 美颜级别，取值范围0 - 9； 0表示关闭，1 - 9值越大，效果越明显。

callback

ret:

• 类型: JSON对象
• 内部字段:

{
    status: true 	// 布尔类型, true表示操作成功
}

err:

• 类型: JSON对象
• 内部字段:

{
    code: -911, 	   // 整数类型, 错误码
    msg: '错误信息' 	// 字符串类型, 错误信息
}

示例代码

livePusher.setBeautyLevel({
    level: 1
}, function(ret, err) {
    if (ret) {
        api.alert({msg: JSON.stringify(ret)});
    } else {
        api.alert({msg: JSON.stringify(err)});
    }
});

可用性

iOS系统，Android系统

可提供的1.0.0及更高版本

#setWhitenessLevel

设置美白级别

setWhitenessLevel({params}, function(ret, err))

params

mode:

• 类型: 整数类型
• 描述: (必填项) 美白级别，取值范围0 - 9；0表示关闭，1 - 9值越大，效果越明显。

callback

ret:

• 类型: JSON对象
• 内部字段:

{
    status: true 	// 布尔类型, true表示操作成功
}

err:

• 类型: JSON对象
• 内部字段:

{
    code: -911, 	   // 整数类型, 错误码
    msg: '错误描述' 	// 字符串类型, 错误信息
}

示例代码

livePusher.setWhitenessLevel({
    level: 1
}, function(ret, err) {
    if (ret) {
        api.alert({msg: JSON.stringify(ret)});
    } else {
        api.alert({msg: JSON.stringify(err)});
    }
});

可用性

iOS系统，Android系统

可提供的1.0.0及更高版本

#setRuddyLevel

设置红润级别

setRuddyLevel({params}, function(ret, err))

params

level:

• 类型: 整数类型
• 描述: (必填项) 红润级别，取值范围0 - 9；0表示关闭，1 - 9值越大，效果越明显。

callback

ret:

• 类型: JSON对象
• 内部字段:

{
    status: true 	// 布尔类型, true表示操作成功
}

err:

• 类型: JSON对象
• 内部字段:

{
    code: -911, 	   // 整数类型, 错误码
    msg: '错误信息' 	// 字符串类型, 错误信息
}

示例代码

livePusher.setRuddyLevel({
    level: 1
}, function(ret, err) {
    if (ret) {
        api.alert({msg: JSON.stringify(ret)});
    } else {
        api.alert({msg: JSON.stringify(err)});
    }
});

可用性

iOS系统，Android系统

可提供的1.0.0及更高版本

#enableSharpnessEnhancement

设置红润级别

enableSharpnessEnhancement({params}, function(ret, err))

params

enable:

• 类型: 布尔类型
• 描述: (必填项) true表示开启清晰度增强; false表示关闭清晰度增强
• 默认值: true

callback

ret:

• 类型: JSON对象
• 内部字段:

{
    status: true 	// 布尔类型, true表示操作成功
}

err:

• 类型: JSON对象
• 内部字段:

{
    code: -911, 	   // 整数类型, 错误码
    msg: '错误信息' 	// 字符串类型, 错误信息
}

示例代码

livePusher.enableSharpnessEnhancement({
    enable: true
}, function(ret, err) {
    if (ret) {
        api.alert({msg: JSON.stringify(ret)});
    } else {
        api.alert({msg: JSON.stringify(err)});
    }
});

可用性

iOS系统，Android系统

可提供的1.0.0及更高版本

#setFilter

设置指定素材滤镜特效

setFilter({params}, funct ion(ret, err))

params

img:

• 类型: 字符串类型
• 描述: (必填项) 指定素材，即颜色查找表图片。必须使用 png 格式。

callback

ret:

• 类型: JSON对象
• 内部字段:

{
    status: true 	// 布尔类型, true表示操作成功
}

err:

• 类型: JSON对象
• 内部字段:

{
    code: -911, 	   // 整数类型, 错误码
    msg: '错误信息' 	// 字符串类型, 错误信息
}

示例代码

livePusher.setFilter({
    img: '/xxx/xxx/aa.png'
}, function(ret, err) {
    if (ret) {
        api.alert({msg: JSON.stringify(ret)});
    } else {
        api.alert({msg: JSON.stringify(err)});
    }
});

可用性

iOS系统，Android系统

可提供的1.0.0及更高版本

#setFilterStrength

设置滤镜浓度

setFilterStrength({params}, function(ret, err))

在美女秀场等应用场景里，滤镜浓度的要求会比较高，以便更加突显主播的差异。 我们默认的滤镜浓度是0.5，如果您觉得滤镜效果不明显，可以使用下面的接口进行调节。

params

strength:

• 类型: 浮点数类型
• 描述: (必填项) 从0到1，越大滤镜效果越明显。
• 默认值: 0.5

callback

ret:

• 类型: JSON对象
• 内部字段:

{
    status: true 	// 布尔类型, true表示操作成功
}

err:

• 类型: JSON对象
• 内部字段:

{
    code: -911, 	   // 整数类型, 错误码
    msg: '错误信息' 	// 字符串类型, 错误信息
}

示例代码

livePusher.setFilterStrength({
    strength: 0.2
}, function(ret, err) {
    if (ret) {
        api.alert({msg: JSON.stringify(ret)});
    } else {
        api.alert({msg: JSON.stringify(err)});
    }
});

可用性

iOS系统，Android系统

可提供的1.0.0及更高版本

#isFrontCamera

查询当前是否为前置摄像头

isFrontCamera({params}, function(ret, err))

callback

ret:

• 类型: JSON对象
• 内部字段:

{
    status: true, 	// 布尔类型, true表示操作成功
    isFront: true
}

• 字段详情

isFront:

• 类型: 布尔类型
• 描述: true表示前置摄像头; false表示后置摄像头

err:

• 类型: JSON对象
• 内部字段:

{
    code: -911, 	   // 整数类型, 错误码
    msg: '错误信息' 	// 字符串类型, 错误信息
}

示例代码

livePusher.isFrontCamera({}, function(ret, err) {
    if (ret) {
        api.alert({msg: JSON.stringify(ret)});
    } else {
        api.alert({msg: JSON.stringify(err)});
    }
});

可用性

iOS系统

可提供的1.0.0及更高版本

#switchCamera

切换前后摄像头

switchCamera({params})

callback

ret:

• 类型: JSON对象
• 内部字段:

{
    status: true 	// 布尔类型, true表示操作成功
}

err:

• 类型: JSON对象
• 内部字段:

{
    code: -911, 	   // 整数类型, 错误码
    msg: '错误信息' 	// 字符串类型, 错误信息
}

示例代码

livePusher.switchCamera({}, function(ret, err) {
    if (ret) {
        api.alert({msg: JSON.stringify(ret)});
    } else {
        api.alert({msg: JSON.stringify(err)});
    }
});

可用性

iOS系统，Android系统

可提供的1.0.0及更高版本

#toggleTorch

打开后置摄像头旁边的闪关灯

toggleTorch({params}, function(ret, err))

此操作对于前置摄像头是无效的，因为绝大多数手机都没有给前置摄像头配置闪光灯。

params

enable:

• 类型: 布尔类型
• 描述: (必填项) true表示打开; false表示关闭

callback

ret:

• 类型: JSON对象
• 内部字段:

{
    status: true 	// 布尔类型, true表示操作成功
}

err:

• 类型: JSON对象
• 内部字段:

{
    code: -911, 	   // 整数类型, 错误码
    msg: '错误信息' 	// 字符串类型, 错误信息
}

示例代码

livePusher.toggleTorch({
    enable: true
}, function(ret, err) {
    if (ret) {
        api.alert({msg: JSON.stringify(ret)});
    } else {
        api.alert({msg: JSON.stringify(err)});
    }
});

可用性

iOS系统

可提供的1.0.0及更高版本

#getMaxZoom

获取摄像头支持的焦距

getMaxZoom({params}, function(ret, err))

callback

ret:

• 类型: JSON对象
• 内部字段:

{
    status: true 	// 布尔类型, true表示操作成功
    maxZoom: 10
}

• 字段详情:

maxZoom:

• 类型: 整数类型
• 描述: 最大焦距

err:

• 类型: JSON对象
• 内部字段:

{
    code: -911, 	  // 整数类型, 错误码
    msg: '错误信息' 	// 字符串类型, 错误信息
}

示例代码

livePusher.getMaxZoom({}, function(ret, err) {
    if (ret) {
        api.alert({msg: JSON.stringify(ret)});
    } else {
        api.alert({msg: JSON.stringify(err)});
    }
});

可用性

Android系统

可提供的1.0.0及更高版本

#setZoom

调整摄像头的焦距

setZoom({params}, function(ret, err))

注意: 当 distance 为1的时候为最远视角（正常镜头），当为最大值的时候为最近视角（放大镜头），最大值不要超过，超过后画面会模糊不清。

params

distance:

• 类型: 浮点数类型
• 描述: (必填项) 焦距大小，
• 取值范围:
  • iOS: 1 - 5
  • Anroid: 1 - getMaxZoom()
• 默认值: 建议设置为1即可

callback

ret:

• 类型: JSON对象
• 内部字段:

{
    status: true 	// 布尔类型, true表示操作成功
}

err:

• 类型: JSON对象
• 内部字段:

{
    code: -911, 	  // 整数类型, 错误码
    msg: '错误信息' 	// 字符串类型, 错误信息
}

##代码示例

livePusher.setZoom({
    distance: 2
}, function(ret, err) {
    if (ret) {
        api.alert({msg: JSON.stringify(ret)});
    } else {
        api.alert({msg: JSON.stringify(err)});
    }
});

可用性

iOS系统，Android系统

可提供的1.0.0及更高版本

#setFocusPosition

设置手动对焦区域

setFocusPosition({params}, function(ret, err))

SDK 默认使用摄像头自动对焦功能，您也可以通过 init() 中的 touchFocus 选项关闭自动对焦，改用手动对焦。 改用手动对焦之后，需要由主播自己点击摄像头预览画面上的某个区域，来手动指导摄像头对焦。

params

x:

• 类型: 整数类型
• 描述: (必填项) 坐标x

y:

• 类型: 整数类型
• 描述: (必填项) 坐标y

callback

ret:

• 类型: JSON对象
• 内部字段:

{
    status: true 	// 布尔类型, true表示操作成功
}

err:

• 类型: JSON对象
• 内部字段:

{
    code: -911, 	   // 整数类型, 错误码
    msg: '错误信息' 	// 字符串类型, 错误信息
}

示例代码

livePusher.setFocusPosition({
    x: 5,
    y: 5
}, function(ret, err) {
    if (ret) {
        api.alert({msg: JSON.stringify(ret)});
    } else {
        api.alert({msg: JSON.stringify(err)});
    }
});

可用性

iOS系统，Android系统

可提供的1.0.0及更高版本

#setExposureCompensation

调整曝光比例

setExposureCompensation({params}, function(ret, err))

params

value:

• 类型: 浮点类型
• 描述: (必填项) 曝光比例，表示该手机支持最大曝光调整值的比例，取值范围从-1到1。 负数表示调低曝光，-1是最小值。 正数表示调高曝光，1是最大值。 0表示不调整曝光。
• 默认值: 0

callback

ret:

• 类型: JSON对象
• 内部字段:

{
    status: true 	// 布尔类型, true表示操作成功
}

err:

• 类型: JSON对象
• 内部字段:

{
    code: -911, 	// 整数类型, 错误码
    msg: '....' 	// 字符串类型, 错误信息
}

示例代码

livePusher.setExposureCompensation({
    value: 0.2
}, function(ret, err) {
    if (ret) {
        api.alert({msg: JSON.stringify(ret)});
    } else {
        api.alert({msg: JSON.stringify(err)});
    }
});

可用性

iOS系统，Android系统

可提供的1.0.0及更高版本

#setMute

开启静音

setMute({params}, function(ret, err))

开启静音后，SDK 并不会继续采集麦克风的声音，但是会用非常低（5kbps 左右）的码率推送伪静音数据， 这样做的目的是为了兼容 H5 上的 video 标签，并让录制出来的 MP4 文件有更好的兼容性。

params

isMute:

• 类型: 布尔类型
• 描述: (可选项) 是否开启静音，true表示开启; false表示关闭。
• 默认值: false

callback

ret:

• 类型: JSON对象
• 内部字段:

{
    status: true 	// 布尔类型, true表示操作成功
}

err:

• 类型: JSON对象
• 内部字段:

{
    code: -911, 	   // 整数类型, 错误码
    msg: '错误信息' 	// 字符串类型, 错误信息
}

示例代码

livePusher.setMute({
    isMute: true
}, function(ret, err) {
    if (ret) {
        api.alert({msg: JSON.stringify(ret)});
    } else {
        api.alert({msg: JSON.stringify(err)});
    }
});

可用性

iOS系统，Android系统

可提供的1.0.0及更高版本

#enableVoiceEarMonitor

设置耳返

enableVoiceEarMonitor({params}, function(ret))

params

enable:

• 类型: 布尔类型
• 描述: (可选项) true表示开启; false表示关闭
• 默认值: false

callback

ret:

• 类型: JSON对象
• 内部字段:

{
    status: true 	// 布尔类型, true表示操作成功
}

err:

• 类型: JSON对象
• 内部字段:

{
    code: -911, 	   // 整数类型, 错误码
    msg: '错误信息' 	// 字符串类型, 错误信息
}

##示范代码

livePusher.enableVoiceEarMonitor({
    enable: true
}, function(ret, err) {
    if (ret) {
        api.alert({msg: JSON.stringify(ret)});
    } else {
        api.alert({msg: JSON.stringify(err)});
    }
});

可用性

iOS系统，Android系统

可提供的1.0.0及更高版本

#setVoiceReverbType

设置人声的混响效果（KTV、小房间、大会堂、低沉、洪亮...）

setVoiceReverbType({params}, function(ret, err))

注意: 设置的效果在退房后会失效，如果下次进房还需要对应特效，需要调用此接口再次设置。

params

mode:

• 类型: 整数类型
• 描述: (必填项)变声效果
• 取值范围:
  • 0: 关闭混响
  • 1: KTV
  • 2: 小房间
  • 3: 大会堂
  • 4: 低沉
  • 5: 洪亮
  • 6: 金属声
  • 7: 磁性

callback

ret:

• 类型: JSON对象
• 内部字段:

{
    status: true 	// 布尔类型, true表示操作成功
}

err:

• 类型: JSON对象
• 内部字段:

{
    code: -911,    	// 整数类型, 错误码
    msg: '错误信息' 	// 字符串类型, 错误信息
}

示例代码

livePusher.setVoiceReverbType({
    mode: 1
}, function(ret, err) {
    if (ret) {
        api.alert({msg: JSON.stringify(ret)});
    } else {
        api.alert({msg: JSON.stringify(err)});
    }
});

可用性

iOS系统，Android系统

可提供的1.0.0及更高版本

#setVoiceChangerType

停止播放背景音乐

setVoiceChangerType({params}, function(ret, err))

params

mode:

• 类型: 整数类型
• 描述: (必填项)变声效果
• 取值范围:
  • 0: 关闭变声
  • 1: 熊孩子
  • 2: 萝莉
  • 3: 大叔
  • 4: 重金属
  • 5: 感冒
  • 6: 外国人
  • 7: 困兽
  • 8: 死肥仔
  • 9: 强电流
  • 10: 重机械
  • 11: 空灵

callback

ret:

• 类型: JSON对象
• 内部字段:

{
    status: true 	// 布尔类型, true表示操作成功
}

err:

• 类型: JSON对象
• 内部字段:

{
    code: -911, 	   // 整数类型, 错误码
    msg: '错误信息' 	// 字符串类型, 错误信息
}

示例代码

livePusher.setVoiceChangerType({
    mode: 2
}, function(ret, err) {
    if (ret) {
        api.alert({msg: JSON.stringify(ret)});
    } else {
        api.alert({msg: JSON.stringify(err)});
    }
});

可用性

iOS系统，Android系统

可提供的1.0.0及更高版本

#setVoiceCaptureVolume

设置麦克风采集人声的音量

setVoiceCaptureVolume({params}, function(ret))

params

volume:

• 类型: 整数类型
• 描述: (必填项) 音量大小，100为原始音量。
• 取值范围: [0 ~ 150]
• 默认值为: 100

callback

ret:

• 类型: JSON对象
• 内部字段:

{
    status: true 	// 布尔类型, true表示操作成功
}

err:

• 类型: JSON对象
• 内部字段:

{
    code: -911, 	   // 整数类型, 错误码
    msg: '错误信息' 	// 字符串类型, 错误信息
}

示例代码

livePusher.setVoiceCaptureVolume({
    volume: 80
}, function(ret, err) {
    if (ret) {
        api.alert({msg: JSON.stringify(ret)});
    } else {
        api.alert({msg: JSON.stringify(err)});
    }
});

可用性

iOS系统，Android系统

可提供的1.0.0及更高版本

#setMusicListener

设置音乐监听

setMusicListener({params}, function(ret, ret))

params

id:

• 类型: 整数类型
• 描述: (必填项)音乐Id

callback

ret:

• 类型: JSON对象
• 内部字段:

{
    status: true 	// 布尔类型, true表示操作成功
}

err:

• 类型: JSON对象
• 内部字段:

{
    code: -911, 	   // 整数类型, 错误码
    msg: '错误信息' 	// 字符串类型, 错误信息
}

示例代码

livePusher.setMusicListener({
    id: 3
}, function(ret, err) {
    if (ret) {
        api.toast({
            location: 'bottom',
            msg: JSON.stringify(ret)
        });
    } else {
        api.alert({msg: JSON.stringify(err)});
    }
});

可用性

iOS系统，Android系统

可提供的1.0.0及更高版本

#removeMusicListener

移除音乐监听

removeMusicListener({params}, function(ret, err))

params

id:

• 类型: 整数类型
• 描述: (必填项) 音乐Id

callback

ret:

• 类型: JSON对象
• 内部字段:

{
    status: true 	// 布尔类型, true表示操作成功
}

err:

• 类型: JSON对象
• 内部字段:

{
    code: -911, 	   // 整数类型, 错误码
    msg: '错误信息' 	// 字符串类型, 错误信息
}

示例代码

livePusher.removeMusicListener({
    id: 3
}, function(ret, err) {
    if (ret) {
        api.alert({msg: JSON.stringify(ret)});
    } else {
        api.alert({msg: JSON.stringify(err)});
    }
});

可用性

iOS系统，Android系统

可提供的1.0.0及更高版本

#startPlayMusic

开始播放背景音乐

startPlayMusic({params}, function(ret))

params

id:

• 类型: 整数类型
• 描述: (必填项) 音乐Id

path:

• 类型: 字符串类型
• 描述: (必填项) 背景音乐地址

callback

ret:

• 类型: JSON对象
• 内部字段:

{
    status: true 	// 布尔类型, true表示操作成功
}

err:

• 类型: JSON对象
• 内部字段:

{
    code: -911, 	   // 整数类型, 错误码
    msg: '错误信息' 	// 字符串类型, 错误信息
}

示例代码

livePusher.startPlayMusic({
    id: 3,
    path: 'http://bgm-1252xxxxxud.com/keluodiya.mp3'
}, function(ret, err) {
    if (ret) {
        api.alert({msg: JSON.stringify(ret)});
    } else {
        api.alert({msg: JSON.stringify(err)});
    }
});

可用性

iOS系统，Android系统

可提供的1.0.0及更高版本

#stopPlayMusic

停止播放背景音乐

stopPlayMusic({params}, function(ret, err))

params

id:

• 类型: 整数类型
• 描述: (必填项) 音乐Id

callback

ret:

• 类型: JSON对象
• 内部字段:

{
    status: true 	// 布尔类型, true表示操作成功
}

err:

• 类型: JSON对象
• 内部字段:

{
    code: -911,    	// 整数类型, 错误码
    msg: '错误信息' 	// 字符串类型, 错误信息
}

示例代码

livePusher.stopPlayMusic({
    id: 3
}, function(ret, err) {
    if (ret) {
        api.alert({msg: JSON.stringify(ret)});
    } else {
        api.alert({msg: JSON.stringify(err)});
    }
});

可用性

iOS系统，Android系统

可提供的1.0.0及更高版本

#pausePlayMusic

暂停播放背景音乐

pausePlayMusic({params}, function(ret))

params

id:

• 类型: 整数类型
• 描述: (必填项) 音乐Id

callback

ret:

• 类型: JSON对象
• 内部字段:

{
    status: true 	// 布尔类型, true表示操作成功
}

err:

• 类型: JSON对象
• 内部字段:

{
    code: -911, 	   // 整数类型, 错误码
    msg: '错误信息' 	// 字符串类型, 错误信息
}

示例代码

livePusher.pausePlayMusic({
    id: 3
}, function(ret, err) {
    if (ret) {
        api.alert({msg: JSON.stringify(ret)});
    } else {
        api.alert({msg: JSON.stringify(err)});
    }
});

可用性

iOS系统，Android系统

可提供的1.0.0及更高版本

#resumePlayMusic

恢复播放背景音乐

resumePlayMusic({params}, function(ret, err))

params

id:

• 类型: 整数类型
• 描述: (必填项) 音乐Id

callback

ret:

• 类型: JSON对象
• 内部字段:

{
    status: true 	// 布尔类型, true表示操作成功
}

err:

• 类型: JSON对象
• 内部字段:

{
    code: -911, 	   // 整数类型, 错误码
    msg: '错误信息' 	// 字符串类型, 错误信息
}

示例代码

livePusher.resumePlayMusic({
    id: 3
}, function(ret, err) {
    if (ret) {
        api.alert({msg: JSON.stringify(ret)});
    } else {
        api.alert({msg: JSON.stringify(err)});
    }
});

可用性

iOS系统，Android系统

可提供的1.0.0及更高版本

#setMusicPublishVolume

设置背景音乐的远端音量大小，即主播可以通过此接口设置远端观众能听到的背景音乐的音量大小。

setMusicPublishVolume({params}, function(ret, err))

params

id:

• 类型: 整数类型
• 描述: (必填项) 音乐Id

volume:

• 类型: 整数类型
• 描述: (必填项) 音量大小，100为原始音量。
• 取值范围: [0-150]
• 默认值: 100

callback

ret:

• 类型: JSON对象
• 内部字段:

{
    status: true 	// 布尔类型, true表示操作成功
}

err:

• 类型: JSON对象
• 内部字段:

{
    code: -911, 	   // 整数类型, 错误码
    msg: '错误信息' 	// 字符串类型, 错误信息
}

##代码示例

livePusher.setMusicPublishVolume({
    id: 3,
    volume: 100
}, function(ret, err) {
    if (ret) {
        api.alert({msg: JSON.stringify(ret)});
    } else {
        api.alert({msg: JSON.stringify(err)});
    }
});

可用性

iOS系统，Android系统

可提供的1.0.0及更高版本

#setMusicPlayoutVolume

设置背景音乐的本地音量大小，即主播可以通过此接口设置主播自己本地的背景音乐的音量大小。

setMusicPlayoutVolume({params}, function(ret, err))

params

id:

• 类型: 整数类型
• 描述: (必填项)音乐Id

volume:

• 类型: 整数类型
• 描述: (必填项) 音量大小，100为原始音量。
• 取值范围: [0-150]
• 默认值: 100

callback

ret:

• 类型: JSON对象
• 内部字段:

{
    status: true 	// 布尔类型, true表示操作成功
}

err:

• 类型: JSON对象
• 内部字段:

{
    code: -911, 	   // 整数类型, 错误码
    msg: '错误信息' 	// 字符串类型, 错误信息
}

##代码示例

livePusher.setMusicPlayoutVolume({
    id: 3,
    volume: 100
}, function(ret, err) {
    if (ret) {
        api.alert({msg: JSON.stringify(ret)});
    } else {
        api.alert({msg: JSON.stringify(err)});
    }
});

可用性

iOS系统，Android系统

可提供的1.0.0及更高版本

#setAllMusicVolume

设置全局背景音乐的本地和远端音量的大小

setAllMusicVolume({params}, function(ret, err))

params

volume:

• 类型: 整数类型
• 描述: (必填项) 音量大小，100为原始音量。
• 取值范围: [0-150]
• 默认值: 100

callback

ret:

• 类型: JSON对象
• 内部字段:

{
    status: true 	// 布尔类型, true表示操作成功
}

err:

• 类型: JSON对象
• 内部字段:

{
    code: -911, 	   // 整数类型, 错误码
    msg: '错误信息' 	// 字符串类型, 错误信息
}

示例代码

livePusher.setAllMusicVolume({
    volume: 100
}, function(ret, err) {
    if (ret) {
        api.alert({msg: JSON.stringify(ret)});
    } else {
        api.alert({msg: JSON.stringify(err)});
    }
});

可用性

iOS系统，Android系统

可提供的1.0.0及更高版本

#setMusicPitch

调整背景音乐的音调高低

setMusicPitch({params}, function(ret, err))

params

id:

• 类型: 整数类型
• 描述: (必填项) 音乐Id

pitch:

• 类型: 浮点数类型
• 描述: (必填项) 音调
• 取值范围: [-1 ~ 1]
• 默认值: 0.0

callback

ret:

• 类型: JSON对象
• 内部字段:

{
    status: true 	// 布尔类型, true表示操作成功
}

err:

• 类型: JSON对象
• 内部字段:

{
    code: -911, 	   // 整数类型, 错误码
    msg: '错误信息' 	// 字符串类型, 错误信息
}

示例代码

livePusher.setMusicPitch({
    id: 3,
    pitch: 0
}, function(ret, err) {
    if (ret) {
        api.alert({msg: JSON.stringify(ret)});
    } else {
        api.alert({msg: JSON.stringify(err)});
    }
});

可用性

iOS系统，Android系统

可提供的1.0.0及更高版本

#setMusicSpeedRate

调整背景音乐的变速效果

setMusicSpeedRate({params}, function(ret, err))

params

id:

• 类型: 整数类型
• 描述: (必填项) 音乐Id

speedRate:

• 类型: 浮点数类型
• 描述: (必填项) 速度
• 取值范围: [0.5 ~ 2]
• 默认值: 1.0

callback

ret:

• 类型: JSON对象
• 内部字段:

{
    status: true 	// 布尔类型, true表示操作成功
}

err:

• 类型: JSON对象
• 内部字段:

{
    code: -911, 	   // 整数类型, 错误码
    msg: '错误信息' 	// 字符串类型, 错误信息
}

示例代码

livePusher.setMusicSpeedRate({
    id: 3,
    speedRate: 0.5
}, function(ret, err) {
    if (ret) {
        api.alert({msg: JSON.stringify(ret)});
    } else {
        api.alert({msg: JSON.stringify(err)});
    }
});

可用性

iOS系统，Android系统

可提供的1.0.0及更高版本

#getMusicCurrentPosInMS

获取背景音乐当前的播放进度（单位：毫秒）

getMusicCurrentPosInMS({params}, function(ret, err))

params

id:

• 类型: 整数类型
• 描述: (必填项) 音乐Id

callback

ret:

• 类型: JSON对象
• 内部字段:

{
    status: true 	// 布尔类型, true表示操作成功
}

• 字段详情:

  pos:

  • 类型: 整数类型
  • 描述: 当前播放时间，单位：毫秒

err:

• 类型: JSON对象
• 内部字段:

{
    code: -911, 	   // 整数类型, 错误码
    msg: '错误信息' 	// 字符串类型, 错误信息
}

示例代码

livePusher.getMusicCurrentPosInMS({
    id: 3
}, function(ret, err) {
    if (ret) {
        api.alert({msg: JSON.stringify(ret)});
    } else {
        api.alert({msg: JSON.stringify(err)});
    }
});

可用性

iOS系统，Android系统

可提供的1.0.0及更高版本

#seekMusicToPosInMS

设置背景音乐的播放进度（单位：毫秒）

seekMusicToPosInMS({params}, function(ret, err))

params

id:

• 类型: 整数类型
• 描述: (必填项) 音乐Id

pts:

• 类型: 整数类型
• 描述: (必填项) 要跳转的播放进度时间

callback

ret:

• 类型: JSON对象
• 内部字段:

{
    status: true 	// 布尔类型, true表示操作成功
}

err:

• 类型: JSON对象
• 内部字段:

{
    code: -911, 	   // 整数类型, 错误码
    msg: '错误信息' 	// 字符串类型, 错误信息
}

示例代码

livePusher.seekMusicToPosInMS({
    id: id,
    pts: pts
}, function(ret, err) {
    if (ret) {
        api.alert({msg: JSON.stringify(ret)});
    } else {
        api.alert({msg: JSON.stringify(err)});
    }
});

可用性

iOS系统，Android系统

可提供的1.0.0及更高版本

#getMusicDurationInMS

获取景音乐文件的总时长（单位：毫秒）

getMusicDurationInMS({params}, function(ret, err))

params

path:

• 类型: 字符串类型
• 描述: (非必填) 音乐文件路径，如果 path 为空，那么返回当前正在播放的 music 时长

callback

ret:

• 类型: JSON对象
• 内部字段:

{
    status: true // 布尔类型, true表示操作成功
    duration: 11000
}

• 字段详情:

  duration:

  • 类型: 字符串类型
  • 描述: 时长

err:

• 类型: JSON对象
• 内部字段:

{
    code: -911, 	   // 整数类型, 错误码
    msg: '错误信息' 	// 字符串类型, 错误信息
}

示例代码

livePusher.getMusicDurationInMS({
    path: 'http://bgm-xxxxxud.com/keluodiya.mp3'
}, function(ret, err) {
    if (ret) {
        api.alert({msg: JSON.stringify(ret)});
    } else {
        api.alert({msg: JSON.stringify(err)});
    }
});

可用性

iOS系统，Android系统

可提供的1.0.0及更高版本

#enableVolumeEvaluation

启用麦克风采集音量大小评估

enableVolumeEvaluation({params}, function(ret, err))

开启后会在 volumeEvaluationListener 中获取到 SDK 对麦克风采集音量大小值的评估。

params

interval:

• 类型: 整数类型
• 描述: (必填项)决定了 volumeEvaluationListener 回调的触发间隔，单位为ms，最小间隔为100ms，如果小于等于0则会关闭回调，建议设置为300ms。

callback

ret:

• 类型: JSON对象
• 内部字段:

{
    status: true 	// 布尔类型, true表示操作成功
}

err:

• 类型: JSON对象
• 内部字段:

{
    code: -911, 	   // 整数类型, 错误码
    msg: '错误信息' 	// 字符串类型, 错误信息
}

示例代码

livePusher.enableVolumeEvaluation({
    interval: 300
}, function(ret, err) {
    if (ret) {
        api.alert({msg: JSON.stringify(ret)});
    } else {
        api.alert({msg: JSON.stringify(err)});
    }
});

可用性

iOS系统，Android系统

可提供的1.0.0及更高版本

#setVolumeEvaluationListener

设置麦克风采集音量大小回调接口

setVolumeEvaluationListener({params}, function(ret, err))

callback

ret:

• 类型: JSON对象
• 内部字段:

{
    status: true 	// 布尔类型, true表示操作成功
}

{
    eventType: 'onAudioVolumeEvaluation'
    volume: 10
}

• 字段详情:

eventType:

• 类型: 字符串类型
• 描述: 音量回调事件
• 取值范围:
  • onAudioVolumeEvaluation: 麦克风音量事件

volume:

• 类型: 整数类型
• 描述: 音量大小

err:

• 类型: JSON对象
• 内部字段:

{
    code: -911, 	   // 整数类型, 错误码
    msg: '错误信息' 	// 字符串类型, 错误信息
}

示例代码

livePusher.setVolumeEvaluationListener({}, function(ret, err) {
    if (ret) {
        api.alert({msg: JSON.stringify(ret)});
    } else {
        api.alert({msg: JSON.stringify(err)});
    }
});

可用性

iOS系统，Android系统

可提供的1.0.0及更高版本

#removeVolumeEvaluationListener

移除麦克风采集音量大小回调接口

removeVolumeEvaluationListener({params}, function(ret, err))

callback

ret:

• 类型: JSON对象
• 内部字段:

{
    status: true 	// 布尔类型, true表示操作成功
}

err:

• 类型: JSON对象
• 内部字段:

{
    code: -911, 	   // 整数类型, 错误码
    msg: '错误信息' 	// 字符串类型, 错误信息
}

示例代码

livePusher.removeVolumeEvaluationListener({}, function(ret, err) {
    if (ret) {
        api.alert({msg: JSON.stringify(ret)});
    } else {
        api.alert({msg: JSON.stringify(err)});
    }
});

可用性

iOS系统，Android系统

可提供的1.0.0及更高版本

#setRecordListener

设置录制监听

setRecordListener({params}, function(ret, err))

callback

ret:

• 类型: JSON对象
• 内部字段:

{
    status: true 	// 布尔类型, true表示操作成功
}

• 字段详情:

{
    eventType: 'onRecordProgress',
    progress: 1000
    result: {
        ...
    }
}

eventType:

• 类型: 字符串类型
• 描述: 录制事件
• 取值范围:
  • onRecordEvent: 录制事件
  • onRecordProgress: 录制进度
  • onRecordComplete: 录制结束

progress:

• 类型: 整数类型
• 描述: 录制的进度

result:

• 类型: JSON对象
• 描述: 录制结果
• 字段详情:

{
    coverImage: '/xxxx/xxx.png',
    videoPath: '/xxx/xxx/xxx.mp4'
}

coverImage:

• 类型: 字符串类型
• 描述: 录制的封面的路径

videoPath:

• 类型: 字符串类型
• 描述: 录制的视频路径

err:

• 类型: JSON对象
• 内部字段:

{
    code: -911, 	   // 整数类型, 错误码
    msg: '错误信息' 	// 字符串类型, 错误信息
}

示例代码

livePusher.setRecordListener({}, function(ret, err) {
    if (ret) {
        api.alert({msg: JSON.stringify(ret)});
    } else {
        api.alert({msg: JSON.stringify(err)});
    }
});

可用性

iOS系统，Android系统

可提供的1.0.0及更高版本

#removeRecordListener

移除录制监听

removeRecordListener({params}, function(ret, err))

callback

ret:

• 类型: JSON对象
• 内部字段:

{
    status: true 	// 布尔类型, true表示操作成功
}

err:

• 类型: JSON对象
• 内部字段:

{
    code: -911, 	   // 整数类型, 错误码
    msg: '错误信息' 	// 字符串类型, 错误信息
}

示例代码

livePusher.removeRecordListener({}, function(ret, err) {
    if (ret) {
        api.alert({msg: JSON.stringify(ret)});
    } else {
        api.alert({msg: JSON.stringify(err)});
    }
});

可用性

iOS系统，Android系统

可提供的1.0.0及更高版本

#startRecord

开始录制短视频

startRecord({params}, function(ret, err))

注意: 只有启动推流后才能开始录制，非推流状态下启动录制无效。 出于安装包体积的考虑，仅专业版和企业版两个版本的支持该功能，本版本仅定义了接口但并未实现。 录制过程中请勿动态切换分辨率和软硬编，会有很大概率导致生成的视频异常。

params

path:

• 类型: 字符串类型
• 描述: (必填项) 视频录制后存储路径

callback

ret:

• 类型: JSON对象
• 内部字段:

{
    status: true 	// 布尔类型, true表示操作成功
}

err:

• 类型: JSON对象
• 内部字段:

{
    code: -911, 	   // 整数类型, 错误码
    msg: '错误信息' 	// 字符串类型, 错误信息
}

• 字段详情:

code:

• 类型: 整数类型
• 描述: 错误码
• 取值范围:
  • -1：videoPath 为空；
  • -2：上次录制尚未结束，请先调用 stopRecord；
  • -3：推流尚未开始。

示例代码

livePusher.startRecord({
    path: 'fs://tencentLivePusher/record/record.mp4'
}, function(ret, err) {
    if (ret) {
        api.alert({msg: JSON.stringify(ret)});
    } else {
        api.alert({msg: JSON.stringify(err)});
    }
});

可用性

iOS系统，Android系统

可提供的1.0.0及更高版本

#stopRecord

结束录制短视频，当停止推流后，如果视频还在录制中，SDK 内部会自动结束录制。

stopRecord({params}, function(ret, err))

callback

ret:

• 类型: JSON对象
• 内部字段:

{
    status: true 	// 布尔类型, true表示操作成功
}

err:

• 类型: JSON对象
• 内部字段:

{
    code: -911, 	   // 整数类型, 错误码
    msg: '错误信息' 	// 字符串类型, 错误信息
}

• 字段详情:

code:

• 类型: 整数类型
• 描述: 错误码
• 取值范围:
  • 1: 不存在录制任务

示例代码

livePusher.stopRecord({}, function(ret, err) {
    if (ret) {
        api.alert({msg: JSON.stringify(ret)});
    } else {
        api.alert({msg: JSON.stringify(err)});
    }
});

可用性

iOS系统，Android系统

可提供的1.0.0及更高版本

#snapshot

推流过程中本地截图

snapshot({params}, function(ret, err))

params

path:

• 类型: 字符串类型
• 描述: (必填项)截图路径

callback

ret:

• 类型: JSON对象
• 内部字段:

{
    status: true 	// 布尔类型, true表示操作成功
    path: '/xxxxx/xxxx/xxx.png'
}

• 字段详情:

path:

• 类型: 字符串类型
• 描述: 截图的路径

err:

• 类型: JSON对象
• 内部字段:

{
    code: -911, 	   // 整数类型, 错误码
    msg: '错误信息' 	// 字符串类型, 错误信息
}

示例代码

livePusher.snapshot({
    path: 'fs://tencentLivePusher/snapshot/snapshot01.png'
}, function(ret, err) {
    if (ret) {
        api.alert({msg: JSON.stringify(ret)});
    } else {
        api.alert({msg: JSON.stringify(err)});
    }
});

可用性

iOS系统，Android系统

可提供的1.0.0及更高版本

#sendMessageEx

发送 SEI 消息，播放端（TXLivePlayer）通过 onPlayEvent（EVT_PLAY_GET_MESSAGE）来接收该消息。

本接口是将数据直接塞入视频数据头中，因此不能太大（几个字节比较合适），一般常用于塞入自定义时间戳等信息。

sendMessageEx({params}, function(ret, err))

params

msg:

• 类型: 字符串类型
• 描述: (必填项) 发送的消息内容

callback

ret:

• 类型: JSON对象
• 内部字段:

{
    status: true 	// 布尔类型, true表示操作成功
}

err:

• 类型: JSON对象
• 内部字段:

{
    code: -911, 	   // 整数类型, 错误码
    msg: '错误信息' 	// 字符串类型, 错误信息
}

示例代码

livePusher.sendMessageEx({
    msg: 'this is a sei msg'
}, function(ret, err) {
    if (ret) {
        api.alert({msg: JSON.stringify(ret)});
    } else {
        api.alert({msg: JSON.stringify(err)});
    }
});

可用性

iOS系统，Android系统

可提供的1.0.0及更高版本