当前位置：首页 > news >正文

h5页面跳转微信小程序（最简单的方法|URL Scheme）

news 2025/12/15 17:17:43

在这里插入图片描述

文章目录

导文
实现
- 获取 URL Scheme
- - 加密 URL Scheme
  - - 获取方式
    - 拼接参数
  - 明文 URL Scheme
  - - 获取方式
- 实际项目展示：
- 频率限制
- 注意事项
- 开放范围
- 示例代码包

导文

H5页面跳转微信小程序的需求是普遍存在的。由于微信小程序是一种只能在微信内部访问的应用程序，而H5页面可以在任何浏览器中访问，因此需要通过跳转来实现两者之间的衔接。
对于用户来说，H5页面跳转微信小程序可以提供更好的用户体验。用户可以在H5页面中浏览和选择商品、服务等内容，然后直接跳转到微信小程序中进行购买、支付等操作，避免了在不同平台之间的切换和跳转，提高了使用效率和便捷性。
对于企业和开发者来说，H5页面跳转微信小程序可以带来更多的商业机会和价值。通过在H5页面中引导用户跳转到微信小程序，可以增加用户的粘性和转化率，提高销售和收益。同时，微信小程序的开发和维护成本相对较低，可以降低企业的运营成本和门槛。
H5页面跳转微信小程序的需求是普遍存在的，可以带来更好的用户体验和企业价值。但需要注意的是，实现这一需求需要具备一定的技术能力和遵循相应的开发规范和要求。

实现

官方文档地址：https://developers.weixin.qq.com/miniprogram/dev/framework/open-ability/url-scheme.html

获取 URL Scheme

自 2023 年 12 月 19 日起，对URL Scheme进行升级，详细调整说明可见《URL Scheme 和 URL Link优化公告》。改动点概览如下：

支持开发者在原有加密 URL Scheme 后面拼接参数；
新增明文 URL Scheme，开发者无需调用接口可自行拼接生成明文Scheme；
取消 URL Scheme 一人一链的限制，支持同一条连接被多名用户访问；
每个小程序每天 URL Scheme 和 URL Link 总打开次数上限为300万。

加密 URL Scheme

获取方式

通过服务端接口可以获取打开小程序任意页面的加密 URL Scheme。适用于从短信、邮件、微信外网页等场景打开小程序。通过 URL Scheme 打开小程序的场景值为 1065。
生成的 URL Scheme 如下所示：

weixin://dl/business/?t= *TICKET*

iOS系统支持识别 URL Scheme，可在短信等应用场景中直接通过Scheme跳转小程序。
Android系统不支持直接识别 URL Scheme，用户无法通过 Scheme 正常打开小程序，开发者需要使用 H5 页面中转，再跳转到 Scheme 实现打开小程序，跳转代码示例如下：

location.href = 'weixin://dl/business/?t= *TICKET*'

该跳转方法可以在用户打开 H5 时立即调用，也可以在用户触发事件后调用。

拼接参数

将原有 URL Scheme 平滑升级为加密 URL Scheme，支持开发者自行在链接后面拼接参数CUSTOM PARAMETE,拼接参数后的 URL Scheme 如下所示：

weixin://dl/business/?t= *TICKET*&cq=*CUSTOM PARAMETER*

注意：

CUSTOM PARAMETE是一种特殊的query，最大256个字符，只支持数字，大小写英文以及部分特殊字符：!#$&'()*+,/:;=?@-._~%`，需要url_encode;
在本次规则调整生效前已经生成的 URL Scheme 可继续正常使用，并可直接进行CUSTOM PARAMETE参数拼接；
拼接参数后的加密 URL Scheme 打开小程序的场景值不变，仍为 1065。

明文 URL Scheme

获取方式

开发者无需调用平台接口，在MP平台->设置->隐私与安全->明文Scheme拉起此小程序声明后，可自行根据如下格式拼接appid和path等参数，作为明文 URL Scheme 链接。

weixin://dl/business/?appid=*APPID*&path=*PATH*&query=*QUERY*&env_version=*ENV_VERSION*

其中，各个参数的定义如下：

【必填】APPID：通过明文 URL Scheme 打开小程序的 appid ；
【必填】PATH：通过明文 URL Scheme 打开小程序的页面 path ，必须是已经发布的小程序存在的页面，不可携带 query；
【选填】QUERY：通过明文 URL Scheme 打开小程序的 query ，最大512个字符，只支持数字，大小写英文以及部分特殊字符：!#$&'()*+,/:;=?@-._~%`，需要url_encode；
【选填】ENV_VERSION：要打开的小程序版本,正式版为release，体验版为trial，开发版为develop，仅在微信外打开时生效。注意：若不填写，则默认打开正式版小程序。

通过明文 URL Scheme 打开小程序的场景值为 1286。

实际项目展示：

<body><a href="weixin://dl/business/?appid=wx1234123123&path=pages/index/index">点击跳转</a></body>

在这里插入图片描述
点击后，即可跳转。（在手机上操作，电脑只能跳到微信，跳不到小程序）

频率限制

生成端：每天生成 URL Scheme（加密+明文）和 URL Link 的总数量上限为50万；

打开端：每天通过 URL Scheme（加密+明文）和 URL Link 打开小程序的总次数上限为300万。

注意事项

微信内的网页如需打开小程序请使用微信开放标签-小程序跳转按钮，无公众号也可以直接使用小程序身份开发网页并免鉴权跳转小程序，见云开发静态网站跳转小程序。符合开放范围的小程序可以下发支持打开小程序的短信
该功能基本覆盖当前用户正在使用的微信版本，开发者无需进行低版本兼容
只能生成已发布的小程序的 URL Scheme
通过 URL Scheme 跳转到微信时，可能会触发系统弹框询问，若用户选择不跳转，则无法打开小程序。请开发者妥善处理用户选择不跳转的场景
部分浏览器会限制打开网页直接跳转，可参考示例网页设置跳转按钮
平台有安全策略防止开发者的链接被黑灰产批量打开，导致的达到访问上限无法正常打开小程序的问题

开放范围

针对非个人主体小程序开放。

示例代码包

https://download.csdn.net/download/weixin_48998573/88650342

您好，我是肥晨。
欢迎关注我获取前端学习资源，日常分享技术变革，生存法则；行业内幕，洞察先机。

文章目录

导文

实现

获取 URL Scheme

加密 URL Scheme

获取方式

拼接参数

明文 URL Scheme

获取方式

实际项目展示：

频率限制

注意事项

开放范围

示例代码包

相关文章：