neteasePlayer

论坛示例

为帮助用户更好更快的使用插件,论坛维护了一个示例,示例中包含示例代码、知识点讲解、注意事项等,供您参考。

概述

neteasePlayer 封装了网易云视频播放器。可快进、快退设置播放位置等操作,亦可通过手势设置系统声音大小。接口可获取插件上的各种手势操作事件。使用本插件相当于open一个window。本插件通过 open 接口,打开一个纯播放器界面

###功能特性

  • 支持 HTTP、RTMP、HLS 协议的流媒体播放

  • 支持常见的音视频文件播放(MP4、flv、MP3 等)

  • 支持 MediaCodec 硬件解码;支持硬件解码(iOS 8.0及以上)

  • 支持多种画面预览模式(填充,拉伸,裁剪)

  • 支持 ARM, ARMv7a, ARM64v8a, X86 架构

  • 支持的CPU架构:armv7、arm64、i386、x86_64

  • 支持 Android 4.0及以上系统,支持iOS 7.0及以上系统

  • 支持音频后台播放

  • 可高度定制化播放器UI控件

  • 优化 RTMP 直播首屏秒开

  • 优化 RTMP 直播累积延时

open

打开一个自带界面的视频播放器,本播放器为全屏横屏显示,支持屏幕随设备自动旋转。用户单击播放器时,会弹出 foot 和 head 导航条,再次单击则关闭之。

open({params}, callback(ret, err))

params

title:

  • 类型:字符串
  • 描述:(可选项)视频标题

definition:

  • 类型:数组
  • 描述:(可选项)视频清晰度
  • 默认:
["高清","标清","流畅"]

