diff --git a/packages/artplayer-document/docs/zh-cn/Options.md b/packages/artplayer-document/docs/zh-cn/Options.md
index 89498c0f7..a54854173 100644
--- a/packages/artplayer-document/docs/zh-cn/Options.md
+++ b/packages/artplayer-document/docs/zh-cn/Options.md
@@ -759,6 +759,10 @@ var art = new Artplayer({
因为不同的移动设备存在多种差异和限制,所以本播放器默认在移动设备上使用原生方法挂载视频,假如你想在移动设备上使用本播放器,需要手动开启白名单
+白名单是一个数组类型,分别与 `window.navigator.userAgent` 进行匹配,只要其中一项匹配成功则启用播放器
+
+支持`字符串`匹配、`函数`匹配、`正则`匹配
+
▶ Run Code
```js
@@ -772,20 +776,181 @@ var art = new Artplayer({
});
```
-## switcher
+:::tip 提示
+
+假如希望全部类型的移动设备都启用播放器,设置 `whitelist` 为通配符 `['*']` 即可
+
+:::
## thumbnails
+- 类型: `Object`
+- 默认: `{}`
+
+在进度条上设置预览图
+
+| 属性 | 类型 | 描述 |
+| -------- | -------- | ---------- |
+| `url` | `String` | 预览图地址 |
+| `number` | `Number` | 预览图数量 |
+| `width` | `Number` | 预览图宽度 |
+| `height` | `Number` | 预览图高度 |
+| `column` | `Number` | 预览图列数 |
+
+▶ Run Code
+
+```js
+var art = new Artplayer({
+ container: '.artplayer-app',
+ url: '/assets/sample/video.mp4',
+ thumbnails: {
+ url: '/assets/sample/thumbnails.png',
+ number: 100,
+ width: 160,
+ height: 90,
+ column: 10,
+ },
+});
+```
+
## subtitle
+- 类型: `Object`
+- 默认: `{}`
+
+设置视频的字幕,支持字幕格式:`vtt`、`srt`、`ass`
+
+| 属性 | 类型 | 描述 |
+| ----------- | --------- | ---------------------------- |
+| `url` | `String` | 字幕地址 |
+| `style` | `Object` | 字幕样式 |
+| `encoding` | `String` | 字幕编码,默认 `utf-8` |
+| `bilingual` | `Boolean` | 是否双字幕样式,通过换行区分 |
+
+▶ Run Code
+
+```js
+var art = new Artplayer({
+ container: '.artplayer-app',
+ url: '/assets/sample/video.mp4',
+ subtitle: {
+ url: '/assets/sample/subtitle.srt',
+ encoding: 'utf-8',
+ bilingual: true,
+ style: {
+ color: '#03A9F4',
+ 'font-size': '30px',
+ },
+ },
+});
+```
+
## moreVideoAttr
+- 类型: `Object`
+- 默认: `{'controls': false,'preload': 'metadata'}`
+
+更多视频属性,这些属性将直接写入视频元素里
+
+▶ Run Code
+
+```js
+var art = new Artplayer({
+ container: '.artplayer-app',
+ url: '/assets/sample/video.mp4',
+ moreVideoAttr: {
+ 'webkit-playsinline': true,
+ playsInline: true,
+ },
+});
+```
+
## icons
+- 类型: `Object`
+- 默认: `{}`
+
+用于替换默认图标,支持 `Html` 字符串
+
+▶ Run Code
+
+```js
+var art = new Artplayer({
+ container: '.artplayer-app',
+ url: '/assets/sample/video.mp4',
+ icons: {
+ loading: '
',
+ state: '
',
+ play: '',
+ pause: '',
+ volume: '',
+ volumeClose: '',
+ subtitle: '',
+ screenshot: '',
+ setting: '',
+ fullscreen: '',
+ fullscreenWeb: '',
+ pip: '',
+ },
+});
+```
+
+## type
+
+- 类型: `String`
+- 默认: `''`
+
+用于指明视频的格式,需要配合 `customType` 一起使用,更多信息请访问 [第三方库](/document/zh-cn/libraries)
+
+默认视频的格式就是视频地址的后缀(如 `.flv`、`.mkv`、`.ts`),但有时候视频地地址没有正确的后缀,所以需要特别指明
+
+▶ Run Code
+
+```js
+var art = new Artplayer({
+ container: '.artplayer-app',
+ url: '/assets/sample/video.flv',
+ type: 'flv',
+});
+```
+
## customType
+- 类型: `Object`
+- 默认: `{}`
+
+通过视频的格式进行匹配,把视频解码权交给第三方程序进行处理,更多信息请访问 [第三方库](/document/zh-cn/libraries)
+
+▶ Run Code
+
+```js
+var art = new Artplayer({
+ container: '.artplayer-app',
+ url: '/assets/sample/video.flv',
+ customType: {
+ flv: function (video, url, art) {
+ // video: 视频dom元素
+ // url: 视频地址
+ // art: 当前实例
+ },
+ },
+});
+```
+
## lang
+- 类型: `String`
+- 默认: `navigator.language.toLowerCase()`
+
+默认显示语言,目前支持:`en`、`zh-cn`、`zh-tw`
+
+▶ Run Code
+
+```js
+var art = new Artplayer({
+ container: '.artplayer-app',
+ url: '/assets/sample/video.mp4',
+ lang: 'en',
+});
```
-```
diff --git a/packages/artplayer/src/index.js b/packages/artplayer/src/index.js
index d576ec8e8..f3ef694b4 100644
--- a/packages/artplayer/src/index.js
+++ b/packages/artplayer/src/index.js
@@ -109,6 +109,7 @@ export default class Artplayer extends Emitter {
url: '',
poster: '',
title: '',
+ type: '',
theme: '#f00',
volume: 0.7,
isLive: false,
diff --git a/packages/artplayer/src/scheme/index.js b/packages/artplayer/src/scheme/index.js
index 74b58beb9..e7552f16f 100644
--- a/packages/artplayer/src/scheme/index.js
+++ b/packages/artplayer/src/scheme/index.js
@@ -30,6 +30,7 @@ export default {
url: s,
poster: s,
title: s,
+ type: s,
theme: s,
lang: s,
volume: n,
diff --git a/packages/artplayer/types/artplayer.d.ts b/packages/artplayer/types/artplayer.d.ts
index 4d457eb9b..5fdd66553 100644
--- a/packages/artplayer/types/artplayer.d.ts
+++ b/packages/artplayer/types/artplayer.d.ts
@@ -20,6 +20,7 @@ export default class Artplayer {
url: string;
poster?: string;
title?: string;
+ type?: string;
theme?: string;
lang?: 'en' | 'zh-cn' | 'zh-tw';
volume?: number;