# uni.createLivePusherContext(livePusherId, componentInstance)

创建 live-pusher 上下文 livePusherContext 对象。

平台差异说明

App HarmonyOS Next H5 微信小程序 支付宝小程序 百度小程序 抖音小程序、飞书小程序
见下 x x x x x

参数说明

设置live-pusher组件的推流地址,推流视频模式等。

属性 类型 默认值 必填 说明
url string 推流地址,支持RTMP协议。
mode string 推流视频模式,可取值:SD(标清), HD(高清), FHD(超清)。
muted Boolean false 是否静音。
enable-camera Boolean true 开启摄像头。
auto-focus Boolean true 自动聚集。
beauty Number 0 美颜,取值范围 0-9(iOS取值范围为1) ,0 表示关闭。
whiteness Number 0 美白,取值范围 0-9(iOS取值范围为1) ,0 表示关闭。

注意:

  • app-nvue 平台 2.2.5+ 支持 uni.createLivePusherContext(livePusherId, this)
  • app-nvue 平台 2.2.5- 需要同时设置组件属性id和ref <live-pusher id="livepusher1" ref="livepusher1"></live-pusher>,或者直接使用 ref,例如 this.$refs.livepusher1

# API

# start(callback)

开始推流

# callback 返回 Object 参数说明
属性 类型 说明
type String "success" 表示成功, "fail" 表示失败

# pause(callback)

暂停推流

# callback 返回 Object 参数说明
参数 类型 说明
type String "success" 表示成功, "fail" 表示失败

# resume(callback)

恢复推流

# callback 返回 Object 参数说明
参数 类型 说明
type String "success" 表示成功, "fail" 表示失败

# stop(callback)

停止推流

# callback 返回 Object 参数说明
参数 类型 说明
type String "success" 表示成功, "fail" 表示失败

# switchCamera(callback)

切换前后摄像头

# callback 返回 Object 参数说明
参数 类型 说明
type String "success" 表示成功, "fail" 表示失败

# snapshot(callback)

快照

# callback 返回 Object 参数说明
# 成功时的回调
参数 类型 说明
type string "success" 表示成功, "fail" 表示失败
code Number 对应code码
message object {width:"快照图片宽度",height:"快照图片高度",tempImagePath:"快照图片路径"}。
# 失败的回调
参数 类型 说明
type string "fail" 表示失败
code Number
message object

# startPreview(callback)

开启摄像头预览

# callback 返回 Object 参数说明
参数 类型 说明
type String "success" 表示成功, "fail" 表示失败

# stopPreview(callback)

关闭摄像头预览

# callback 返回 Object 参数说明
参数 类型 说明
type String "success" 表示成功, "fail" 表示失败

# 事件

# statechange

状态变化事件

# 返回参数(detail)的详细说明
参数 类型 说明
code Number
message string

# netstatus

网络状态通知事件

# 安卓 返回参数(detail)的详细说明
键名 说明
videoBitrate 当前视频编/码器输出的比特率,单位 kbps
audioBitrate 当前音频编/码器输出的比特率,单位 kbps
videoFPS 当前视频帧率
videoGOP 当前视频 GOP,也就是每两个关键帧(I帧)间隔时长,单位 s
netSpeed 当前的发送/接收速度
netJitter 网络抖动情况,抖动越大,网络越不稳定
videoWidth 视频画面的宽度
videoHeight 视频画面的高度
# iOS 返回参数(detail)的详细说明
参数 类型 说明
code Number code码
message string 具体的网络状态信息

# error

渲染错误事件

# 返回参数(detail)的详细说明
参数 类型 说明
errCode Number
errMsg string