百度智能小程序-掃描二維碼打開智能小程序

智能小程序平臺(tái)正式開放掃描普通鏈接二維碼跳轉(zhuǎn)小程序的能力，該功能充分兼容線下已部署的二維碼資源，為小程序開發(fā)者提供了更為便捷高效的推廣路徑，助力企業(yè)快速實(shí)現(xiàn)線上線下的流量互通與用戶觸達(dá)。

功能介紹

普通鏈接二維碼特指開發(fā)者通過(guò)專用工具對(duì)網(wǎng)頁(yè)鏈接進(jìn)行編碼處理后生成的二維碼標(biāo)識(shí)。線下商戶無(wú)需更換現(xiàn)有二維碼資源，僅需在智能小程序后臺(tái)完成簡(jiǎn)單配置，即可實(shí)現(xiàn)用戶掃描普通鏈接二維碼時(shí)自動(dòng)跳轉(zhuǎn)至小程序，并直接調(diào)用小程序內(nèi)的各項(xiàng)功能服務(wù)。目前，該功能已全面支持通過(guò)百度App“掃一掃”識(shí)別二維碼并完成小程序跳轉(zhuǎn)。

開放范圍

本功能面向企業(yè)、媒體、政府及其他組織類型的小程序開放，覆蓋多元化的應(yīng)用場(chǎng)景，滿足不同主體對(duì)小程序推廣與用戶服務(wù)的需求。

二維碼跳轉(zhuǎn)規(guī)則

自2018年8月起，百度App支持二維碼規(guī)則基于“子路徑匹配”的跳轉(zhuǎn)邏輯。例如，若原有二維碼鏈接為`https://www.baidu.com/a/123456`（其中123456為業(yè)務(wù)參數(shù)），開發(fā)者可配置規(guī)則`https://www.baidu.com/a/`，實(shí)現(xiàn)用戶掃描時(shí)跳轉(zhuǎn)至對(duì)應(yīng)小程序。百度App掃碼跳轉(zhuǎn)需遵循以下匹配原則：二維碼鏈接的協(xié)議、域名與后臺(tái)配置的規(guī)則需完全一致；二維碼鏈接需屬于后臺(tái)配置規(guī)則的子路徑（支持子路徑匹配時(shí)，后臺(tái)配置規(guī)則需以“/”結(jié)尾）；若規(guī)則包含參數(shù)，鏈接“?”后的參數(shù)部分需滿足前綴匹配條件。

常見匹配錯(cuò)誤類型包括：后臺(tái)配置規(guī)則與線下二維碼完整鏈接因協(xié)議（如http與https）或域名（如www.baidu.com與m.baidu.com）不一致導(dǎo)致匹配失敗；參數(shù)不滿足前綴匹配（如規(guī)則參數(shù)id=123與鏈接參數(shù)id=132）；鏈接不屬于子路徑（如規(guī)則`https://www.baidu.com/a/b`與鏈接`https://www.baidu.com/a/bc`）；規(guī)則未以“/”結(jié)尾導(dǎo)致不支持子路徑匹配。

二維碼內(nèi)容獲取

開發(fā)者需完成以下操作獲取二維碼內(nèi)容：在智能小程序后臺(tái)配置二維碼跳轉(zhuǎn)小程序規(guī)則；使用百度App（客戶端版本10.12及以上）掃描二維碼打開小程序；二維碼鏈接內(nèi)容將以參數(shù)“q”的形式傳遞至頁(yè)面，開發(fā)者可在`onLoad`事件中提取該參數(shù)，并通過(guò)`decodeURIComponent`方法解碼，即可獲取原二維碼的完整內(nèi)容。

配置流程

登錄智能小程序后臺(tái)，進(jìn)入“設(shè)置-開發(fā)設(shè)置-掃普通二維碼打開小程序”頁(yè)面，點(diǎn)擊“添加”配置二維碼規(guī)則。填寫規(guī)則時(shí)需注意：二維碼域名須通過(guò)ICP備案驗(yàn)證；支持http、https、ftp開頭的鏈接（如`https://www.baidu.com`、`https://www.baidu.com/mp/`）；單個(gè)小程序賬號(hào)最多配置10個(gè)二維碼前綴規(guī)則。

完成規(guī)則填寫后，需下載隨機(jī)校驗(yàn)文件并上傳至服務(wù)器指定目錄：文件需放置于URL聲明的最后一級(jí)子目錄下，若無(wú)子目錄則放置于服務(wù)器頂層目錄。隨后填寫小程序功能頁(yè)面路徑（如`pages/index/index`），并選擇是否占用符合匹配規(guī)則的所有子規(guī)則（選擇占用后，其他賬號(hào)不可申請(qǐng)使用該前綴下的子規(guī)則）。

填寫測(cè)試鏈接（每個(gè)規(guī)則最多5個(gè)，可修改多次）并驗(yàn)證：若二維碼與測(cè)試鏈接匹配，且用戶為小程序管理員或開發(fā)者，將打開指定版本小程序；測(cè)試僅對(duì)指定鏈接和測(cè)試用戶生效，其他用戶掃碼跳轉(zhuǎn)網(wǎng)頁(yè)。完成測(cè)試后，點(diǎn)擊“保存并提交”即可添加二維碼規(guī)則。

發(fā)布

測(cè)試通過(guò)后，開發(fā)者可將二維碼跳轉(zhuǎn)規(guī)則發(fā)布至現(xiàn)網(wǎng)，發(fā)布后所有符合匹配規(guī)則的掃碼行為將直接跳轉(zhuǎn)至指定小程序頁(yè)面。需注意：最多可添加10個(gè)二維碼規(guī)則地址；單個(gè)小程序賬號(hào)每月最多發(fā)布20次規(guī)則；小程序代碼需先發(fā)布方可發(fā)布二維碼跳轉(zhuǎn)規(guī)則，以確保用戶體驗(yàn)。