uniapp leven系列原生插件

Appearance

leven2026-02-01
2710
11.6m

开始播放 ​

注意

该方法回调为异步事件，请参考方法事件

方法名 ​

play

用法 ​

js
this.$refs.refVideoPlayer.play({
  //播放地址，rtmp://liteavapp.qcloud.com/live/liteavdemoplayerstreamid
  //http://devimages.apple.com.edgekey.net/streaming/examples/bipbop_4x3/gear1/prog_index.m3u8
  //rtsp://rtspstream:effd2f46af6aef62a77b62104ceafbc0@zephyr.rtsp.stream/movie
  //http://alvideo.ippzone.com/zyvd/98/90/b753-55fe-11e9-b0d8-00163e0c0248
  // url: "http://vod.ulunix.cn/media_hls/X6-1-wAD-1yQ7R2q-bCJbio780yeu41irzHjQdxj0K42NQp24MULgIW8skzG9y2Cb_C7H3eq1BJFtf2exyVNUP6y69Y80TK7tNV0lCk3TcTiYq0Dmv4Sy2Yly6ZzRGECdsWtL6-fxe2ES3iUQKVtwZubE-ZG6tqe919YIlic2Soc1c1c1c1.m3u8",
  //https://res.exexm.com/cw_145225549855002
  //https://aliyuncdnsaascloud.xjhktv.com/video/A%20Lin%2B%E5%80%AA%E5%AD%90%E5%86%88-%E4%B8%8D%E5%B1%91%E5%AE%8C%E7%BE%8E%5B%E5%9B%BD%5D%5B1080P%5D.mp4
  url: "https://aliyuncdnsaascloud.xjhktv.com/video/A%20Lin%2B%E5%80%AA%E5%AD%90%E5%86%88-%E4%B8%8D%E5%B1%91%E5%AE%8C%E7%BE%8E%5B%E5%9B%BD%5D%5B1080P%5D.mp4",
  //播放器预览背景图片，支持网络地址
  //http://www.yeyuboke.com/svga/image_default.jpg
  backgroundImage: "",
  //视频帧背景图片，以视频帧作为图片，单位：微秒
  frame: 1000000,
  //视频帧图片加载失败显示的图片，需放置到res/mipmap中
  error: "error",
  //图片预加载资源图片，需放置到res/mipmap中
  placeholder: "placeholder",
  //是否边播放边缓存
  cacheWithPlay: true,
  //标题是否显示
  titleVisible: false,
  //视频标题
  title: "安卓高质量视频播放器原生插件",
  //返回按钮是否显示
  backButtonVisible: false,
  //是否可以滑动界面改变进度，声音等
  isTouchWidget: true,
  //是否需要流量提示
  needShowWifiTip: true,
  //是否循环播放
  loop: false,
  //是否显示底部控制条
  bottomContainer: true,
  //是否显示开始播放按钮
  startButtonVisible: false,
  //开始播放位置，目前有时候前几秒有跳动问题，毫秒
  startPosition: 0,
  //请求头信息
  header: {
    ee: "333",
    allowCrossProtocolRedirects: "true",
    "User-Agent": "LEVEN"
  },
  //是否开启硬解码
  enableMediaCodec: false,
  //是否开启硬解码渲染优化
  isMediaCodecTexture: false,
  //视频播放比例，可选值：
  //SCREEN_TYPE_DEFAULT，SCREEN_TYPE_16_9，SCREEN_TYPE_4_3
  //SCREEN_TYPE_18_9，SCREEN_TYPE_FULL，SCREEN_MATCH_FULL
  scaleType: "SCREEN_TYPE_DEFAULT",
  //播放模式，可选值：GLSURFACE：GLSurfaceView 主要用于OpenGL渲染的，如果支持滤镜，必须选择此模式，SURFACE：SurfaceView，与动画全屏的效果不是很兼容，TEXTURE：TextureView，默认
  renderType: "GLSURFACE",
  //水印图片，只支持本地图片，需放置到res/mipmap下
  waterImage: {
    //图片名称，不需要加扩展名
    image: "uni_icon",
    //图片宽度
    width: 100,
    //图片高度
    height: 100,
    //透明度
    alpha: 0.6,
    //水印位置，0：右上角，1.右下角，2.左上角,3.左下角,4.居中,5.右中,6.上中,7.下中,8.左中
    position: 3,
    //位置偏移量，默认：1.0
    offset: 1.5
  },
  //默认播放内核
  kernel: 2,
  //是否静音播放
  isMute: false,
  //gif的帧之间延时,默认：0
  delay: 0,
  //生成gif采样率，默认：1
  sampleSize: 1,
  //生成gif缩放比例，默认：5
  scaleSize: 5,
  //生成gif截图频率，毫秒，默认：50
  frequencyCount: 50,
  //弹幕配置
  danmakuParams: {
    //是否开启弹幕
    danmakuShow: true,
    //初始化弹幕文件，xml文件，如果是raw文件的话不需要加扩展名，其他需要加上扩展名
    //http://www.yeyuboke.com/uniplugin/player/danmaku.xml
    ///storage/emulated/0/Download/WeiXin/danmaku.xml
    danmakuFile: "comments",
    //弹幕文件类型，url：网络地址，path：本地路径，raw：raw文件
    danmakuFileType: "raw",
    //最大显示行数
    maxLines: 3,
    //防弹幕重叠
    preventOverlapping: true,
    //描边样式
    danmakuStyle: {
      //样式，可选值：
      //DANMAKU_STYLE_DEFAULT：自动
      //DANMAKU_STYLE_NONE：无
      //DANMAKU_STYLE_SHADOW：阴影
      //DANMAKU_STYLE_STROKEN：描边（默认）
      //DANMAKU_STYLE_PROJECTION：投影
      style: "DANMAKU_STYLE_STROKEN",
      //描边值，DANMAKU_STYLE_SHADOW 阴影模式下，values传入阴影半径
      //DANMAKU_STYLE_STROKEN 描边模式下，values传入描边宽度
      //DANMAKU_STYLE_PROJECTION 投影模式下，values传入offsetX, offsetY, alpha offsetX/offsetY: x/y 方向上的偏移量 alpha: 投影透明度 [0...255]
      values: [3]
    },
    //是否启用合并重复弹幕，默认：true
    duplicateMergingEnabled: true,
    //设置弹幕滚动速度系数,只对滚动弹幕有效，默认：1.0
    scrollSpeedFactor: 1.2,
    //设置弹幕文本大小，默认：1.0
    scaleTextSize: 1.2
  },
  //加载完成是否自动播放
  autoPlay: true
});
js
//组件初始化配置
const config = ref({
  //播放地址，rtmp://liteavapp.qcloud.com/live/liteavdemoplayerstreamid
  //http://devimages.apple.com.edgekey.net/streaming/examples/bipbop_4x3/gear1/prog_index.m3u8
  //rtsp://rtspstream:effd2f46af6aef62a77b62104ceafbc0@zephyr.rtsp.stream/movie
  //http://alvideo.ippzone.com/zyvd/98/90/b753-55fe-11e9-b0d8-00163e0c0248
  // url: "http://vod.ulunix.cn/media_hls/X6-1-wAD-1yQ7R2q-bCJbio780yeu41irzHjQdxj0K42NQp24MULgIW8skzG9y2Cb_C7H3eq1BJFtf2exyVNUP6y69Y80TK7tNV0lCk3TcTiYq0Dmv4Sy2Yly6ZzRGECdsWtL6-fxe2ES3iUQKVtwZubE-ZG6tqe919YIlic2Soc1c1c1c1.m3u8",
  //https://res.exexm.com/cw_145225549855002
  //https://aliyuncdnsaascloud.xjhktv.com/video/A%20Lin%2B%E5%80%AA%E5%AD%90%E5%86%88-%E4%B8%8D%E5%B1%91%E5%AE%8C%E7%BE%8E%5B%E5%9B%BD%5D%5B1080P%5D.mp4
  url: "https://aliyuncdnsaascloud.xjhktv.com/video/A%20Lin%2B%E5%80%AA%E5%AD%90%E5%86%88-%E4%B8%8D%E5%B1%91%E5%AE%8C%E7%BE%8E%5B%E5%9B%BD%5D%5B1080P%5D.mp4",
  //播放器预览背景图片，支持网络地址
  //http://www.yeyuboke.com/svga/image_default.jpg
  backgroundImage: "",
  //视频帧背景图片，以视频帧作为图片，单位：微秒
  frame: 1000000,
  //视频帧图片加载失败显示的图片，需放置到res/mipmap中
  error: "error",
  //图片预加载资源图片，需放置到res/mipmap中
  placeholder: "placeholder",
  //是否边播放边缓存
  cacheWithPlay: true,
  //标题是否显示
  titleVisible: false,
  //视频标题
  title: "安卓高质量视频播放器原生插件",
  //返回按钮是否显示
  backButtonVisible: false,
  //是否可以滑动界面改变进度，声音等
  isTouchWidget: true,
  //是否需要流量提示
  needShowWifiTip: true,
  //是否循环播放
  loop: false,
  //是否显示底部控制条
  bottomContainer: true,
  //是否显示开始播放按钮
  startButtonVisible: false,
  //开始播放位置，目前有时候前几秒有跳动问题，毫秒
  startPosition: 0,
  //请求头信息
  header: {
    ee: "333",
    allowCrossProtocolRedirects: "true",
    "User-Agent": "LEVEN"
  },
  //是否开启硬解码
  enableMediaCodec: false,
  //是否开启硬解码渲染优化
  isMediaCodecTexture: false,
  //视频播放比例，可选值：
  //SCREEN_TYPE_DEFAULT，SCREEN_TYPE_16_9，SCREEN_TYPE_4_3
  //SCREEN_TYPE_18_9，SCREEN_TYPE_FULL，SCREEN_MATCH_FULL
  scaleType: "SCREEN_TYPE_DEFAULT",
  //播放模式，可选值：GLSURFACE：GLSurfaceView 主要用于OpenGL渲染的，如果支持滤镜，必须选择此模式，SURFACE：SurfaceView，与动画全屏的效果不是很兼容，TEXTURE：TextureView，默认
  renderType: "GLSURFACE",
  //水印图片，只支持本地图片，需放置到res/mipmap下
  waterImage: {
    //图片名称，不需要加扩展名
    image: "uni_icon",
    //图片宽度
    width: 100,
    //图片高度
    height: 100,
    //透明度
    alpha: 0.6,
    //水印位置，0：右上角，1.右下角，2.左上角,3.左下角,4.居中,5.右中,6.上中,7.下中,8.左中
    position: 3,
    //位置偏移量，默认：1.0
    offset: 1.5
  },
  //默认播放内核，可选值：1.IJK内核，2.EXO内核，3.系统内核
  kernel: 2,
  //是否静音播放
  isMute: false,
  //gif的帧之间延时,默认：0
  delay: 0,
  //生成gif采样率，默认：1
  sampleSize: 1,
  //生成gif缩放比例，默认：5
  scaleSize: 5,
  //生成gif截图频率，毫秒，默认：50
  frequencyCount: 50,
  //弹幕配置
  danmakuParams: {
    //是否开启弹幕
    danmakuShow: true,
    //初始化弹幕文件，xml文件，如果是raw文件的话不需要加扩展名，其他需要加上扩展名
    //http://www.yeyuboke.com/uniplugin/player/danmaku.xml
    ///storage/emulated/0/Download/WeiXin/danmaku.xml
    danmakuFile: "comments",
    //弹幕文件类型，url：网络地址，path：本地路径，raw：raw文件
    danmakuFileType: "raw",
    //最大显示行数
    maxLines: 3,
    //防弹幕重叠
    preventOverlapping: true,
    //描边样式
    danmakuStyle: {
      //样式，可选值：
      //DANMAKU_STYLE_DEFAULT：自动
      //DANMAKU_STYLE_NONE：无
      //DANMAKU_STYLE_SHADOW：阴影
      //DANMAKU_STYLE_STROKEN：描边（默认）
      //DANMAKU_STYLE_PROJECTION：投影
      style: "DANMAKU_STYLE_STROKEN",
      //描边值，DANMAKU_STYLE_SHADOW 阴影模式下，values传入阴影半径
      //DANMAKU_STYLE_STROKEN 描边模式下，values传入描边宽度
      //DANMAKU_STYLE_PROJECTION 投影模式下，values传入offsetX, offsetY, alpha offsetX/offsetY: x/y 方向上的偏移量 alpha: 投影透明度 [0...255]
      values: [3]
    },
    //是否启用合并重复弹幕，默认：true
    duplicateMergingEnabled: true,
    //设置弹幕滚动速度系数,只对滚动弹幕有效，默认：1.0
    scrollSpeedFactor: 1.2,
    //设置弹幕文本大小，默认：1.0
    scaleTextSize: 1.2
  },
  //加载完成是否自动播放
  autoPlay: true
})
let params : JSONObject = JSONObject.parse(JSON.stringify(config.value)) as JSONObject
refLevenPlayer.value?.play(params);

