speedPlayer

来自于：开发者立即使用

open close puase resume setPath setRect replay seek getCurrent getDuration setRate getRate fullscreen cancelFullscreen getVol setVol getBrightness setBrightness start

概述

speedPlayer 封装了原生视频播放功能（支持倍速播放）。使用本模块时可把本模块当做一个 frame 添加在 window 或 frame 上。Android 平台上支持的的视频文件格式有：MP4、3GP、FLV、RTMP、M3U8；IOS 平台上支持的视频文件格式有：MOV、MP4、M4V、FLV、ACC、3GP、RTMP、M3U8等 ;

open

打开一个直播或点播

open({params}，function(ret,err))

params

url

  • 类型：字符串
  • 描述：（必填项）视频资源地址，支持fs://、widget://(在 android 平台上不支持 widget)、rtmp://、http://

title

  • 类型：字符串
  • 描述：（可选项）不填时标题默认显示url地址

pos

  • 类型：数值型
  • 描述：视频播放开始地址，单位：秒。

hideController

  • 类型：布尔型
  • 描述：是否隐藏控制条，默认false;如果想自定义播放界面可以设置为true，自行画界面。

frame

  • 类型：JSON 对象
  • 描述：（可选项）视频区域的位置及尺寸
  • 内部字段：
  • {
    • x: 0, //（可选项）数字类型；模块左上角的 x 坐标（相对于所属的 Window 或 Frame）；默认：0
    • y: 0, //（可选项）数字类型；模块左上角的 y 坐标（相对于所属的 Window 或 Frame）；默认：0
    • w: 320, //（可选项）数字类型；模块的宽度；默认：所属的 Window 或 Frame 的宽度
    • h: 300 //（可选项）数字类型；模块的高度；默认：w的3/4 }

callback(ret, err)

ret：

  • 类型：JSON对象
  • 内部字段：
  3.     {    
  4.         cmd:"",    //playing 播放回调，可以获取到当前播放的位置
  5.                 //close close的回调；
  6.                 //setPath setPath的回调；
  7.                 //replay replay的回调；
  8.                 //seek seek的回调；
  9.                 //setRate setRate的回调；
  10.                 //fullscreen fullscreen的回调；
  11.                 //cancelFullscreen cancelFullscreen的回调；
  12.                 //setVol setVol的回调；
  13.                 //setRect setRect的回调；
  14.                 //playerStatus 初始化视频返回的状态；当status==statusReady，会返回来一个视频时长duration
  15.         status:1,//statusReady视频准备好了可以播放；statusUnknown未知错误；statusFailed视频播放失败；
  16.         time:12//当cmd=='playing'时，返回来视频播放时间
  17.     }

示例代码

  2.     var speedPlayer = api.require('speedPlayer');
  3.     speedPlayer.open({
  4.         url:'http://www.17xc.net/userfiles/mp4/1497624042.mp4',
  5.         title:'这里是测试的title',
  6.         pos:30,
  7.         hideController:true,
  8.         frame:{x:0,y:0,w:400,h:200},
  9.         },function(ret, err){
  10.             if(ret.cmd=='playing'){
  11.             }else if(ret.cmd=='playerStatus'){
  12.                 switch(ret.status){
  13.                     case 'statusReady':
  14.                         duration=ret.duration;//单位，秒。
  15.                         console.log('视频准备好了')
  16.                         break;
  17.                     case 'statusUnknown':
  18.                         console.log('未知错误')
  19.                         break;
  20.                     case 'statusFailed':
  21.                         console.log('视频播放失败')
  22.                         break;
  23.                 }
  24.             }
  25.     });

可用性

iOS系统，Android系统

可提供的1.0.0及更高版本

close

关闭播放器并释放内存

close()

示例代码

  2.     var speedPlayer=api.require('speedPlayer');
  3.     speedPlayer.close()

可用性

iOS系统，Android系统

可提供的1.0.0及更高版本

pause

暂停播放

pause()

示例代码

  2.     var speedPlayer=api.require('speedPlayer');
  3.     speedPlayer.pause()

可用性

iOS系统，Android系统

可提供的1.0.0及更高版本

resume

继续播放

resume()

示例代码

  2.     var speedPlayer=api.require('speedPlayer');
  3.     speedPlayer.resume()

可用性

iOS系统，Android系统

可提供的1.0.0及更高版本

setPath

设置视频地址及标题，开始播放位置

params

url

  • 类型：字符串
  • 描述：（必填项）视频资源地址，支持fs://、widget://(在 android 平台上不支持 widget)、rtmp://、http://

title

  • 类型：字符串
  • 描述：（必填项）不填时标题默认显示url地址

pos

  • 类型：数值型
  • 描述：视频播放开始地址，单位：秒。

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

示例代码

  2.     var speedPlayer=api.require('speedPlayer');
  3.     speedPlayer.setPath({
  4.         url:'http://www.17xc.net/userfiles/mp4/1497624042.mp4',
  5.         title:'这里是测试的title',
  6.         pos:30,
  7.     })

可用性

iOS系统，Android系统

可提供的1.0.0及更高版本

setRect

设置视频区域大小。

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

params

rect

  • 类型：JSON 对象
  • 描述：（可选项）视频区域的位置及尺寸
  • 内部字段：
  • {
    • x: 0, //（可选项）数字类型；模块左上角的 x 坐标（相对于所属的 Window 或 Frame）；默认：0
    • y: 0, //（可选项）数字类型；模块左上角的 y 坐标（相对于所属的 Window 或 Frame）；默认：0
    • w: 320, //（可选项）数字类型；模块的宽度；默认：所属的 Window 或 Frame 的宽度
    • h: 300 //（可选项）数字类型；模块的高度；默认：w的3/4 }

示例代码

  2.     var speedPlayer=api.require('speedPlayer');
  3.     speedPlayer.setRect({
  4.          rect: {x:0,y:0,w:300,h:200}
  5.     })

可用性

iOS系统，Android系统

可提供的1.0.0及更高版本

replay

重播

replay()

示例代码

  2.     var speedPlayer=api.require('speedPlayer');
  3.     speedPlayer.replay()

可用性

iOS系统，Android系统

可提供的1.0.0及更高版本

seek

设置视频播放位置

seek({params})

params

pos

  • 类型：数值型
  • 描述：（可选项）视频播放开始位置，单位：秒。

示例代码

  2.     var speedPlayer=api.require('speedPlayer');
  3.     speedPlayer.seek({ 
  4.         pos:30
  5.     });

可用性

iOS系统，Android系统

可提供的1.0.0及更高版本

getCurrent

获取视频播放的位置

getCurrent()

callback(ret, err)

ret：

  • 类型：JSON对象
  • 内部字段：
  3.     {    
  4.         cmd:"getCurrent",
  5.         data:12//当前视频播放时间，单位：秒。
  6.     }

示例代码

  2.     var speedPlayer=api.require('speedPlayer');
  3.     speedPlayer.getCurrent(function(ret,err){
  4.         alert(JSON.stringify(ret));
  5.     })

可用性

iOS系统，Android系统

可提供的1.0.0及更高版本

getDuration

获取视频总时长

getDuration()

callback(ret, err)

ret：

  • 类型：JSON对象
  • 内部字段：
  3.     {    
  4.         cmd:"getDuration",
  5.         data:125//视频总时长，单位：秒。
  6.     }

示例代码

  2.     var speedPlayer=api.require('speedPlayer');
  3.     speedPlayer.getCurrent(function(ret,err){
  4.         alert(JSON.stringify(ret));
  5.     })

可用性

iOS系统，Android系统

可提供的1.0.0及更高版本

setRate

设置视频播放倍数

setRate()

params

speed

  • 类型：数值型
  • 描述：（可选项）设置视频播放倍速，范围0.5-2.0。

示例代码

  2.     var speedPlayer=api.require('speedPlayer');
  3.     speedPlayer.setRate({
  4.         speed:1.5,
  5.     })

可用性

iOS系统，Android系统

可提供的1.0.0及更高版本

getRate

获取视频播放的倍速

getRate()

callback(ret, err)

ret：

  • 类型：JSON对象
  • 内部字段：
  2.     {    
  3.         cmd:"getRate",
  4.         data:1.2//当前视频播放倍数。
  5.     }

示例代码

  2.     var speedPlayer=api.require('speedPlayer');
  3.     speedPlayer.getRate(function(ret,err){
  4.         alert(JSON.stringify(ret));
  5.     })

可用性

iOS系统，Android系统

可提供的1.0.0及更高版本

fullscreen

全屏显示

fullscreen()

示例代码

  2.     var speedPlayer=api.require('speedPlayer');
  3.     speedPlayer.fullscreen()

可用性

iOS系统，Android系统

可提供的1.0.0及更高版本

cancelFullscreen

取消全屏显示

cancelFullscreen()

示例代码

  2.     var speedPlayer=api.require('speedPlayer');
  3.     speedPlayer.cancelFullscreen()

可用性

iOS系统，Android系统

可提供的1.0.0及更高版本

getVol

获取音量

getVol()

callback(ret, err)

ret：

  • 类型：JSON对象
  • 内部字段：
  2.     {    
  3.         cmd:"getVol",
  4.         data:0.5//当前视频声音。
  5.     }

示例代码

  2.     var speedPlayer=api.require('speedPlayer');
  3.     speedPlayer.getVol(function(ret,err){
  4.         alert(JSON.stringify(ret));
  5.     })

可用性

iOS系统，Android系统

可提供的1.0.0及更高版本

setVol

设置音量

setVol()

params

value

  • 类型：数值型
  • 描述：设置声音，范围0-1.0。

示例代码

  2.     var speedPlayer=api.require('speedPlayer');
  3.     speedPlayer.setVol({
  4.         value:0.5,
  5.     })

可用性

iOS系统，Android系统 可提供的1.0.0及更高版本

getBrightness

获取亮度

getVol()

callback(ret, err)

ret：

  • 类型：JSON对象
  • 内部字段：
  2.     {    
  3.         cmd:"getVol",
  4.         data:0.5//当前视频声音。
  5.     }

示例代码

  2.     var speedPlayer=api.require('speedPlayer');
  3.     speedPlayer.getBrightness(function(ret,err){
  4.         alert(JSON.stringify(ret));
  5.     })

可用性

iOS系统，Android系统

可提供的1.0.0及更高版本

setBrightness

设置亮度

setBrightness()

params

value

  • 类型：数值型
  • 描述：设置亮度，范围0-1.0。

示例代码

  2.     var speedPlayer=api.require('speedPlayer');
  3.     speedPlayer.setBrightness({
  4.         value:0.5,
  5.     })

可用性

iOS系统，Android系统 可提供的1.0.0及更高版本

start

继续播放

start()

示例代码

  2.     var speedPlayer=api.require('speedPlayer');
  3.     speedPlayer.start()

可用性

iOS系统，Android系统

可提供的1.0.0及更高版本