#  Video 视频播放器

### 介绍

原生video实现的视频播放器

### 安装

``` javascript
import { createApp } from 'vue';
import { Video } from '@nutui/nutui';

const app = createApp();
app.use(Video);
```

## 代码演示

### 基础用法

```html
<nut-video
  :source="source"
  :options="options"
  @play="play"
  @pause="pause"
  @playend="playend">
</nut-video>
```

```javascript
setup() {
    const state = reactive({
      source: {
        src: "https://storage.jd.com/about/big-final.mp4?Expires=3730193075&AccessKey=3LoYX1dQWa6ZXzQl&Signature=ViMFjz%2BOkBxS%2FY1rjtUVqbopbJI%3D",
        type: "video/mp4",
      },
      options: {
        controls: true,
      },
    });
    const play = (elm: any) => console.log('play', elm);
    const pause = (elm: any) => console.log('pause', elm);
    const playend = (elm: any) => console.log('playend', elm);

    return { play, pause, playend, ...toRefs(state) };
}
```

### 自动播放
autoplay 属性设置视频自动播放
```html
<nut-video :source="source" :options="options"></nut-video>
```

```javascript
setup() {
    const state = reactive({
      source: {
        src: 'https://storage.jd.com/about/big-final.mp4',
        type: 'video/mp4'
      },
      options: {
        autoplay: true,
        muted: true,
        controls: true
      },
    });

    return { ...toRefs(state) };
}
```

### 初始化静音
muted属性设置视频初始化静音
```html
<nut-video :source="source" :options="options"></nut-video>
```

```javascript
setup() {
    const state = reactive({
      source: {
        src: 'https://storage.jd.com/about/big-final.mp4',
        type: 'video/mp4'
      },
      options: {
        muted: true,
        controls: true
      },
    });

    return { ...toRefs(state) };
}
```

### 视频封面海报设置
poster 属性设置视频海报
```html
<nut-video :source="source" :options="options"></nut-video>
```

```javascript
setup() {
    const state = reactive({
      source: {
        src: 'https://storage.jd.com/about/big-final.mp4',
        type: 'video/mp4'
      },
      options: {
        controls: true,
        poster: 'https://img12.360buyimg.com/ling/s345x208_jfs/t1/168105/33/8417/54825/603df06dEfcddc4cb/21f9f5d0a1b3dad4.jpg.webp'
      },
    });

    return { ...toRefs(state) };
}
```

### 行内播放
playsinline 属性设置移动端视频行内播放，阻止新打开页面播放（兼容 ios，兼容部分安卓机）
```html
<nut-video :source="source" :options="options"></nut-video>
```

```javascript
setup() {
    const state = reactive({
      source: {
        src: 'https://storage.jd.com/about/big-final.mp4',
        type: 'video/mp4'
      },
      options: {
        playsinline: true,
        controls: true,
      },
    });

    return { ...toRefs(state) };
}
```

### 视频背景图
当设置视频为背景图时需要将 muted 静音、 disabled 禁止操作、loop 循环播放、autoplay 自动播放设置为 true，移动端需要设置 playsinline 行内展示
```html
<nut-video :source="source" :options="options"></nut-video>
```

```javascript
setup() {
    const state = reactive({
      source: {
        src: 'https://storage.jd.com/about/big-final.mp4',
        type: 'video/mp4'
      },
      options: {
        controls: false,
        autoplay: true,
        muted: true,
        disabled: true,
        playsinline: true,
        loop: true
      },
    });

    return { ...toRefs(state) };
}
```

### 视频切换
当视频地址发生变化时，重置视频
```html
<nut-video :source="source"></nut-video>
<nut-button type="primary" @click="changeVideo">切换视频</nut-button>
```

```javascript
setup() {
    const state = reactive({
      source: {
        src: 'https://storage.jd.com/about/big-final.mp4',
        type: 'video/mp4'
      },
    });
    const changeVideo = () => {
      state.source1 = {
        src: 'https://vjs.zencdn.net/v/oceans.mp4',
        type: 'video/mp4'
      };
    };

    return { ...toRefs(state), changeVideo };
}
```


## API

### Props

| 字段                | 说明                                       | 类型    | 默认值   |
| ------------------- | ------------------------------------------ | ------- | -------- |
| source             | 视频地址和类型设置                         | Object   | -        |
| options             | 控制视频播放属性                           | Object  | required |
| options.autoplay    | 是否自动播放                               | Boolean | false    |
| options.poster      | 海报设置                                   | String  | -        |
| options.loop        | 是否循环播放                               | Boolean | false    |
| options.controls    | 是否展示操作栏                             | Boolean | true     |
| options.muted       | 是否静音                                   | Boolean | false    |
| options.volume      | 音量控制                                   | Number  | 0.5      |
| options.disabled    | 禁用操作（如循环播放的背景图，禁止操作）   | Boolean | false    |
| options.playsinline | 是否设置为行内播放元素（解决安卓兼容问题） | Boolean | false    |

### Events

| 事件名称 | 说明         | 回调参数 |
| -------- | ------------ | -------- |
| play     | 播放         | --       |
| pause    | 暂停         | --       |
| playend  | 播放完成回调 | --       |