styles:

  • 类型:JSON 对象
  • 描述:(可选项)插件的样式设置
  • 内部字段:
{
    head:{//(可选项)JSON对象;播放器顶部导航条样式    
       bg: 'rgba(161,161,161,0.5)', //(可选项)字符串类型;顶部导航条背景,支持#、rgb、rgba、img;默认:rgba(161,161,161,0.5)
       height: 44,                  //(可选项)数字类型;顶部导航条的高;默认:44
       title:{
           size:13,                     //(可选项)数字类型;顶部标题字体大小;默认:13
           color:'#fff',                //(可选项)字符串类型;顶部标题字体颜色;默认:#fff
           width:100,                    //(可选项)标题的宽度,文本超过该宽度,显示...
           leftMargin:10                //(可选项)距离左边控件的外边距,默认:10
       },
       backSize: 44,                //(可选项)数字类型;顶部返回按钮大小;默认:44
       backImg:'fs://img/back.png', //(可选项)字符串类型;顶部返回按钮的背景图片,要求本地路径(widget://、fs://);默认:返回小箭头图标	
       definition:{
          bg:'#fff'                        //(可选项)数字类型;清晰度背景颜色;默认:'#00000'
          textSize:14,                     //(可选项)数字类型;清晰度标签大小;默认:14
          textColor:"#FFF",                //(可选项)字符串类型;清晰度标签颜色,支持#、rgba、rgb;默认:#FFF
          textWidth: 30,                   //(可选项) 数字类型;清晰度的宽度
          marginRight:5                    // (可选项) 数字类型;右边距,默认:5
       },
       playCenterBtn:{
     size : 44,                          //(可选项)数字类型;屏幕中间的播放/暂停按钮大小;默认:44
     playCenterImg:'fs://img/play.png',  //(可选项)字符串类型;底部播放按钮的背景图片,要求本地路径(widget://、fs://);默认:播放按钮图标
     pauseCenterImg:'fs://img/pause.png',//(可选项)字符串类型;底部暂停按钮的背景图片,要求本地路径(widget://、fs://);默认:暂停按钮图标              
       },
       foot:{                                  //(可选项)JSON对象;播放器底部导航条样式    
         bg: 'rgba(161,161,161,0.5)',         //(可选项)字符串类型;底部导航条背景,支持#、rgb、rgba、img;默认:rgba(161,161,161,0.5)
         height: 44,                          //(可选项)数字类型;底部导航条的高;默认:44
     playBtn:{
        size : 44,                    //(可选项)数字类型;底部播放/暂停按钮大小;默认:44
        playImg:'fs://img/play.png',  //(可选项)字符串类型;底部播放按钮的背景图片,要求本地路径(widget://、fs://);默认:播放按钮图标
        pauseImg:'fs://img/pause.png',//(可选项)字符串类型;底部暂停按钮的背景图片,要求本地路径(widget://、fs://);默认:暂停按钮图标 
        marginLeft:5                  //(可选项)数字类型;左边距,默认:5              
    },
    currentTimeLabel:{
        textSize:14,                  //(可选项)数字类型;底部时间标签大小;默认:14
        textColor:"#FFF",             //(可选项)字符串类型;底部时间标签颜色,支持#、rgba、rgb;默认:#FFF
        textWidth: 30,                //(可选项)数字类型;时间标签的宽度
            marginLeft:5                  //(可选项)数字类型;左边距,默认:5 
        },                
    seekBar:{
            sliderImg:'fs://img/slder.png', //(可选项)字符串类型;底部进度条滑块背景图片,要求本地路径(widget://、fs://);默认:滑块小图标
            sliderW : 20,      // 数字类型; slider 的宽度
            sliderH : 20,      // 数字类型; slider 的高度
            progressColor: '#696969',          //(可选项)字符串类型;进度条背景色,支持#、rgba、rgb;默认:#696969
            progressSelected: '#76EE00',       //(可选项)字符串类型;滑动后的进度条背景色,支持#、rgb、rgba;默认:#76EE00
            marginLeft:5       // (可选项)数字类型;左边距,默认:5 
            marginRight:5      // (可选项)数字类型;右边距,默认:5 
    },
        totalTimeLabel:{
            textSize:10,                     //(可选项)数字类型;底部时间标签大小;默认:10
            textColor:"#FFF",                //(可选项)字符串类型;底部时间标签颜色,支持#、rgba、rgb;默认:#FFF
            textWidth: 30,                   //(可选项)数字类型;时间标签的宽度
            marginRight:5                    //(可选项)数字类型;右边距,默认:5
    },
        voiceBtn:{
            visible:true, //(可选项)布尔类型;是否可见,默认:true 
            size:44,  //(可选项)数字类型;底部右边声音按钮大小;默认:44
            muteImg:'widget://img/muteImg.png',           //(可选项)字符串类型;底部静音按钮的背景图片,要求本地路径(widget://、fs://);默认:静音按钮图标
            disMuteImg:'widget://img/disMuteImg.png',     //(可选项)字符串类型;底部非静音按钮的背景图片,要求本地路径(widget://、fs://);默认:非静音按钮图标
    },
    fullscreenBtn:{
            size:44,  //(可选项)数字类型;底部全屏/非全屏按钮大小;默认:44
        verticalImg:'fs://img/vertical.png',       //(可选项)字符串类型;底部横竖屏切换按钮的背景图片,竖屏状态下的切换按钮,要求本地路径(widget://、fs://);默认:竖屏按钮图标
            horizontalImg:'fs://img/horizontal.png',   //(可选项)字符串类型;底部横竖屏切换按钮的背景图片,横屏状态下的切换按钮,要求本地路径(widget://、fs://);默认:横屏按钮图标
    }
    }
}

shareConfig:

  • 类型: JSON对象
  • 描述:分享UI配置
{
      bg:'#000',                                 //(可选项)分享面板的背景;默认:黑色
      shareBtn:{                                 //(可选项)JSON对象;分享按钮设置(不传不显示)
          iconPath:"widget://res/shareBtn.jpg",  //(可选项)按钮图标,支持widget:// fs://
          size:30,                               //(可选项)按钮大小,默认:30
          marginRight:20                         //(可选项)右边距,默认:20
      },
      shareItems:[{                              // JSON数组;分享选项设置
          iconPath:'widget://res/qq.jpg',        // 字符串;分享item的图标
          text:'QQ分享'                           // 字符串;分享item的文本
      }]
}

path:

  • 类型:字符串
  • 描述:(可选项)文档的路径,支持网络和本地(fs://)路径,在 android 平台上不支持 widget

autoPlay:

  • 类型:布尔
  • 描述:(可选项)打开时是否自动播放
  • 默认值:true(自动播放)

autoRotate:

  • 类型:布尔
  • 描述:是否自动旋转
  • 默认值:false

fixedOn:

  • 类型:字符串类型
  • 描述:(可选项)插件视图添加到指定 frame 的名字(只指 frame,传 window 无效)
  • 默认:插件依附于当前 window

fixed:

  • 类型:布尔
  • 描述:(可选项)插件是否随所属 window 或 frame 滚动
  • 默认值:true(不随之滚动)

callback(ret, err)

ret:

  • 类型:JSON 对象
  • 内部字段:
{
        eventType:'share',
        shareId:0,        // 数字类型;点击分享item的索引
    status:           // 布尔类型;是否打开播放组件并显示,true|false;Will be deprecated in ther future
}

示例代码

var neteasePlayer = api.require('neteasePlayer');
neteasePlayer.open({
          title:'少林寺',
          definition:["高清","标清","流畅"],
          styles:{
          head:{
          bg: 'rgba(161,161,161,1)',
          height: 44,
          title:{
          size:20,
          color:'#fff',
          width:100,
          leftMargin:10
          },
          backSize: 44,
          backImg:'widget://image/back.png',
          definition:{
            bg:'#fff',
            textSize:14,
            textColor:"#FFF",
            textWidth: 30,
            marginRight:5
                   },
         },
              playCenterBtn:{
                 size : 44,                          
                 playCenterImg:'fs://img/play.png',  
                 pauseCenterImg:'fs://img/pause.png',
             },
          foot:{
          bg: 'rgba(0,0,0,0.5)',
          height: 44,
          playBtn:{
          size: 44,
          playImg:'widget://image/play.png',
          pauseImg:'widget://image/pause.png',
          marginLeft:5
          },
          currentTimeLabel:{
          textSize:10,
          textColor:"#FFF",
          textWidth: 50,
          marginLeft:5
          },
          seekBar:{
          sliderImg:'widget://image/circle.png',
          sliderW : 20,
          sliderH : 20,
          progressColor: '#696969',
          progressSelected: '#76EE00',
          marginLeft:10,
          marginRight:10
          },
          totalTimeLabel:{
          textSize:10,
          textColor:"#FFF",
          textWidth: 50,
          marginRight:5
          },
          voiceBtn:{
            size:44,
            muteImg:'widget://img/muteImg.png',
            disMuteImg:'widget://img/disMuteImg.png',
                   },
          fullscreenBtn:{
          size:44,
          verticalImg:'widget://image/vertical.png',
          horizontalImg:'widget://image/horizontal.png',
          }
          } },
           path:'http://baobab.wdjcdn.com/1455782903700jy.mp4',
           autoPlay: true
            },function(ret, err){
                if(ret){
                    api.alert({msg: JSON.stringify(ret)});
                } else {
                    api.alert({msg: JSON.stringify(err)});
                }

});

可用性

iOS系统,Android系统

可提供的1.0.0及更高版本

close

关闭播放器

close()

示例代码

var neteasePlayer = api.require('neteasePlayer');
neteasePlayer.close();

可用性

iOS系统,Android系统

可提供的1.0.0及更高版本

switchContentUrl

播放过程中切换播放地址

switchContentUrl()

params

aUrl:

  • 类型:字符串
  • 描述:(可选项)待切换的播放地址,支持网络和本地(fs://)路径,在 android 平台上不支持 widget

示例代码

var neteasePlayer = api.require('neteasePlayer');
neteasePlayer.switchContentUrl({
    aUrl : 'http://xxx/xx.mp4'
});

可用性

iOS系统,Android系统

可提供的1.0.0及更高版本

isPlaying

判断当前播放状态

isPlaying(ret)

callback(ret)

{
    state: true  // boolean类型,true表示正在播放,否则为暂停状态
}

示例代码

var neteasePlayer = api.require('neteasePlayer');
neteasePlayer.isPlaying(function(ret){
    api.alert({msg: JSON.stringify(ret)});
});

可用性

iOS系统,Android系统

可提供的1.0.0及更高版本

setHardwareDecoder

设置是否开启硬件解码,仅IOS 8.0以上支持,默认不开启

setHardwareDecoder()

params()

status:

  • 类型:布尔
  • 描述:true是后台暂停 false是继续播放
  • 默认:false

示例代码

var neteasePlayer = api.require('neteasePlayer');
neteasePlayer.setHardwareDecoder({
    status:false
});

可用性

iOS系统,Android系统

可提供的1.0.0及更高版本

seekTo

设置当前播放时间点

seekTo({params})

params

seconds:

  • 类型:数字
  • 描述:跳转到音视频播放的秒数

示例代码

var neteasePlayer = api.require('neteasePlayer');
neteasePlayer.seekTo({
    seconds: 20
});

可用性

iOS系统,Android系统

可提供的1.0.0及更高版本

currentPlaybackTime

获取当前播放时长

currentPlaybackTime({params})

callback

{
    duration: 10s  // 数字类型
}

示例代码

var neteasePlayer = api.require('neteasePlayer');
neteasePlayer.currentPlaybackTime(function(ret){
api.alert({msg: JSON.stringify(ret)});
});

可用性

iOS系统,Android系统

可提供的1.0.0及更高版本

addEventListener

播放器监听事件

addEventListener(ret)

callback

ret:

{
    eventType: 'play', // 字符串类型;点击播放按钮;取值范围:
                       // pause 点击暂停播放按钮
                       // complete 播放器播放完成
                       // error 播放器异常
                       // back 返回按钮
                       // upFling 在播放器上任意位置快速上滑
                       // downFling 在播放器上任意位置快速下滑
    definition: ''     //该字段返回 open -> definition相应的item
}

示例代码

var neteasePlayer = api.require('neteasePlayer');
neteasePlayer.addEventListener(function(ret){
    if(ret && ret.eventType == 'back'){
        alert('点击back按钮');
    }
});

可用性

iOS系统,Android系统

可提供的1.0.0及更高版本

showAlert

弹出提醒信息(暂仅支持Android)

showAlert()

params

title:

  • 类型:字符串
  • 描述:弹框标题

msg:

  • 类型:字符串
  • 描述:弹框信息

okBtnTitle:

  • 类型:字符串
  • 描述:确认按钮标题
  • 默认:确定

示例代码

var neteasePlayer = api.require('neteasePlayer');
neteasePlayer.showAlert({
    title:'温馨提示',
    msg:'您的手机未安装qq',
    okBtnTitle:'确定'   
});
是否仍需要帮助? 请保持联络!
最后更新于 2024/12/2