@shijiu/jsview-vue 0.9.359-alpha.0 → 0.9.422

package/utils/JsViewPlugin/JsvPlayer/JsvMedia.js

@@ -1,39 +1,92 @@
 /* eslint-disable no-prototype-builtins */
 
 let MediaPluginInfo={
-    //downloadUrl:"http://192.168.0.34:8080/plugin/JsvPlayer-3.0.zip", //插件下载地址
+    //downloadUrl:"http://192.168.0.37:8080/plugin/JsvPlayer-6.0.zip", //插件下载地址
     packageName:"com.qcode.jsvplayer",
     name:"播放器插件",
-    version:"1.1.2",  //插件需要的最低版本号
-    versionCodeMin:112,
-    versionCodeMax:112,
+    version:"1.3.5",  //插件需要的最低版本号
+    versionCodeMin:135,
+    versionCodeMax:135,
     bridgeName:"jsvPlayerBridge", //插件bridge注册到jsview的名称
     className:"com.qcode.jsvplayer.JsvPlayer",  //插件初始化类名称
     initMethod:"createInstance",   //插件初始化方法
     listener:"top.JsvPlayerPluginLoadResult",  //插件加载结果回调
-    //md5:"bf6ee4f3726527755b7d9b08d4975adb"
-    // debug: true,
+    listener2: "top.JsvPlayerPluginStatus",
+    // debug:true,
+    // md5:"9fca9d2dc29468d332961b0be3e8081e"
 };
 
-var mediaArray = []
+function reconfigMediaPluginInfo(){
+    if(typeof window.jJsvRuntimeBridge!=='undefined' && window.jJsvRuntimeBridge && typeof window.jJsvRuntimeBridge.getPluginBaseUrl !== "undefined"){
+        let plugin_base_url = window.jJsvRuntimeBridge.getPluginBaseUrl();
+        if(plugin_base_url){
+            MediaPluginInfo.downloadUrl = (plugin_base_url[plugin_base_url.length-1]==="/"?plugin_base_url:(plugin_base_url+"/"))+MediaPluginInfo.packageName+"/JsvPlayer-135.zip?md5=1056e2e32f8a91e2dfef86d86200da53";
+        }
+    }
+}
+
+var mediaArray = [];
+
+var pluginLoadListener = [];
 
