WebApp快捷打包
视立方 · 播放器
转到模块插件

敬告：此 DEMO 演示为开放测试页面，仅用于开发者快速测试体验应用功能，请严格遵守开发者协议，了解更多。

♦ JS-SDK 引用方式：

♦ 普通网页 script 方式加载：下载最新版 jsBridge-v20251019.zip，请在页面上调用 jsBridge 接口之前引用 jsbridge-mini.js 库；

♦ js module 方式引用：npm install ym-jsbridge 具体请参考 npm package

♦ 支持点播/直播/倍速/多码率/循环/横竖屏播放；

♦ 支持播放列表（原生 UI，多视频按序自动播放）；

♦ 支持但不仅限于 腾讯云视频；

♦ 结合腾讯云视频服务可实现免费试看、付费看全片功能；

play 全屏播放 简单示例

视频链接: 

//全屏播放单个视频，直接提供视频链接即可
jsBridge.txVideo.play($("#videoUrl").val());

play 播放本地视频

请配合 FileSystem 文件系统 插件使用，先将视频下载到本地，使用 fs://... 地址播放。

//播放本地视频
jsBridge.txVideo.play('fs://file/my_dir/f10.mp4');

play 全屏播放 方式1：URL 链接

//方式1：URL 链接
jsBridge.txVideo.play({
  url        : 'https://vfx.mtime.cn/Video/2019/12/30/mp4/191230190451257319.mp4',
  title      : '方式1：URL 链接',
  //数字，播放方式
  //0 自动播放
  //1 手动播放
  //2 预加载
  playAction : 0,
  //字符串，封面图片链接
  coverPictureUrl: "",
  //json 对象，动态水印
  water: {
    //字符串，水印文字
    text: "",
    //文字大小
    size: 30,
    //文字颜色
    color: "#80FFFFFF"
  },
  cutout: false,
  keepOrientation: false,
  loop: true
});

/*
参数说明
{
  url             : '',   //必须，字符串类型，视频链接
  title           : '',   //可选，字符串类型，视频名称，显示在 UI 上
  qualityName     : '',   //可选，字符串类型，码率名称（如 标清/高清/超清/1080P/4K 等)
  playAction      : 0,    //可选，数字类型，播放方式
  coverPictureUrl : "",   //可选，字符串类型，封面图片链接
  water           :       //可选，json 类型，动态水印
  cutout          : '',   //可选，布尔类型，是否保留刘海（凹凸屏）区域，默认 false 即不保留（视频会占用刘海区域）
  keepOrientation : false //可选，布尔类型，是否保持当前屏幕方向（true 保持当前屏幕方向不变，false 切换为横屏），默认 false
  loop            : false //可选，布尔类型，是否循环播放，默认 false
}

以下 方式2、方式3 均支持 keepOrientation 和 loop 参数
*/

play 全屏播放 方式1：URL 链接 - 不占用刘海区域

//不占用刘海区域
jsBridge.txVideo.play({
  url   : 'http://player.alicdn.com/video/editor.mp4',
  title : '不占用刘海（凹凸异形屏）区域',
  cutout: true
});

play 全屏播放 方式2：多码率 URL 链接

//方式2：多码率 URL 链接
jsBridge.txVideo.play({
  multiURLs       : [
    {
      url        : 'http://1252463788.vod2.myqcloud.com/95576ef5vodtransgzp1252463788/e1ab85305285890781763144364/v.f10.mp4',
      qualityName: '流畅'
    },
    {
      url        : 'http://1252463788.vod2.myqcloud.com/95576ef5vodtransgzp1252463788/e1ab85305285890781763144364/v.f20.mp4',
      qualityName: '标清'
    },
    {
      url        : 'http://1252463788.vod2.myqcloud.com/95576ef5vodtransgzp1252463788/e1ab85305285890781763144364/v.f30.mp4',
      qualityName: '高清'
    }
  ],
  title           : '方式2：多码率 URL 链接',
  playDefaultIndex: 1
});

/*
参数说明：
{
  multiURLs       : [   //必须，多码率数组
    {
      url        : '',  //必须，字符串类型，视频链接
      qualityName: ''   //必须，字符串类型，码率名称（如 标清/高清/超清/1080P/4K 等)
    },
    ...
  ],
  title           : '', //可选，字符串类型，视频名称，显示在 UI 上
  playDefaultIndex: 0   //可选，数字类型，默认播放码率的 index，即 multiURLs 中从0开始的索引号
}
*/

play 全屏播放 方式3：腾讯云视频

//方式3：腾讯云视频，请参见 https://cloud.tencent.com/product/vod
//结合腾讯云视频服务可实现免费试看、付费看全片功能
jsBridge.txVideo.play({
  appId   : 1256993030,
  title   : '腾讯云视频',
  videoId : {
    fileId: '7447398157015849771',
    pSign : ''
  }
});

