# 聊天素材支持小程序打开

从基础库 [2.14.3](/miniprogram/dev/framework/compatibility) 开始支持

支持平台：Android

客户端版本：webview 打开小程序需要升级至微信 7.0.22 及以上版本，文件和视频打开小程序需要升级至微信 8.0.0 及以上版本，图片打开小程序需要升级至微信 8.0.1 及以上版本

支持类型：仅小程序，小游戏暂不支持

## 功能介绍

微信聊天内素材（文件、图片、视频和webview）的打开方式增加使用小程序打开的入口。用户可通过小程序处理聊天内的文件、图片、视频和webview。例如用小程序将文件存储到网盘、给图片加滤镜、进行视频剪辑或者将webview保存到笔记等。目前仅支持不带二维码的图片直接通过小程序打开。

    ![](https://res.wx.qq.com/op_res/FZVVx7G8HHgH2ely6zqw1Fvq69kGwzoixszEPOO2DWSHdepJNJD2dUbgl0k-nH4jFw8hlS9SsPd6DYIm4R_9xg)

用户在打开微信聊天内的素材时，如果小程序配置了支持打开该类型的素材并审核通过，而且用户曾经使用过该小程序，则打开该类型的素材时会出现使用小程序打开的入口。

在 PC 端基础库大于 3.7.6 的环境下，用户可以通过拖入文件的方式来触发小程序打开。当拖入符合规则的文件后，框架侧将会 reLaunch 小程序。当拖入不符合规则的文件，框架侧将会提示用户文件不支持。

## 使用说明

开发者需要在[小程序全局配置](/miniprogram/dev/framework/config)(app.json)中声明支持打开的文件类型，对一种文件类型只能声明一种处理方式。

```json
{
    "supportedMaterials": [
        {
            "materialType": "text/html",
            "name": "用${nickname}打开",
            "desc": "描述",
            "path": "pages/index/"
        },
        {
            "materialType": "video/*",
            "name": "用${nickname}播放",
            "desc": "描述",
            "path": "pages/index/"
        },
        {
            "materialType": "video/mp4",
            "name": "用${nickname}播放",
            "desc": "描述",
            "path": "pages/index/"
        }
    ]
}
```

| 属性         | 类型   | 必填 | 描述                                                         |
| ------------ | ------ | ---- | ------------------------------------------------------------ |
| materialType | String | 是   | 支持文件类型的`MimeType`，音频，视频支持二级配置的通配模式，例如: `video/*`。通配模式配置和精确类型配置同时存在时，则优先使用精确类型的配置(例如`video/*`和`video/mp4`同时存在，会优先使用`video/mp4`的配置)。 |
| name         | String | 是   | 开发者配置的标题，在素材页面会展示该标题，配置中必须包含`${nickname}`, 代码包编译后会自动替换为小程序名称，如果声明了简称则会优先使用[简称](https://kf.qq.com/faq/170109umMvm6170109MZNnYV.html)。除去`${nickname}`其余字数不得超过6个。 |
| desc         | String | 是   | 用途描述，会在推荐列表展示该描述，限定字数不超过22个。       |
| path         | String | 是   | 在该场景下打开小程序时跳转页面                               |

**最新客户端版本**支持的`MimeType`类型：

| MimeType                                                     | 文件后缀 | 说明         |
| ------------------------------------------------------------ | -------- | ------------ |
| video/*                                                      |          | 视频类文件   |
| audio/*                                                      |          | 音频类文件   |
| image/*                                                      |          | 图片类文件   |
| text/html                                                    |          | webview      |
| text/plain                                                   | .txt     |              |
| text/markdown                                                   | .md     | markdown文件             |
| application/*                                                |          | 通用文件配置 |
| application/pdf                                              | .pdf     |              |
| application/msword                                           | .doc     |              |
| application/vnd.openxmlformats-officedocument.wordprocessingml.document | .docx    |              |
| application/vnd.ms-word.document.macroEnabled.12             | .docm    |              |
| application/vnd.ms-excel                                     | .xls     |              |
| application/vnd.openxmlformats-officedocument.spreadsheetml.sheet | .xlsx    |              |
| application/vnd.ms-excel.sheet.macroEnabled.12               | .xlsm    |              |
| application/vnd.ms-powerpoint                                | .ppt     |              |
| application/vnd.openxmlformats-officedocument.presentationml.presentation | .pptx    |              |
| application/zip                                              | .zip     |              |
| application/vnd.rar                                          | .rar     |              |
| application/x-7z-compressed                                  | .7z      |              |
| application/x-photoshop                                      | .psd     |              |
| application/acad                                             | .dwg     |              |
| application/x-cdr                                            | .cdr     |              |
| application/dxf                                              | .dxf     |              |
| application/step                                             | .stp     |              |
| application/rtf                                              | .rtf     |              |
| application/postscript                                       | .ai      |              |

### 小程序启动参数

[小程序启动参数](/miniprogram/dev/api/base/app/app-event/wx.onAppShow.md)里场景值为`1173`，该场景下启动参数和 query 同一级有一个数组`forwardMaterials`，代表转发的文件信息，数组中每一个对象包含属性`{type,name,path,size}`分别代表文件类型、文件名、文件路径或 URL、文件大小

## 发布

小程序提审时会审核声明的`supportedMaterials`是否合规，小程序发布上线后相应文件类型打开入口才会出现小程序。

如果小程序实现的功能价值较低将不会被通过审核，包括但不限于以下情况：

1）打开小程序后的功能与对应的素材没有任何关系：只是通过这个入口打开了自己的小程序，而并没有对素材做任何的处理。

2）打开小程序后处理素材的方式过于简单：比如只是播放视频或只是查看.docx文件等通过微信聊天就能实现的简单功能。

请开发者结合自身小程序的功能与用户需求进行适配。

## 调试

### 体验版

体验版小程序支持单独配置`supportedMaterials`，和正式版的小程序配置相互独立，上述相应的入口小程序列表也会单独展示体验版小程序。

### 开发者工具

开发者可在自定义编译模式下通过场景值`1173`调试该功能。