# [Video](/minigame/dev/api/media/video/Video) wx.createVideo(Object object)

> __微信 Windows 版__：支持
> 
> __微信 Mac 版__：支持
> 
> __微信 鸿蒙 OS 版__：支持

## 功能描述

创建视频

## 参数

### Object object


```json
[
  {
    "属性": "x",
    "类型": "number",
    "默认值": "0",
    "必填": "否",
    "说明": "视频的左上角横坐标",
    "最低版本": ""
  },
  {
    "属性": "y",
    "类型": "number",
    "默认值": "0",
    "必填": "否",
    "说明": "视频的左上角纵坐标",
    "最低版本": ""
  },
  {
    "属性": "width",
    "类型": "number",
    "默认值": "300",
    "必填": "否",
    "说明": "视频的宽度",
    "最低版本": ""
  },
  {
    "属性": "height",
    "类型": "number",
    "默认值": "150",
    "必填": "否",
    "说明": "视频的高度",
    "最低版本": ""
  },
  {
    "属性": "src",
    "类型": "string",
    "默认值": "",
    "必填": "是",
    "说明": "视频的资源地址",
    "最低版本": ""
  },
  {
    "属性": "poster",
    "类型": "string",
    "默认值": "",
    "必填": "否",
    "说明": "视频的封面",
    "最低版本": ""
  },
  {
    "属性": "initialTime",
    "类型": "number",
    "默认值": "0",
    "必填": "否",
    "说明": "视频的初始播放位置，单位为 s 秒",
    "最低版本": ""
  },
  {
    "属性": "playbackRate",
    "类型": "number",
    "默认值": "1.0",
    "必填": "否",
    "说明": "视频的播放速率，有效值有 0.5、0.8、1.0、1.25、1.5",
    "最低版本": ""
  },
  {
    "属性": "live",
    "类型": "boolean",
    "默认值": "false",
    "必填": "否",
    "说明": "视频是否为直播",
    "最低版本": ""
  },
  {
    "属性": "objectFit",
    "类型": "string",
    "默认值": "'contain'",
    "必填": "否",
    "说明": "视频的缩放模式",
    "最低版本": "",
    "子项": [
      {
        "合法值": "fill",
        "说明": "填充，视频拉伸填满整个容器，不保证保持原有长宽比例"
      },
      {
        "合法值": "contain",
        "说明": "包含，保持原有长宽比例。保证视频尺寸一定可以在容器里面放得下。因此，可能会有部分空白"
      },
      {
        "合法值": "cover",
        "说明": "覆盖，保持原有长宽比例。保证视频尺寸一定大于容器尺寸，宽度和高度至少有一个和容器一致。因此，视频有部分会看不见"
      }
    ]
  },
  {
    "属性": "controls",
    "类型": "boolean",
    "默认值": "true",
    "必填": "否",
    "说明": "视频是否显示控件",
    "最低版本": ""
  },
  {
    "属性": "showProgress",
    "类型": "boolean",
    "默认值": "true",
    "必填": "否",
    "说明": "是否显示视频底部进度条",
    "最低版本": "[2.12.0](1003706)"
  },
  {
    "属性": "showProgressInControlMode",
    "类型": "boolean",
    "默认值": "true",
    "必填": "否",
    "说明": "是否显示控制栏的进度条",
    "最低版本": "[2.12.0](1003706)"
  },
  {
    "属性": "backgroundColor",
    "类型": "string",
    "默认值": "'#000000'",
    "必填": "否",
    "说明": "视频背景颜色",
    "最低版本": "[2.12.0](1003706)"
  },
  {
    "属性": "autoplay",
    "类型": "boolean",
    "默认值": "false",
    "必填": "否",
    "说明": "视频是否自动播放",
    "最低版本": ""
  },
  {
    "属性": "loop",
    "类型": "boolean",
    "默认值": "false",
    "必填": "否",
    "说明": "视频是否是否循环播放",
    "最低版本": ""
  },
  {
    "属性": "muted",
    "类型": "boolean",
    "默认值": "false",
    "必填": "否",
    "说明": "视频是否禁音播放",
    "最低版本": ""
  },
  {
    "属性": "obeyMuteSwitch",
    "类型": "boolean",
    "默认值": "false",
    "必填": "否",
    "说明": "视频是否遵循系统静音开关设置（仅iOS）",
    "最低版本": "[2.4.0](1003706)"
  },
  {
    "属性": "enableProgressGesture",
    "类型": "boolean",
    "默认值": "true",
    "必填": "否",
    "说明": "是否启用手势控制播放进度",
    "最低版本": ""
  },
  {
    "属性": "enablePlayGesture",
    "类型": "boolean",
    "默认值": "false",
    "必填": "否",
    "说明": "是否开启双击播放的手势",
    "最低版本": ""
  },
  {
    "属性": "showCenterPlayBtn",
    "类型": "boolean",
    "默认值": "true",
    "必填": "否",
    "说明": "是否显示视频中央的播放按钮",
    "最低版本": ""
  },
  {
    "属性": "underGameView",
    "类型": "boolean",
    "默认值": "false",
    "必填": "否",
    "说明": "视频是否显示在游戏画布之下（配合 Canvas.getContext('webgl', {alpha: true}) 使主屏canvas实现透明效果）",
    "最低版本": "[2.11.0](1003706)"
  },
  {
    "属性": "autoPauseIfNavigate",
    "类型": "boolean",
    "默认值": "true",
    "必填": "否",
    "说明": "视频跳转后自动暂停播放",
    "最低版本": ""
  },
  {
    "属性": "autoPauseIfOpenNative",
    "类型": "boolean",
    "默认值": "true",
    "必填": "否",
    "说明": "视频跳转原生页后自动暂停播放",
    "最低版本": ""
  }
]
```

## 返回值

### [Video](/minigame/dev/api/media/video/Video)

一个视频对象，可以通过设置该对象上的属性和调用该对象上的方法来控制视频