# wx.previewMedia(Object object)

> 基础库 2.12.0 开始支持，低版本需做[兼容处理](1003706)。

> __以 [Promise 风格](/miniprogram/dev/framework/app-service/api.md#异步-API-返回-Promise) 调用__：支持
> 
> __小程序插件__：支持，需要小程序基础库版本不低于 [2.15.0](1003706)
> 
> __微信 鸿蒙 OS 版__：支持

## 功能描述

预览图片和视频。

## 参数

### Object object


```json
[
  {
    "属性": "sources",
    "类型": "Array.<Object>",
    "默认值": "",
    "必填": "是",
    "说明": "需要预览的资源列表",
    "最低版本": "",
    "子项": [
      {
        "结构属性": "url",
        "类型": "String",
        "默认值": "",
        "必填": "是",
        "说明": "图片或视频的地址"
      },
      {
        "结构属性": "type",
        "类型": "String",
        "默认值": "image",
        "必填": "否",
        "说明": "资源的类型，默认为图片",
        "子项": [
          {
            "合法值": "image",
            "说明": "图片"
          },
          {
            "合法值": "video",
            "说明": "视频"
          }
        ]
      },
      {
        "结构属性": "poster",
        "类型": "string",
        "默认值": "",
        "必填": "否",
        "说明": "视频的封面图片"
      }
    ]
  },
  {
    "属性": "current",
    "类型": "number",
    "默认值": "0",
    "必填": "否",
    "说明": "当前显示的资源序号",
    "最低版本": ""
  },
  {
    "属性": "showmenu",
    "类型": "boolean",
    "默认值": "true",
    "必填": "否",
    "说明": "是否显示长按菜单。",
    "最低版本": "[2.13.0](1003706)"
  },
  {
    "属性": "referrerPolicy",
    "类型": "string",
    "默认值": "no-referrer",
    "必填": "否",
    "说明": "\u0000INLINECODE_0\u0000: 发送完整的referrer; \u0000INLINECODE_1\u0000: 不发送。格式固定为 \u0000INLINECODE_2\u0000，其中 {appid} 为小程序的 appid，{version} 为小程序的版本号，版本号为 0 表示为开发版、体验版以及审核版本，版本号为 devtools 表示为开发者工具，其余为正式版本；",
    "最低版本": "[2.13.0](1003706)"
  },
  {
    "属性": "success",
    "类型": "function",
    "默认值": "",
    "必填": "否",
    "说明": "接口调用成功的回调函数",
    "最低版本": ""
  },
  {
    "属性": "fail",
    "类型": "function",
    "默认值": "",
    "必填": "否",
    "说明": "接口调用失败的回调函数",
    "最低版本": ""
  },
  {
    "属性": "complete",
    "类型": "function",
    "默认值": "",
    "必填": "否",
    "说明": "接口调用结束的回调函数（调用成功、失败都会执行）",
    "最低版本": ""
  }
]
```

## 支持长按识别的码

| 类型 | 说明 | 最低版本 |
|------|------| -------|
| 小程序码 |    |
| 微信个人码 | 不支持小游戏   | [2.18.0](1003706) |
| 企业微信个人码 | 不支持小游戏   | [2.18.0](1003706) |
| 普通群码 | 指仅包含微信用户的群，不支持小游戏   | [2.18.0](1003706) |
| 互通群码 |  指既有微信用户也有企业微信用户的群，不支持小游戏  | [2.18.0](1003706) |
| 公众号二维码 | 不支持小游戏  | [2.18.0](1003706) |