diff --git a/packages/artplayer-document/docs/zh-cn/Properties.md b/packages/artplayer-document/docs/zh-cn/Properties.md index c59d6464b..79a435faa 100644 --- a/packages/artplayer-document/docs/zh-cn/Properties.md +++ b/packages/artplayer-document/docs/zh-cn/Properties.md @@ -75,9 +75,11 @@ art.on('ready', () => { ## seek - 类型: `Setter` +- 参数: `Number` 视频时间跳转,单位秒 +
▶ Run Code
```js @@ -94,6 +96,7 @@ art.on('ready', () => { ## forward - 类型: `Setter` +- 参数: `Number` 视频时间快进,单位秒 @@ -113,6 +116,7 @@ art.on('ready', () => { ## backward - 类型: `Setter` +- 参数: `Number` 视频时间快退,单位秒 @@ -136,6 +140,7 @@ art.on('ready', () => { ## volume - 类型: `Setter/Getter` +- 参数: `Number` 设置和获取视频音量,范围在:`[0, 1]` @@ -148,7 +153,99 @@ var art = new Artplayer({ }); art.on('ready', () => { + console.info(art.volume); art.volume = 0.5; - console.log(art.volume); + console.info(art.volume); }) -``` \ No newline at end of file +``` + +## url + +- 类型: `Setter/Getter` +- 参数: `String` + +设置和获取视频地址 + +
▶ Run Code
+ +```js +var art = new Artplayer({ + container: '.artplayer-app', + url: '/assets/sample/video.mp4', +}); + +art.on('ready', () => { + console.info(art.url); + art.url = '/assets/sample/video.mp4?t=0'; + console.info(art.url); +}) +``` + +## muted + +- 类型: `Setter/Getter` +- 参数: `Boolean` + +设置和获取视频是否静音 + +
▶ Run Code
+ +```js +var art = new Artplayer({ + container: '.artplayer-app', + url: '/assets/sample/video.mp4', +}); + +art.on('ready', () => { + console.info(art.muted); + art.muted = true; + console.info(art.muted); +}) +``` + +## currentTime + +- 类型: `Setter/Getter` +- 参数: `Number` + +设置和获取视频当前时间,设置时间时和 `seek` 类似,但它不会触发额外的事件 + +
▶ Run Code
+ +```js +var art = new Artplayer({ + container: '.artplayer-app', + url: '/assets/sample/video.mp4', +}); + +art.on('ready', () => { + console.info(art.currentTime); + art.currentTime = 5; + console.info(art.currentTime); +}) +``` + +## duration + +- 类型: `Getter` + +获取视频时长 + +
▶ Run Code
+ +```js +var art = new Artplayer({ + container: '.artplayer-app', + url: '/assets/sample/video.mp4', +}); + +art.on('ready', () => { + console.info(art.duration); +}) +``` + +:::tip 提示 + +有的视频是没有时长的,例如直播中的视频或者没被解码完成的视频,这个时候获取的时长会是 `0` + +::: \ No newline at end of file