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

從基礎(chǔ)庫 2.14.3 開始支持

支持平臺(tái)：Android

客戶端版本：webview打開小程序需要升級至微信7.0.22及以上版本，文件和視頻打開小程序需要升級至微信8.0.0 及以上版本，圖片打開小程序需要升級至微信8.0.1及以上版本

支持類型：僅小程序，小游戲暫不支持

# 功能介紹

微信聊天內(nèi)素材（文件、圖片、視頻和webview）的打開方式增加使用小程序打開的入口。用戶可通過小程序處理聊天內(nèi)的文件、圖片、視頻和webview。例如用小程序?qū)⑽募鎯?chǔ)到網(wǎng)盤、給圖片加濾鏡、進(jìn)行視頻剪輯或者將webview保存到筆記等。目前僅支持不帶二維碼的圖片直接通過小程序打開。

在 PC 端基礎(chǔ)庫大于 3.7.6 的環(huán)境下，用戶可以通過拖入文件的方式來觸發(fā)小程序打開。當(dāng)拖入符合規(guī)則的文件后，框架側(cè)將會(huì) reLaunch 小程序。當(dāng)拖入不符合規(guī)則的文件，框架側(cè)將會(huì)提示用戶文件不支持。

# 使用說明

開發(fā)者需要在小程序全局配置(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類型：

# 小程序啟動(dòng)參數(shù)

小程序啟動(dòng)參數(shù)里場景值為1173，該場景下啟動(dòng)參數(shù)和query同一級有一個(gè)數(shù)組forwardMaterials，代表轉(zhuǎn)發(fā)的文件信息，數(shù)組中每一個(gè)對象包含屬性{type,name,path,size}分別代表文件類型，文件名，文件路徑或url，文件大小

# 發(fā)布

小程序提審時(shí)會(huì)審核聲明的supportedMaterials是否合規(guī)，小程序發(fā)布上線后相應(yīng)文件類型打開入口才會(huì)出現(xiàn)小程序。

如果小程序?qū)崿F(xiàn)的功能價(jià)值較低將不會(huì)被通過審核，包括但不限于以下情況：

1. 打開小程序后的功能與對應(yīng)的素材沒有任何關(guān)系：只是通過這個(gè)入口打開了自己的小程序，而并沒有對素材做任何的處理。
2. 打開小程序后處理素材的方式過于簡單：比如只是播放視頻或只是查看.docx文件等通過微信聊天就能實(shí)現(xiàn)的簡單功能。

請開發(fā)者結(jié)合自身小程序的功能與用戶需求進(jìn)行適配。

# 調(diào)試

# 體驗(yàn)版

體驗(yàn)版小程序支持單獨(dú)配置supportedMaterials，和正式版的小程序配置相互獨(dú)立，上述相應(yīng)的入口小程序列表也會(huì)單獨(dú)展示體驗(yàn)版小程序。

# 開發(fā)者工具

開發(fā)者可在自定義編譯模式下通過場景值1173調(diào)試該功能。