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

从基础库 2.14.3 开始支持

支持平台：Android

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

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

# 功能介绍

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

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

# 使用说明

开发者需要在小程序全局配置(app.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/"
        }
    ]
}

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

# 小程序启动参数

小程序启动参数里场景值为1173，该场景下启动参数和query同一级有一个数组forwardMaterials，代表转发的文件信息，数组中每一个对象包含属性{type,name,path,size}分别代表文件类型，文件名，文件路径或url，文件大小

# 发布

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

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

1. 打开小程序后的功能与对应的素材没有任何关系：只是通过这个入口打开了自己的小程序，而并没有对素材做任何的处理。
2. 打开小程序后处理素材的方式过于简单：比如只是播放视频或只是查看.docx文件等通过微信聊天就能实现的简单功能。

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

# 调试

# 体验版

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

# 开发者工具

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