# 视频配置

## 示例代码

```typescript
new LinwitDocEditor({
    element: "#aiEditor",
    video: {
        customMenuInvoke: (editor: LinwitDocEditor) => {
        },
        uploadUrl: "https://your-domain/video/upload",
        uploadFormName: "video", //上传时的文件表单名称
        uploadHeaders: {
            "jwt": "xxxxx",
            "other": "xxxx",
        },
        uploader: (file, uploadUrl, headers, formName) => {
            //可自定义视频上传逻辑
        },
        uploaderEvent: {
            onUploadBefore: (file, uploadUrl, headers) => {
                //监听视频上传之前，此方法可以不用回任何内容，但若返回 false，则终止上传
            },
            onSuccess: (file, response) => {
                //监听视频上传成功
                //注意：
                // 1、如果此方法返回 false，则视频不会被插入到编辑器
                // 2、可以在这里返回一个新的 json 给编辑器
            },
            onFailed: (file, response) => {
                //监听视频上传失败，或者返回的 json 信息不正确
            },
            onError: (file, error) => {
                //监听视频上传错误，比如网络超时等
            },
        }
    },
})
```

- **customMenuInvoke**：自定义工具栏的 “视频” 按钮的点击行为，比如点击不是选择本地文件，而是弹出一个对话框等自定义行为。
- **uploadUrl**：视频上传的 URL 地址。
- **uploadHeaders**：视频上传自定义 Http 头信息，数据类型为 `Object` 或者 返回一个 `Object` 的方法（ `Function` ）。
- **uploader**：自定义上传逻辑，默认是通过 `fetch` 进行上传。
- **uploaderEvent**：配置视频上传事件监听

## 服务器响应

视频上传成功后，要求服务器必须返回如下内容，其中 errorCode 必须为 0；

```json
{
  "errorCode": 0,
  "data": {
    "src": "http://your-domain.com/video.mp4",
    "poster": "http://your-domain.com/poster.jpg"
  }
}
```

- src： 视频播放地址
- poster： 视频封面地址

若服务器返回的不是以上内容格式，我们可以在 `uploaderEvent` 的 `onSuccess` 对数据进行二次处理，并按以上格式返回。

在 data 中，除了可以返回 src、poster 以外，还可以返回如下内容，进一步指定视频的内容：

```json
{
  "errorCode": 0,
  "data": {
    "src": "http://your-domain.com/video.mp4",
    "poster": "http://your-domain.com/poster.jpg",
    "width": "100%",
    "controls": "true"
  }
}
```