在安全模式下必须返回完整的加密回包结构，不能直接返回"success"。正确回包应包含四个核心参数： **必要参数说明：** 1. Encrypt：经AES加密并Base64编码后的业务响应内容 2. MsgSignature：由Token、Timestamp、Nonce、Encrypt四参数排序拼接后做SHA1运算得出 3. TimeStamp：当前时间戳（推荐使用接收请求的时间戳） 4. Nonce：随机字符串（建议重新生成而非复用请求参数） **示例正确回包结构：** ```json { "Encrypt": "ELGdu...xSQ==", "MsgSignature": "1b9339...4dea1", "TimeStamp": 1713424427, "Nonce": "415670741" } ``` **注意事项：** 1. 加密流程必须严格遵循：生成新随机串->构建FullStr结构->AES加密->Base64编码 2. MsgSignature签名算法必须与微信服务器校验逻辑一致 3. 回包格式须与消息推送配置的数据格式完全匹配（JSON/XML二选一） 4. 若业务无需返回数据，仍需构造空内容的加密回包 参考文档：[消息推送文档](https://developers.weixin.qq.com/miniprogram/dev/framework/server-ability/message-push.html)

针对微信小程序消息推送的回包要求，根据官方技术规范整理如下： **一、明文模式回包要求** 1. 直接返回空字符串或纯文本"success" 2. HTTP响应头需设置Content-Type为text/plain 3. 无需携带任何结构化参数 **二、安全模式回包要求** 1. 必须返回包含加密数据的结构化响应： ```json { "Encrypt": "加密数据(Base64编码)", "MsgSignature": "消息签名", "TimeStamp": "UNIX时间戳", "Nonce": "随机字符串" } ``` 2. 格式必须与后台配置的数据格式一致（JSON/XML二选一） **三、核心判断标准** 1. 加密模式由小程序后台的【消息加解密方式】配置决定： - 选择"安全模式"时必须加密回包 - 选择"明文模式"时禁止加密回包 - "兼容模式"需同时支持两种回包（根据请求参数自动切换） **重要注意事项**： 1. 安全模式签名计算必须包含四要素： - Token - TimeStamp - Nonce - Encrypt字段值 2. 所有回包须在5秒内完成响应 3. 加密回包的Content-Type需设置为application/json或text/xml（与配置格式匹配） 参考文档： [消息推送技术文档](https://developers.weixin.qq.com/miniprogram/dev/framework/server-ability/message-push.html)

channel-video组件使用限制及功能说明如下： 1. **播放控制能力**： - 不支持获取播放进度相关事件（如timeupdate） - 无播放/暂停控制接口 - 仅支持基础属性：autoplay（同主体可用）、loop、muted、object-fit 2. **交互限制**： - 组件默认无跳转行为（与channel-live组件不同），若出现跳转需检查： a. 是否误用其他跳转接口 b. 基础库版本是否≥2.25.1 c. 视频号内容是否合规 - 不支持滑动切换视频功能，该组件仅展示单个视频 3. **替代方案**： - 需进度监控时，建议使用原生video组件+自有视频源 - 需要交互控制时，通过自定义播放器实现 自查建议： 1. 确认组件版本≥2.25.1 2. 检查是否混用其他视频号组件 3. 通过真机调试确认组件实际表现 参考文档： [channel-video组件文档](https://developers.weixin.qq.com/miniprogram/dev/component/channel-video.html) [视频号视频指南](https://developers.weixin.qq.com/miniprogram/dev/framework/open-ability/channels-activity.html)

微信小程序**不支持通过页面内按钮直接触发分享到朋友圈功能**。根据官方技术要求，用户必须主动点击右上角菜单选择"分享到朋友圈"才能发起操作。 ### 合规实现流程： 1. **必要配置** ```javascript Page({ onShareTimeline() { // 必须配置此函数 return { title: '自定义标题', query: 'from=share', imageUrl: '/images/share.jpg' } } }) ``` 2. **用户引导设计** - 使用视觉元素（如浮动箭头图标）指向右上角菜单 - 添加提示文案"点击右上角分享到朋友圈" - 保持与微信原生控件一致的UI风格 ### 故障排查清单： 1. 按钮不显示： ✔ 检查基础库版本≥2.11.3（Android） ✔ 确认已正确定义`onShareTimeline` ✔ 排除页面包含web-view组件 2. 分享失败： ✔ iOS设备微信版本≥8.0.24 ✔ 单页模式布局是否符合规范 ✔ 检查是否存在诱导分享内容 参考文档： [分享到朋友圈指南](https://developers.weixin.qq.com/miniprogram/dev/framework/open-ability/share-timeline.html) [页面接口文档](https://developers.weixin.qq.com/miniprogram/dev/reference/api/Page.html)

发送带小程序文字链的客服消息需按以下规范操作： **一、消息类型选择** 必须使用`msgtype: "text"`，文字链参数需嵌入text对象的content字段 **二、参数结构示例** ```json { "touser": "OPENID", "msgtype": "text", "text": { "content": "a href=\"备用链接\" data-miniprogram-appid=\"当前小程序APPID\" data-miniprogram-path=\"/pages/index/index?param=1\">点击跳转小程序" } } ``` **三、关键要求** 1. `data-miniprogram-appid`必须填写当前小程序自身的APPID 2. `data-miniprogram-path`需与app.json中的页面路径完全一致（可带参数） 3. 兼容性处理： - 必须包含`href`参数作为低版本备用链接 - 微信客户端6.5.16以下版本会强制跳转`href`链接 **四、自查清单** 1. 检查access_token有效性（有效期2小时） 2. 验证路径格式是否符合规范（如`/pages/index/index?param=1`） 3. 使用微信开发者工具真机调试验证不同版本客户端表现 参考文档： - [发送客服消息接口文档](https://developers.weixin.qq.com/miniprogram/dev/OpenApiDoc/kf-mgnt/kf-message/sendCustomMessage.html)

微信平台目前不支持撤回或删除已发送的一次性订阅消息。订阅消息发送成功后，消息会直接触达用户微信客户端，开发者无法通过接口或后台进行撤回操作。 建议处理方式： 1. 发送前严格校验消息内容 2. 通过业务系统记录消息发送日志 3. 如需更新信息，需重新发送新模板消息（需用户重新授权订阅） 参考文档: [订阅消息开发指南](https://developers.weixin.qq.com/miniprogram/dev/framework/open-ability/subscribe-message.html) [发送订阅消息接口文档](https://developers.weixin.qq.com/miniprogram/dev/OpenApiDoc/mp-message-management/subscribe-message/sendMessage.html)

文档地址：[获取手机号接口文档](https://developers.weixin.qq.com/miniprogram/dev/OpenApiDoc/user-info/phone-number/getPhoneNumber.html) 微信小程序获取用户手机号必须通过用户主动触发授权流程，目前仅支持以下方式： **前端按钮授权** 必须使用``组件设置`open-type="getPhoneNumber"`，通过`bindgetphonenumber`事件获取临时`code`，将`code`传给服务端调用`getPhoneNumber`接口解密手机号。 **注意事项**： - 所有手机号获取均需用户主动触发，无法通过纯后端接口直接获取 - 临时`code`有效期5分钟且一次性使用 - 需确保开发者工具版本≥1.02.1904090，wx-server-sdk≥0.4.0 若需排查问题，请检查： 1. 按钮组件是否按规范声明`open-type` 2. 服务端接口是否正确处理`code`参数 3. 小程序权限设置中是否开通手机号权限

[指南/开放能力/消息/订阅消息](https://developers.weixin.qq.com/miniprogram/dev/framework/open-ability/subscribe-message-overview.html) [订阅消息接口文档](https://developers.weixin.qq.com/miniprogram/dev/OpenApiDoc/mp-message-management/subscribe-message/sendMessage.html) 1. **一次性订阅机制**： - 用户每次测量血压后需重新触发订阅弹窗（调用wx.requestSubscribeMessage），每次订阅仅支持单次消息下发 - 无法实现"一次订阅长期接收"，需用户逐次授权 2. **替代方案建议**： - 若属于医疗类目且符合条件，可申请长期订阅消息权限（需微信审核通过） - 新版一次性订阅消息Beta版支持通过微信支付场景自动触发（需结合支付订单场景使用） **注意事项**： - 医疗健康类小程序需通过微信类目资质审核才能使用消息能力 - 血压数据需符合微信健康数据规范，禁止传输敏感医疗信息 自查建议：登录小程序后台查看「功能-订阅消息-长期订阅消息」申请入口状态，确认是否符合医疗类目准入要求。

[组件/camera](https://developers.weixin.qq.com/miniprogram/dev/component/camera.html) [媒体/视频处理](https://developers.weixin.qq.com/miniprogram/dev/api/media/video/wx.chooseVideo.html) 小程序原生拍摄视频暂不支持直接写入水印，可通过以下方案实现： 1. **拍摄后处理方案** - 使用`wx.chooseVideo`选择视频文件 - 通过服务端接口进行视频水印合成（需自行开发或使用第三方视频处理服务） **注意事项**： 1. camera组件属于原生组件，其层级最高，无法通过普通组件覆盖水印 2. 视频处理需注意文件大小限制（微信客户端限制最大100MB） 3. 真机调试需开启"不校验合法域名"选项（若使用自有服务） 若需持久化水印，必须通过服务端处理视频文件。微信小程序暂未提供原生视频编辑API。

[订阅消息接口文档](https://developers.weixin.qq.com/miniprogram/dev/OpenApiDoc/mp-message-management/subscribe-message/sendMessage.html) [登录机制文档](https://developers.weixin.qq.com/miniprogram/dev/framework/open-ability/login.html) 1. **openid的归属本质** openid是微信用户在当前小程序的唯一标识符，与微信账号直接绑定。无论用户在小程序内登录多少个业务账号（如账号A/B），通过微信登录体系获取的openid始终对应当前微信用户的身份标识。 2. **订阅消息的openid来源** 订阅消息接口中的`touser`参数必须使用通过`wx.login`+`code2Session`流程获取的微信openid。该openid仅与当前运行小程序的微信用户身份相关，与小程序的业务账号体系无关。 3. **业务账号与微信账号的关系** 若业务账号A/B需要关联不同微信用户，需通过以下方式实现： - 用户使用不同微信账号登录小程序 - 每个微信账号会生成独立的openid - 业务系统需自行建立业务账号与微信openid的映射关系 **自查建议**： 1. 检查用户登录流程是否通过`wx.login`获取微信openid 2. 验证业务账号体系与微信openid的绑定逻辑是否正确 3. 确保订阅消息接口调用时传递的是微信原生openid而非业务自建ID