参数说明 ​

参数名参数类型是否必填默认值参数描述
urlString是无视频播放地址或文件、文件路径，如果是内部存储文件需要传绝对路径
backgroundImageString否无播放器预览背景图片，支持网络地址
frameInteger否无视频帧背景图片，以视频帧作为图片，单位：微秒
errorString否无视频图片加载失败显示的图片，需放置到res/mipmap中
placeholderString否无图片预加载资源图片，需放置到res/mipmap中
cacheWithPlayBoolean否true是否边播放边缓存
titleVisibleBoolean否true标题是否显示
titleString否无视频标题
backButtonVisibleBoolean否true返回按钮是否显示
isTouchWidgetBoolean否true是否可以滑动界面改变进度，声音等
needShowWifiTipBoolean否true是否需要流量提示
loopBoolean否false是否循环播放
bottomContainerBoolean否true是否显示底部控制条
startButtonVisibleBoolean否false是否显示开始播放按钮
startPositionInteger否0开始播放位置，目前有时候前几秒有跳动问题，毫秒
headerObject否无请求头信息
enableMediaCodecBoolean否false是否开启硬解码
isMediaCodecTextureBoolean否false是否开启硬解码渲染优化
scaleTypeString否SCREEN_TYPE_DEFAULT视频播放比例，可选值：
SCREEN_TYPE_DEFAULT
SCREEN_TYPE_16_9
SCREEN_TYPE_4_3
SCREEN_TYPE_18_9
SCREEN_TYPE_FULL
SCREEN_MATCH_FULL
renderTypeString否TEXTURE播放模式，可选值：
GLSURFACE：GLSurfaceView 主要用于OpenGL渲染的，如果支持滤镜，必须选择此模式
SURFACE：SurfaceView，与动画全屏的效果不是很兼容
TEXTURE：TextureView
waterImageObject否无水印图片，只支持本地图片，需放置到res/mipmap下
waterImage.imageString否无图片名称，不需要加扩展名
waterImage.widthInteger否无图片宽度
waterImage.heightInteger否无图片高度
waterImage.alphafloat否无图片透明度
waterImage.positionfloat否无水印位置，0：右上角，1.右下角，2.左上角,3.左下角,4.居中,5.右中,6.上中,7.下中,8.左中
waterImage.offsetfloat否1.0位置偏移量
kernelInteger否1播放器内核，1.IJK内核（默认），2.EXO内核，3.系统内核
isMuteBoolean否false是否静音播放
delayInteger否0生成gif的帧之间延时
sampleSizeInteger否1生成gif采样率
scaleSizeInteger否5生成gif缩放比例
frequencyCountInteger否50生成gif截图频率，毫秒
danmakuParamsObject否无弹幕配置
danmakuParams.danmakuShowBoolean否true是否开启弹幕
danmakuParams.danmakuFileString否无初始化弹幕文件，xml文件，如果是raw文件的话不需要加扩展名，其他需要加上扩展名，具体文件格式请参考【弹幕文件配置说明】
danmakuParams.danmakuFileTypeString否无弹幕文件类型
url：网络地址
path：本地路径
raw：raw文件
danmakuParams.maxLinesInteger否5最大显示行数
danmakuParams.preventOverlappingBoolean否true防弹幕重叠
danmakuParams.danmakuStyleObject否true描边样式
danmakuParams.danmakuStyle.styleString否DANMAKU_STYLE_STROKEN样式，可选值：
DANMAKU_STYLE_DEFAULT：自动
DANMAKU_STYLE_NONE：无
DANMAKU_STYLE_SHADOW：阴影
DANMAKU_STYLE_STROKEN：描边
DANMAKU_STYLE_PROJECTION：投影
danmakuParams.danmakuStyle.valuesArray[float]否[3]描边值，DANMAKU_STYLE_SHADOW 阴影模式下，values传入阴影半径，DANMAKU_STYLE_STROKEN 描边模式下，values传入描边宽度，DANMAKU_STYLE_PROJECTION 投影模式下，values传入offsetX, offsetY, alpha offsetX/offsetY: x/y 方向上的偏移量 alpha: 投影透明度 [0...255]
danmakuParams.duplicateMergingEnabledBoolean否true是否启用合并重复弹幕
danmakuParams.scrollSpeedFactorfloat否1.0设置弹幕滚动速度系数,只对滚动弹幕有效
danmakuParams.scaleTextSizefloat否1.0设置弹幕文本大小
isAutoPlayBoolean否true是否自动播放