百度智能小程序-扫描二维码打开智能小程序

智能小程序平台正式开放扫描普通链接二维码跳转小程序的能力，该功能充分兼容线下已部署的二维码资源，为小程序开发者提供了更为便捷高效的推广路径，助力企业快速实现线上线下的流量互通与用户触达。

功能介绍

普通链接二维码特指开发者通过专用工具对网页链接进行编码处理后生成的二维码标识。线下商户无需更换现有二维码资源，仅需在智能小程序后台完成简单配置，即可实现用户扫描普通链接二维码时自动跳转至小程序，并直接调用小程序内的各项功能服务。目前，该功能已全面支持通过百度App“扫一扫”识别二维码并完成小程序跳转。

开放范围

本功能面向企业、媒体、政府及其他组织类型的小程序开放，覆盖多元化的应用场景，满足不同主体对小程序推广与用户服务的需求。

二维码跳转规则

自2018年8月起，百度App支持二维码规则基于“子路径匹配”的跳转逻辑。例如，若原有二维码链接为`https://www.baidu.com/a/123456`（其中123456为业务参数），开发者可配置规则`https://www.baidu.com/a/`，实现用户扫描时跳转至对应小程序。百度App扫码跳转需遵循以下匹配原则：二维码链接的协议、域名与后台配置的规则需完全一致；二维码链接需属于后台配置规则的子路径（支持子路径匹配时，后台配置规则需以“/”结尾）；若规则包含参数，链接“?”后的参数部分需满足前缀匹配条件。

常见匹配错误类型包括：后台配置规则与线下二维码完整链接因协议（如http与https）或域名（如www.baidu.com与m.baidu.com）不一致导致匹配失败；参数不满足前缀匹配（如规则参数id=123与链接参数id=132）；链接不属于子路径（如规则`https://www.baidu.com/a/b`与链接`https://www.baidu.com/a/bc`）；规则未以“/”结尾导致不支持子路径匹配。

二维码内容获取

开发者需完成以下操作获取二维码内容：在智能小程序后台配置二维码跳转小程序规则；使用百度App（客户端版本10.12及以上）扫描二维码打开小程序；二维码链接内容将以参数“q”的形式传递至页面，开发者可在`onLoad`事件中提取该参数，并通过`decodeURIComponent`方法解码，即可获取原二维码的完整内容。

配置流程

登录智能小程序后台，进入“设置-开发设置-扫普通二维码打开小程序”页面，点击“添加”配置二维码规则。填写规则时需注意：二维码域名须通过ICP备案验证；支持http、https、ftp开头的链接（如`https://www.baidu.com`、`https://www.baidu.com/mp/`）；单个小程序账号最多配置10个二维码前缀规则。

完成规则填写后，需下载随机校验文件并上传至服务器指定目录：文件需放置于URL声明的最后一级子目录下，若无子目录则放置于服务器顶层目录。随后填写小程序功能页面路径（如`pages/index/index`），并选择是否占用符合匹配规则的所有子规则（选择占用后，其他账号不可申请使用该前缀下的子规则）。

填写测试链接（每个规则最多5个，可修改多次）并验证：若二维码与测试链接匹配，且用户为小程序管理员或开发者，将打开指定版本小程序；测试仅对指定链接和测试用户生效，其他用户扫码跳转网页。完成测试后，点击“保存并提交”即可添加二维码规则。

发布

测试通过后，开发者可将二维码跳转规则发布至现网，发布后所有符合匹配规则的扫码行为将直接跳转至指定小程序页面。需注意：最多可添加10个二维码规则地址；单个小程序账号每月最多发布20次规则；小程序代码需先发布方可发布二维码跳转规则，以确保用户体验。