---
title: "如何配置小程序支持打开聊天内的文件类型？"
id: "baa972688f1fa8f9"
typeName: "小程序-开发-指南"
utime: "2026-07-23 20:19:45"
---

# 如何配置小程序支持打开聊天内的文件类型？

开发者需要在小程序[全局配置](1003707) `app.json` 中声明 `supportedMaterials` 字段，用来指定支持打开的文件类型。

配置示例：

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

字段说明：

- `materialType`：支持文件类型的 `MimeType`，必填。
- `name`：素材页面展示的标题，必须包含 `${nickname}`，编译后会自动替换为小程序名称，其余字数不超过 6 个，必填。
- `desc`：用途描述，限定字数不超过 22 个，必填。
- `path`：该场景下打开小程序时跳转的页面，必填。

注意：对一种文件类型只能声明一种处理方式。

## 相关文档

- [聊天素材支持小程序打开](/miniprogram/dev/framework/material/support_material.md)