/*
参数说明：
{
  appId   : 0,  //必须，数字类型，腾讯云服务 AppId
  title   : '', //可选，字符串类型，视频名称，显示在 UI 上
  videoId : {   //必须，腾讯云视频 VideoId（FileId）
    fileId: '', //必须，字符串类型，腾讯云视频 FileId
    pSign : ''  //可选，防盗链授权签名，如开启了防盗链则必填，算法请参考 https://cloud.tencent.com/document/product/266/45554
  }
}
*/

play 全屏播放：保持当前屏幕方向不变

//保持当前屏幕方向（不强制横屏）keepOrientation: true
//请参考 全屏播放方式一 的参数说明
jsBridge.txVideo.play({
  url        : 'https://734.cdn-vod.huaweicloud.com/asset/c4aec16ec296cb8964f80845000cb958/play_video/fcb8827219c07153131eff228583e5a1_H.264_1280X720_HEAACV1_1500.mp4',
  title      : '保持当前屏幕方向',
  qualityName: '超清',
  keepOrientation: true,
  loop       : true
});

playList 播放列表

//仅支持 Android 版
//播放列表，按顺序自动连续播放
jsBridge.txVideo.playList({
  title: '这是播放列表的名称',
  //必须，数组类型，视频源列表
  items: [
    {
       //列表图片
       poster: 'https://i.cdn.yimenapp.com/sys/player2.jpg',
       url   : 'https://734.cdn-vod.huaweicloud.com/asset/c4aec16ec296cb8964f80845000cb958/play_video/fcb8827219c07153131eff228583e5a1_H.264_1280X720_HEAACV1_1500.mp4',
       title : '华为消费者业务品牌主题曲 Dream It Possible',
       desc  : '时长 03:58'
    },
    {
       poster: 'http://1252463788.vod2.myqcloud.com/e12fcc4dvodgzp1252463788/28742df34564972819219071568/4564972819209692959.jpeg',
       appId    : 1252463788,
       videoId  : {
         fileId : '4564972819219071568',
         pSign  : ''
       },
       title : '腾讯云视频',
       desc  : '与美女对话'
    },
    {
       poster: 'http://1252463788.vod2.myqcloud.com/95576ef5vodtransgzp1252463788/e1ab85305285890781763144364/1536584350_1812858038.100_0.jpg',
       multiURLs     : [
        {
          url        : 'http://1252463788.vod2.myqcloud.com/95576ef5vodtransgzp1252463788/e1ab85305285890781763144364/v.f10.mp4',
          qualityName: '流畅'
        },
        {
          url        : 'http://1252463788.vod2.myqcloud.com/95576ef5vodtransgzp1252463788/e1ab85305285890781763144364/v.f20.mp4',
          qualityName: '标清'
        },
        {
          url        : 'http://1252463788.vod2.myqcloud.com/95576ef5vodtransgzp1252463788/e1ab85305285890781763144364/v.f30.mp4',
          qualityName: '高清'
        }
      ],
      title           : 'MP4点播 多码率 URL 链接',
      playDefaultIndex: 1
    },
    {
       poster: 'https://i.cdn.yimenapp.com/sys/player4.jpg',
       url   : 'http://gcqq450f71eywn6bv7u.exp.bcevod.com/mda-hbqagik5sfq1jsai/mda-hbqagik5sfq1jsai.mp4',
       title : 'MP4点播 Motor Live'
    },
    {
       poster: '',
       url   : 'http://5815.liveplay.myqcloud.com/live/5815_89aad37e06ff11e892905cb9018cf0d4_900.flv',
       title : 'FLV 直播流'
    },
    {
       poster: 'https://i.cdn.yimenapp.com/sys/player5.jpg',
       url   : 'http://cyberplayerplay.kaywang.cn/cyberplayer/demo201711-L1.m3u8',
       title : 'HLS(m3u8) 直播流'
    }
  ],
  //可选，数字类型，开始播放的视频序号，默认 0（第一个）
  playDefaultIndex: 0,
  //可选，布尔类型，是否循环播放视频列表，默认 false
  loop            : false,
  //可选，布尔类型，是否保留刘海（凹凸屏）区域，默认 false 即不保留（全屏视频会占用刘海区域）
  cutout: false
});

/*
参数说明：
{
  title: '', //可选，字符串类型，播放列表名称，显示在标题栏上
  items: [   //必须，视频列表清单数组
    {        //以上 play 方式1, 2, 3 播放参数的任意组合
    },
    ...
  ],
  playDefaultIndex: 0 //可选，默认开始播放 items 列表中的视频序号
}
*/

高级用法 在 Web 页面中嵌入播放器

转到

仅支持 Android 版；

可以将原生视频播放器嵌入 Web 网页中，获得比 HTML5 Video 标签更好的播放体验；

全部示例
Copyright © 2025 WebApp快捷打包