-var pluginLoading = false;
+/** 
+ * 0：未加载；
+ * 1：开始加载；
+ * 2：加载旧插件；
+ * 3：加载新插件；
+ * 4：加载成功；
+ * 5：加载失败。
+*/
+var pluginLoadState = 0; 
+
+window.top.JsvPlayerPluginStatus = function(status){
+    console.log("JsvPlayerPluginStatus: "+status);
+    let ret = JSON.parse(status);
+    
+    let plugin_status = 2;
+    if(ret && ret.first_load){
+        pluginLoadState = 3;
+        plugin_status = 3;
+    }else{
+        pluginLoadState = 2;
+    }
+
+    for(let i=0; i<pluginLoadListener.length; i++){
+        pluginLoadListener[i](plugin_status);
+    }
+}
 
 window.top.JsvPlayerPluginLoadResult = function (result) {
-    console.log(result);
-    for(var i=0; i<mediaArray.length; i++){
+    console.log("JsvPlayerPluginLoadResult: "+result);
+    var ret_obj = JSON.parse(result)
+    let plugin_status = 1;
+    if(ret_obj && (ret_obj.status === 4 || ret_obj.status === 1)){
+        pluginLoadState = 4;
+        plugin_status = 4;
+    }else if(ret_obj && ret_obj.status === -12){
+        pluginLoadState = 5;
+        plugin_status = 5;
+    }else{
+        pluginLoadState = 5;
+    }
+    
+    for(let i=0; i<mediaArray.length; i++){
         mediaArray[i].buildPlatformInstance();
     }
+
+    for(let i=0; i<pluginLoadListener.length; i++){
+        pluginLoadListener[i](plugin_status);
+    }
 }
 
 window.top.CreatePlayerResult = function (result) {
-    console.log(result);
+    console.log("CreatePlayerResult: "+result);
     let result_obj = JSON.parse(result);
     if(result_obj.code == 0){
         for(var i=0; i<mediaArray.length; i++){
             if(mediaArray[i].key === result_obj.key){
                 mediaArray[i].initPlayer();
-                break;
+               break;
             }
         }
     }else{
@@ -41,6 +94,69 @@ window.top.CreatePlayerResult = function (result) {
     }
 }.bind(this);
 
+/**
+ * listener回调处理中参数信息的说明:
+ * 插件加载状态回调。
+ * 回调函数的参数定义如下：
+ * 1:无法正常加载插件。
+ * 2:正在加载旧插件，此时插件加载过程很短，可以不用出现用户提示界面。
+ * 3:正在加载新插件，此时插件需要经历下载、解压等过程，用时较长，可以考虑给用户相关提示。
+ * 4:插件加载完成。
+ * 5:已加载不同版本的插件，此版本无法加载。
+ * 
+ * 备注：不管插件加载处于什么状态，都可以正常使用播放器组件，播放器对象在插件未加载完成的情况下，会把相关状态保存，等完成加载后再自动下发。
+ */
+function globalLoadJsvPlayerPlugin(listener){
+    console.log("globalLoadJsvPlayerPlugin");
+    let plugin_status = 0;
+    if(typeof window.jPluginManagerBridge==='undefined' || !window.jPluginManagerBridge){
+        plugin_status = 1;
+    }else if(pluginLoadState === 2){
+        plugin_status = 2;
+    }else if(pluginLoadState === 3){
+        plugin_status = 3;
+    }else if(pluginLoadState === 4){
+        plugin_status = 4;
+    }else if(pluginLoadState === 5){
+        plugin_status = 1;
+    }
+
+    if(plugin_status !== 0){
+        if(typeof listener !== "undefined" && listener){
+            setTimeout(()=>{listener(plugin_status)}, 0);
+        }
+        return;
+    }
+
+    if(typeof listener !== "undefined" && listener){
+        pluginLoadListener.push(listener);
+    }
+
+    if(pluginLoadState > 0){
+        return;
+    }
+    pluginLoadState = 1;
+
+    reconfigMediaPluginInfo();
+
+    window.jPluginManagerBridge.LoadPlugin(JSON.stringify(MediaPluginInfo));
+}
+
+/**
+ * 根据key查询是否已经有Media对象了，如果已经有了，就不需要再创建，而是调用setRef接口将当前的对象索引+1。
+ * @param {string} key Player索引。 
+ * @returns {object} Media对象。
+ */
+function findMediaObjectByKey(key){
+    for(var i=0; i<mediaArray.length; i++){
+        if(mediaArray[i].key === key){
+            return mediaArray[i];
+        }
+    }
+
+    return null;
+}
+
 class JsvBaseMedia {
     constructor(type, hole_id, player_type, key, background, design_map_width) {
         this.state = {
@@ -48,31 +164,35 @@ class JsvBaseMedia {
 			paused: true,
 			repeat: false,
             enablePlayer: false,
-            autoPlay: false,
+            autoplay: false,
 			startTime: 0.0,
+            currentTime: 0.0,
 			aspectRatio: "origin",
+            keepLastFrame: false,
         };
         
 		this.local = {
 			currentTime: 0.0,
 			playableDuration: 0.0,
 			duration: 0.0,
-
 			isRenderable: false,
         };
         
         this.type = type;
-        this._AutoPlay = false;
         this.playerCreate = false;
         this.key = key;
         this.background = background;
         this.holeId = hole_id;
+        this.holeIdModify = hole_id;
         this.playerType = player_type;
         this.designMapWidth = design_map_width;
+        this.channelID = -1;
+        this.ref = 1;
+        this._onEvent = this.onEvent.bind(this);
 
         let found = false;
         for(let i=0; i<mediaArray.length; i++){
-            if(mediaArray[i].key === key){
+            if(mediaArray[i].key === this.key){
                 found = true;
                 break;
             }
@@ -83,83 +203,126 @@ class JsvBaseMedia {
         }
 
         if(typeof window.jsvPlayerBridge=='undefined' || !window.jsvPlayerBridge){
-            this.loadJsvPlayerPlugin();
+            globalLoadJsvPlayerPlugin();
         }else{
             this.buildPlatformInstance();
         }
     }
 
-    loadJsvPlayerPlugin(){
-        if(typeof window.jPluginManagerBridge=='undefined' || !window.jPluginManagerBridge){
-            return;
-        }
-
-        if(pluginLoading){
-            return;
-        }
-
-        pluginLoading = true;
-        window.jPluginManagerBridge.LoadPlugin(JSON.stringify(MediaPluginInfo));
-    }
-
+    /**
+     * 私有接口，外部不需要调用此接口。
+     */
     buildPlatformInstance() {
         if(typeof window.jsvPlayerBridge=='undefined' || !window.jsvPlayerBridge){
             console.log("no jsvPlayerBridge");
             return;
         }
 
-        let view_type = 0;
+        let share_view = true;
 
-        let result = window.jsvPlayerBridge.CreatePlayer(this.key, this.holeId, this.background, this.designMapWidth, view_type, this.playerType, "top.CreatePlayerResult");
+        let result = window.jsvPlayerBridge.CreatePlayer(this.key, this.holeId, this.background, this.designMapWidth, share_view, this.playerType, "top.CreatePlayerResult");
         if(result > 0){
             this.initPlayer();
         }
     }
 
+    /**
+     * 私有接口，外部不需要调用此接口。
+     */
     initPlayer(){
+        if(this.playerCreate)
+            return;
+
         this.playerCreate = true;
 
-        window.JMD.subscribe(this.key, function (event) {
-            console.log("event data:" + event);
-            let obj = JSON.parse(event);
-            let event_obj = JSON.parse(obj.param);
-            this.onEvent(event_obj.event, event_obj.data);
-        }.bind(this));
+        window.JMD.subscribe(this.key, this._onEvent);
 
         console.log("InitPlayer:1");
+        if(this.holeIdModify !== this.holeId){
+            window.jsvPlayerBridge.setHoleID(this.key, this.holeIdModify);
+            this.holeId = this.holeIdModify;
+        }
+
         if(this.state["src"])
             this.setState("src", this.state["src"], "string");
-        
-        // console.log("InitPlayer:2"); 
-        // this.setState("style", JSON.stringify(this.style), "string");
+        else if(this.channelID >= 0){
+            this.joinChannel(this.channelID);
+        }
 
         console.log("InitPlayer:3");
-        if(this.state["currentTime"])
+        if(this.state["currentTime"]){
             this.setState("currentTime", this.state["currentTime"], "number");
+        }else if(this.state["startTime"]){
+            this.setState("startTime", this.state["startTime"], "number");
+        }
 
         if(this.state["paused"] == false){
             this.setState("paused", this.state["paused"], "boolean");
         }
+
+        if(this.state["autoplay"]){
+            this.setState("autoplay", this.state["autoplay"], "boolean");
+        }
+
+        if(this.state["repeat"]){
+            this.setState("repeat", this.state["repeat"], "boolean");
+        }
+
+        if(this.state["muted"]){
+            this.setState("muted", this.state["muted"], "boolean");
+        }
+    }
+
+    /**
+     * 当使用一个已有的Media对象时，需要通过这个接口追加一个ref，在调用releasePlayer接口释放时，会ref--，当ref==0才真正释放播放器实例。
+     */
+    setRef(){
+        this.ref++;
     }
 
+    /**
+     * 释放播放器，一般不需要应用逻辑调用，在JsvPlayer高阶组件unmounted处理时调用此接口释放。
+     */
     releasePlayer(){
-        if(typeof window.jsvPlayerBridge != "undefined" && window.jsvPlayerBridge){
-            window.jsvPlayerBridge.ReleasePlayer(this.key, this.holeId, this.background);
-        }
+        this.ref--;
+        if(this.ref === 0){
+            window.JMD.unsubscribe(this.key, this._onEvent)
+            if(typeof window.jsvPlayerBridge != "undefined" && window.jsvPlayerBridge){
+                window.jsvPlayerBridge.ReleasePlayer(this.key);
+            }
 
-        for(let i=0; i<mediaArray.length; i++){
-            if(mediaArray[i].key === this.key){
-                mediaArray.splice(i, 1);
-                break;
+            for(let i=0; i<mediaArray.length; i++){
+                if(mediaArray[i].key === this.key){
+                    mediaArray.splice(i, 1);
+                    break;
+                }
             }
         }
     }
 
-    onEvent(event, data){
-       switch(event){
+    setHoleID(hole_id){
+        
+        if(this.playerCreate){
+            this.holeId = hole_id;
+            this.holeIdModify = hole_id;
+            window.jsvPlayerBridge.setHoleID(this.key, hole_id);
+        }else{
+            this.holeIdModify = hole_id;
+        }
+    }
+
+    /**
+     * 私有接口，外部不需要调用此接口。
+     */
+    onEvent(event_str){
+        let obj = JSON.parse(event_str);
+        let event_obj = JSON.parse(obj.param);
+        let event = event_obj.event;
+        let data = event_obj.data;
+        switch(event){
             case "onProgress":
                 {
-                    console.log("onProgress:"+data);
+                    //console.log("onProgress:"+data);
                     if (this.local.isRenderable == false) {
                         return;
                     }
@@ -167,7 +330,7 @@ class JsvBaseMedia {
                     let time_update = this.local.currentTime != data.currentTime;
                     this.local.currentTime = data.currentTime;
                     if (time_update && this.hasOwnProperty("ontimeupdate")) {
-                        this["ontimeupdate"]();
+                        this["ontimeupdate"](data.currentTime);
                     }
 
                     let progress_update = this.local.playableDuration != data.playableDuration;
@@ -221,8 +384,9 @@ class JsvBaseMedia {
                         MEDIA_ERR_NETWORK: 2,
                         MEDIA_ERR_DECODE: 3,
                         MEDIA_ERR_SRC_NOT_SUPPORTED: 4,
+                        MEDIA_ERR_ONLY_ONE_4K: 5,
                     };
-                    const platform_error = data.error.extra;
+                    const platform_error = data.error.what;
                     let e = Error.MEDIA_ERR_ABORTED;
                     switch (platform_error) {
                         case -1004 : // MediaPlayer.MEDIA_ERROR_IO
@@ -234,6 +398,8 @@ class JsvBaseMedia {
                         case -1010 : // MediaPlayer.MEDIA_ERROR_UNSUPPORTED
                             e = Error.MEDIA_ERR_SRC_NOT_SUPPORTED;
                             break;
+                        case -10001:
+                            e = Error.MEDIA_ERR_ONLY_ONE_4K;
                     }
                     this["onerror"](e);
                 }
@@ -242,7 +408,7 @@ class JsvBaseMedia {
                 console.log("onSeek:"+data);
                 this.local.isRenderable = false;
                 if(this.hasOwnProperty("onseeking")){
-                    this["onseeking"](data);
+                    this["onseeking"]();
                 }
                 break;
             case "onEventExt":
@@ -299,10 +465,16 @@ class JsvBaseMedia {
        }
     }
 
+    /**
+     * 属性，boolean类型，不支持读取，true表示自动播放。
+     */
     set autoplay(value) {
         this.setState("autoplay", value, "boolean");
     }
 
+    /**
+     * 属性，double类型，当前时间，单位秒，set用于seek操作（起播后）或者设置起播时间（起播前），get用于读取当前时间。
+     */
     get currentTime() {
         let result = this.getProperty("currentTime");
         if(result != null)
@@ -316,6 +488,9 @@ class JsvBaseMedia {
 		this.setState("seek", value, "number");
     }
 
+    /**
+     * 属性，double类型，总时长，单位秒，只支持读取。
+     */
     get duration() {
         let result = this.getProperty("duration");
         if(result != null)
@@ -324,6 +499,9 @@ class JsvBaseMedia {
         return 0;
     }
 
+    /**
+     * 属性，boolean类型，不支持读取，true表示循环播放。
+     */
     set loop(value) {
         if(typeof value == "boolean") {
             this.setState("repeat", value, "boolean");
@@ -334,6 +512,9 @@ class JsvBaseMedia {
         }
     }
 
+    /**
+     * 属性，boolean类型，设置和获取静音状态。
+     */
     get muted() {
         return this.getState("muted");
     }
@@ -342,6 +523,9 @@ class JsvBaseMedia {
         this.setState("muted", value, "boolean");
     }
 
+    /**
+     * 属性，boolean类型，当前pause状态，只支持读取。
+     */
     get paused() {
         let result = this.getProperty("paused");
         if(result != null)
@@ -350,14 +534,21 @@ class JsvBaseMedia {
         return true;
     }
 
+    /**
+     * 属性，float类型，设置或者读取倍速播放，通常的值是0.5、0.75、1.0、1.25、1.5、2.0、3.0。
+     */
     get playbackRate() {
         return this.getState("rate");
     }
 
     set playbackRate(value) {
+        console.log("playbackRate")
         this.setState("rate", value, "number");
     }
 
+    /**
+     * 已废弃。
+     */
     get preload() {
 		return (this.enablePlayer ? 'auto' : 'none');
     }
@@ -368,10 +559,17 @@ class JsvBaseMedia {
 		}
 	}
 
+
+    /**
+     * 属性，string类型，播放地址，不支持读取。
+     */
     set src(value) {
-        this.setState("src", value, "string");
+        this.setSrc(value, null, 1)
     }
 
+    /**
+     * 属性，float类型，播放器音量，0-1.0，只影响当前播放器实例。
+     */
     get volume() {
         let result = this.getProperty("volume");
         if(result != null)
@@ -384,7 +582,9 @@ class JsvBaseMedia {
         this.setState("volume", value, "number");
     }
 
-    // Extension beyond HTML5
+    /**
+     * 属性，double类型，起播时间，单位秒，可使用currentTime代替。
+     */
 	get startTime() {
 		return this.getState("startTime");
 	}
@@ -393,22 +593,70 @@ class JsvBaseMedia {
 		this.setState("startTime", value, "number");
     }
     
+    /**
+     * 属性，double类型，可播放时长，总时长-已播放时长，只支持读取。
+     */
     get playableDuration() {
 		return this.local.playableDuration;
     }
     
+    /**
+     * 属性，boolean类型，true表示关闭timeupdate事件上报。
+     */
     set timeupdateless(value) {
         this.setState("timeUpdateLess", !!value, "boolean");
     }
 
+    /**
+     * 属性，boolean类型，true表示保留最后一帧，false表示不保留。
+     */
+    set keepLastFrame(value) {
+        this.setState("keepLastFrame", !!value, "boolean");
+    }
+
+    /**
+     * 设置播放地址。
+     * @param {string} url 播放地址。
+     * @param {string} head 网络请求的head信息，可以为NULL。
+     * @param {int} type 类型，1表示点播，2表示直播，3表示时移，默认1。
+     * @param {double} timeShift 时移时间，只有在type=3时才有效，表示从当前时间时移多长时间，单位秒。
+     */
+    setSrc(url, head, type, timeShift){
+        let src = {};
+        src.url = url;
+        if(head){
+            src.head = head;
+        }
+        if(type){
+            src.type = type;
+        }else{
+            src.type = 1;
+        }
+        if(type === 3 && timeShift){
+            src.timeShift = timeShift;
+        }
+        this.setState("src", JSON.stringify(src), "string");
+    }
+
+    /**
+     * 添加监听事件。
+     * @param {string} type 事件类型。
+     * @param {callback} listener 事件处理函数。
+     */
     addEventListener(type, listener) {
         this['on' + type] = listener;
     }
 
+    /**
+     * 重新加载视频流，初始化播放器。
+     */
     load() {
 		this.setState("enablePlayer", true, "boolean");
     }
     
+    /**
+     * 暂停
+     */
     pause() {
         this.setState("paused", true, "boolean");
         if (this.hasOwnProperty("onpause")) {
@@ -416,6 +664,9 @@ class JsvBaseMedia {
 		}
     }
 
+    /**
+     * 播放
+     */
     play() {
         this.setState("paused", false, "boolean");
         if (this.hasOwnProperty("onplay")) {
@@ -423,12 +674,174 @@ class JsvBaseMedia {
 		}
     }
 
+    /**
+     * 停止视频流。
+     */
     unload() {
         this.setState("paused", true, "boolean");
         this.local.isRenderable = false;
 		this.setState("enablePlayer", false, "boolean");
 	}
 
+    /**
+     * 要求终端访问指定的频道，并立即返回。对由本地设置为跳过的频道，也返回-1。
+     * 频道地址为通过 CTCSetConfig 设置的频道列表中的地址：
+     * 如频道地址为 igmp：//的组播地址，则加入组播频道，播放器开始播放组播频道，并处理相应的时移等功能；
+     * 如频道地址为 rtsp：//的单播地址，则连接单播频道，播放器开始播放；
+     * 如频道地址为 http：//的地址，则浏览器直接发起请求，访问该页面。
+     * 【注】：在加入一个频道之前已经加入另外一个频道，需先调用 leaveChannel 方法离开前一个频道。
+     * @param {int} mixNo 用户频道号。
+     * @returns {int} 0，表示成功；-1：表示频道号无效。
+     */
+    joinChannel(mixNo){
+        if(mixNo <= 0){
+            return -1;
+        }
+
+        if(this.playerCreate){
+            return window.jsvPlayerBridge.JoinChannel(this.key, mixNo);
+        }else{
+            this.channelID = mixNo;
+        }
+
+        this.setState("paused", false, "boolean");
+        return 0;
+    }
+
+    /**
+     * 要求终端离开指定的频道，并立即返回。
+     * 如原频道地址为 igmp：//的组播地址，则立即离开组播频道，播放器停止播放组播频道，并断开相应的时移连接；
+     * 如频道地址为 rtsp：//的单播地址，则断开单播频道，播放器停止播放；
+     * 如频道地址为 http：//的地址，则浏览器不作操作。
+     * 【注】：本方法只用于离开通过 joinChannel 方法加入的频道。
+     * @returns {int} 0，表示成功；-1：表示频道号无效。
+     */
+    leaveChannel(){
+        let ret = 0;
+        if(this.playerCreate){
+            ret = window.jsvPlayerBridge.leaveChannel(this.key);
+        }
+
+        this.channelID = -1;
+        return ret;
+    }
+
+    // /**
+    //  * 快进。
+    //  * @param {float} speed 2至32
+    //  */
+    // fastForward(value) {
+    //     this.setState("fastForward", value, "number");
+    // }
+
+    // /**
+    //  * 快退。
+    //  * @param {float} speed -2至-32
+    //  */
+    // fastRewind(value) {
+    //     this.setState("fastForward", value, "number");
+    // }
+
+    /**
+     * @return {int} 当前音量，0-100。
+     * */
+    getGlobalVolume(){
+        if(typeof window.jsvPlayerBridge !== "undefined"){
+            return window.jsvPlayerBridge.getGlobalVolume(100);
+        }
+
+        return 0;
+    }
+
+    /**
+     * 设置系统音量。
+     * @param {int} volume 0-100，音量值。
+     * @param {int} flags 1表示显示音量调节UI；4表示使用提示音；5表示同时显示音量调节UI和使用提示音。
+     * */
+    setGlobalVolume(volume, flags){
+        if(typeof window.jsvPlayerBridge !== "undefined"){
+            return window.jsvPlayerBridge.setGlobalVolume(volume, typeof flags!="undefined"?flags:0, 100);
+        }
+    }
+
+    /**
+     * 调整系统音量，一次设置一个步长。
+     * @param {int} direction 1增大音量；-1减小音量。
+     * @param {int} flags FLAG_SHOW_UI(1)表示显示音量调节UI；FLAG_PLAY_SOUND(4)表示使用提示音。两个值可以是或的关系。
+     * */
+    adjustGlobalVolume(direction, flags){
+        if(typeof window.jsvPlayerBridge !== "undefined"){
+            return window.jsvPlayerBridge.adjustGlobalVolume(direction, typeof flags!="undefined"?flags:0);
+        }
+    }
+
+    /**
+     * 设置系统静音状态。
+     * @param {boolean} status true表示静音，false表示取消静音。
+     * @param {int} flags FLAG_SHOW_UI(1)表示显示音量调节UI；FLAG_PLAY_SOUND(4)表示使用提示音。两个值可以是或的关系。android 6.0（包含）以上有效。
+     * */
+     setGlobalMuted(status, flags){
+        if(typeof window.jsvPlayerBridge !== "undefined"){
+            console.log("setMuted:"+status);
+            window.jsvPlayerBridge.setGlobalMuted(status,  typeof flags!="undefined"?flags:0);
+        }
+     }
+
+    /**
+     * 获取系统静音状态。
+     * @return {boolean} true表示静音，false表示非静音。
+     * */
+    getGlobalMutedStatus(){
+        if(typeof window.jsvPlayerBridge !== "undefined"){
+            return window.jsvPlayerBridge.getGlobalMutedStatus();
+        }  
+    }
+
+    /**
+     * 回到视频的开头。
+     */
+    gotoStart(){
+        if(this.playerCreate){
+            window.jsvPlayerBridge.gotoStart(this.key);
+        }else{
+            this.state["currentTime"] = 0;
+        }
+    }
+
+    /**
+     * 到达视频的末尾。
+     */
+     gotoEnd(){
+        if(this.playerCreate){
+            window.jsvPlayerBridge.gotoEnd(this.key);
+        }
+    }
+
+    /**
+     * 获取timeShift状态，包含是否支持时移以及最大时移时间。
+     * @returns {JsonObject} 包含两个字段：1、timeShift，boolean类型，true表示支持时移；2、timeShiftLength，int类型，最大时移时长。
+     */
+    getTimeShiftInfo(){
+        let result = this.getProperty("timeShift");
+        if(result != null && result != "")
+            return JSON.parse(result);
+
+        return null;
+    }
+
+    /**
+     * 设置时移时间。
+     * @param {double} time，值为从当前时间计算向前移动了多长时间，单位秒。
+     */
+    setTimeShift(time){
+        if(this.playerCreate){
+            window.jsvPlayerBridge.setTimeShift(this.key, time);
+        }
+    }
+
+    /**
+     * 私有接口，外部不需要调用此接口。
+     */
     setState(key, value, type) {
         if (typeof(value) !== type) {
             console.warn("invalid paramter type to set " + key + ". value is not " + type);
@@ -446,6 +859,9 @@ class JsvBaseMedia {
         }
     }
 
+    /**
+     * 私有接口，外部不需要调用此接口。
+     */
     getState(key) {
         let value = this.state[key];
         console.log("get " + key + " = " + value);
@@ -457,6 +873,9 @@ class JsvBaseMedia {
         return value;
     }
 
+    /**
+     * 私有接口，外部不需要调用此接口。
+     */
     getProperty(key){
         if (this.playerCreate && typeof window.jsvPlayerBridge != "undefined") {
             let result_str = window.jsvPlayerBridge.GetProperty(this.key, key);
@@ -472,17 +891,6 @@ class JsvBaseMedia {
 
         return null;
     }
-
-    // setStyle(){
-    //     if(this.styleHandler != null){
-    //         clearTimeout(this.styleHandler);
-    //         this.styleHandler = null;
-    //     }
-
-    //     this.styleHandler = setTimeout(()=>{
-    //         this.setState("style", JSON.stringify(this.style), "string");
-    //     }, 0);
-    // }
 }
 
 class JsvMedia extends JsvBaseMedia {
@@ -505,14 +913,17 @@ class JsvMediaVideo extends JsvMedia {
         this.state.aspectRatio = 'origin'; // 'origin', 'full', '16:9', '4:3',
     }
 
-    // get poster() {
-    //     console.log("Video.poster() TODO");
-    // }
-
+    /**
+     * 属性，string类型，设置海报地址，未实现。
+     */
     set poster(value) {
         console.log("Video.poster() TODO");
     }
 
+    /**
+     * 属性，string类型，设置和读取显示模式。
+     * full（fill模式）表示拉升至充满显示区域；origin（contain模式）表示原始比例缩放至宽或高和显示区域相等（不超过显示区域）；x:y表示按照按照指定比例显示。
+     */
     get videoAspectRatio() {
         return this.getState("aspectRatio");
     }
@@ -521,52 +932,35 @@ class JsvMediaVideo extends JsvMedia {
         this.setState("aspectRatio", value, "string");
     }
 
+    /**
+     * 属性，int类型，只读，获取视频的宽。
+     */
     get videoHeight() {
         return this.getState("videoHeight");
     }
 
+    /**
+     * 属性，int类型，只读，获取视频的宽。
+     */
     get videoWidth() {
         return this.getState("videoWidth");
     }
+}
 
-    // get left() {
-    //     return this.style.left;
-    // }
-
-    // set left(value) {
-    //     this.style.left = value;
-    //     this.setStyle();
-    // }
-
-    // get top() {
-    //     return this.style.top;
-    // }
-
-    // set top(value) {
-    //     this.style.top = value;
-    //     this.setStyle();
-    // }
-
-    // get width() {
-    //     return this.style.width;
-    // }
-
-    // set width(value) {
-    //     this.style.width = value;
-    //     this.setStyle();
-    // }
-
-    // get height() {
-    //     return this.style.height;
-    // }
-
-    // set height(value) {
-    //     this.style.height = value;
-    //     this.setStyle();
-    // }
+/**
+ * 获取播放器能力集，当前主要是对4K多播放器的支持以及H265解码能力的支持。
+ * @return {string} 能力集数组。
+ */
+function getJsvPlayerCapabilitySet(){
+    if(typeof window.jsvPlayerBridge !== "undefined"){
+        return window.jsvPlayerBridge.getCapabilitySet();
+    }
 }
 
 export {
     JsvMediaVideo,
-    JsvMediaAudio
+    JsvMediaAudio,
+    globalLoadJsvPlayerPlugin,
+    findMediaObjectByKey,
+    getJsvPlayerCapabilitySet
 }