使用 `miniprogram-ci` 的 `upload` 接口上传的代码默认生成开发版本，无法通过该接口直接设置为体验版。需按以下步骤操作： 1. **上传开发版本** 通过 `upload` 方法生成开发版本（版本号需符合规范）： ```javascript await ci.upload({ project, version: '1.2.0', desc: '功能迭代' }) ``` 2. **手动设置为体验版** 登录微信小程序管理后台： - 进入「版本管理」模块 - 找到对应开发版本 - 点击「选为体验版」按钮 - 配置体验成员（需提前在后台添加） **权限要求**：需具备小程序管理员或开发者权限的账号操作。 **建议**： - 版本号建议包含环境标识（如 `1.2.0-beta`）便于区分 - 通过 CI/CD 流程实现自动上传后，需人工审核再设置为体验版 参考文档： - [miniprogram-ci文档](https://developers.weixin.qq.com/miniprogram/dev/devtools/ci.html) - [版本管理规范](https://developers.weixin.qq.com/miniprogram/dev/framework/quickstart/release.html)

1. **接口费用与频率限制** - 接口调用不收取费用 - 每日发送限制： - 开通支付能力的小程序：上限3000万次 - 未开通支付能力的小程序：上限1000万次 - 超出限制的请求将被拦截 2. **批量发送限制** - 仅支持单用户发送（touser参数为单个openid），无原生批量接口 - 高并发优化建议： a. 采用异步任务队列拆分发送任务 b. 分布式架构提升处理能力 c. 确保access_token有效期内重复使用 **注意事项**： - 需处理接口返回的特定错误码： - 40014：无效access_token，需刷新后重试 - 43108：同一用户消息并发限制 - 47003：参数格式错误，检查data字段结构 - 通过小程序后台「开发管理-运维中心」监控接口调用量 参考文档： [发送订阅消息接口文档](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/subscribe-message.html)

根据微信小程序官方规范，**无法通过openid直接获取用户手机号**。当前唯一合法获取方式为： 1. **前端必须使用手机号快速验证组件** - 需用户主动触发包含`open-type="getPhoneNumber"`的按钮组件 - 通过`bindgetphonenumber`事件获取加密的code 2. **后端调用专用接口解密** - 使用`phonenumber.getPhoneNumber`接口 - 必要参数：前端获取的code + 接口调用凭证access_token **关键限制**： - 用户必须在前端主动授权 - 每个code仅限单次使用且5分钟有效 - 无任何官方接口支持通过openid直接查询手机号 若需长期绑定手机号，建议将首次获取的号码与openid关联存储至自有数据库。 参考文档： [手机号快速验证组件](https://developers.weixin.qq.com/miniprogram/dev/framework/open-ability/getPhoneNumber.html) [获取手机号接口文档](https://developers.weixin.qq.com/miniprogram/dev/OpenApiDoc/user-info/phone-number/getPhoneNumber.html)

要实现微信卡包开卡后自动返回小程序，请按以下步骤操作： 1. **跳转型开卡组件配置** - 在`activate_url`填写HTTPS协议的中间页地址（如：`https://yourdomain.com/activate`） - 中间页需完成卡券激活操作后，生成小程序明文Scheme进行跳转 2. **URL Scheme生成规范** - 使用明文Scheme格式自主拼接： ```javascript const query = encodeURIComponent('card_id=123') const scheme = `weixin://dl/business/?appid=wx123456&path=/pages/card/success&query=${query}` ``` - 参数要求： - `path`填写目标页面路径（如`/pages/success`） - `query`需进行URL编码，最大长度512字符 3. **关键实现步骤** - 中间页服务端调用卡券激活接口后，通过302重定向返回Scheme地址 - 小程序端使用web-view组件承载中间页： ```html web-view src="https://yourdomain.com/activate?card_id=123&code=abc">/web-view> ``` 4. **注意事项** - 小程序后台需配置中间页域名到「业务域名」 - 确保中间页完成卡券激活操作后才执行跳转 - Android系统需通过用户交互触发跳转（如按钮点击事件） - path参数仅填写页面路径，不要包含query参数 参考文档： [获取小程序链接](https://developers.weixin.qq.com/miniprogram/dev/framework/open-ability/url-scheme.html)

微信小程序目前不提供直接写入NFC标签的API接口。虽然支持生成符合规范的NFC Scheme码，但实际写入操作需通过第三方NFC工具或设备原生功能完成。以下是关键点说明： 1. **能力限制** - 小程序API仅支持NFC标签的读取与识别（通过NFCAdapter相关接口） - 标签写入需依赖设备原生NFC能力或专用硬件工具 2. **开发建议** - 通过服务端API生成符合要求的Scheme码 - 使用Android原生API或专业NFC写入设备完成标签写入 - 通过小程序读取已写入的NFC标签实现业务闭环 3. **调试提示** - 通过`wx.getNFCAdapter()`获取实例后，使用`.getNdef()`方法验证标签格式是否符合要求 - 使用开发者工具"快速URL Scheme编译"功能测试Scheme有效性 参考文档: [NFC标签打开小程序指南](https://developers.weixin.qq.com/miniprogram/dev/framework/open-ability/NFC.html) [NFCAdapter接口说明](https://developers.weixin.qq.com/miniprogram/dev/api/device/nfc/NFCAdapter.html)

根据设备能力管理界面显示，若无法找到已申请的消息模板，请按以下步骤处理： 1. **审核状态确认** - 检查消息能力申请是否通过审核（审核周期1-3个工作日） - 在管理后台「设备能力」模块查看申请状态，仅审核通过的模板会出现在公共模板库 2. **模板获取路径** - 进入小程序管理后台→「订阅消息」→「公共模板库」 - 选择「设备消息」分类，通过搜索关键词或模板ID定位已申请模板 3. **关键验证点** - 确认申请的模板类型为「设备消息」（与普通订阅消息模板分离） - 检查模板关键词是否使用平台预设枚举值（如"设备告警"、"设备状态"等标准字段） - 确保设备型号ID(model_id)与模板申请时填写的设备类型一致 若模板仍未显示，建议： - 在公共模板库切换「全部/已生效」筛选状态 - 核对设备能力申请时填写的模板ID与后台记录是否一致 参考文档： [设备消息接入指南](https://developers.weixin.qq.com/miniprogram/dev/framework/device/device-message.html) [硬件设备管理说明](https://developers.weixin.qq.com/miniprogram/dev/framework/device/device-access.html)

在小程序内实现站内导航功能（不跳转第三方APP）需按以下方案实施： 一、核心实现步骤 1. 地图基础配置 - 使用微信原生map组件（需在组件中配置`subkey`参数） - 申请腾讯位置服务专属subkey（需企业资质认证） 2. 路径规划开发 - 调用腾讯地图路径规划接口（需通过服务端中转请求） - 在服务端处理路径规划响应，返回坐标点集合 3. 导航功能实现 - 使用wx.startLocationUpdateBackground获取持续定位 - 通过map组件的polyline属性绘制规划路线 - 自定义导航UI（需开发实时位置纠偏逻辑） 二、关键技术要点 1. 地图配置规范 ```json // app.json { "requiredPrivateInfos": ["getLocation"], "requiredBackgroundModes": ["location"] } ``` 2. 路线绘制实现 ```javascript // 正确使用polyline属性 this.setData({ polyline: [{ points: convertedPoints, // 转换后的坐标点数组 color: '#FF0000DD', width: 6, arrowLine: true // 显示方向箭头 }] }) ``` 三、必要注意事项 1. 类目审核要求 - 需选择交通服务/生活服务等指定类目 - 需通过接口权限审核（开发管理后台-接口设置） 2. 权限声明 - 在app.json声明地理位置用途说明 - 需用户授权scope.userLocationBackground权限 3. 合规要求 - 需在用户首次定位时提供用途说明弹窗 - 需处理用户拒绝授权场景 四、功能限制说明 1. 无法实现车道级导航等专业功能 2. 实时路况需购买腾讯位置服务商业授权 3. 语音导航需自行集成TTS能力 参考文档： [map组件文档](https://developers.weixin.qq.com/miniprogram/dev/component/map.html) [持续定位接口文档](https://developers.weixin.qq.com/miniprogram/dev/api/location/wx.startLocationUpdateBackground.html)

调用wx.makePhoneCall接口时，iOS系统弹出的电话呼叫菜单背景色由系统主题决定，小程序无法通过API直接修改该菜单的样式颜色。目前微信小程序未提供相关配置参数来强制指定深色或浅色模式。 相关说明： 1. 系统级弹窗样式由iOS系统统一管理，开发者无法自定义 2. 菜单颜色模式自动跟随系统设置（深色/浅色模式） 3. 小程序全局样式配置（如app.json中的window设置）不影响系统原生组件 建议解决方案： 1. 通过系统设置统一调整显示模式（设置 > 显示与亮度） 2. 在小程序界面设计时考虑系统主题的适配性 参考文档： [wx.makePhoneCall接口文档](https://developers.weixin.qq.com/miniprogram/dev/api/device/phone/wx.makePhoneCall.html)

在自定义组件中获取slot元素信息需遵循以下方法： 1. **作用域原则** - slot内容实际由父组件渲染，存在于父组件作用域 - 子组件无法直接通过createSelectorQuery查询slot内容 2. **正确获取方式** ```javascript // 父组件逻辑 Page({ onReady() { this.createSelectorQuery() .select('.slot-content') // 直接查询父组件作用域内的slot内容 .boundingClientRect(rect => { console.log('元素位置信息:', rect) // 通过自定义事件传递数据给子组件 this.selectComponent('.child-component').triggerEvent('position-update', rect) }).exec() } }) ``` **关键注意事项**： 1. 必须在父组件作用域内执行查询操作 2. 建议在onReady生命周期执行以确保节点渲染完成 3. 若需要子组件获取信息，应通过父组件查询后通过自定义事件传递 4. 避免在子组件内直接操作父组件作用域的节点 参考文档： [组件间通信与事件](https://developers.weixin.qq.com/miniprogram/dev/framework/custom-component/events.html) [节点信息查询](https://developers.weixin.qq.com/miniprogram/dev/framework/view/selector.html)

小程序URL Scheme有效期规则如下： 1. **加密URL Scheme**： - 通过服务端接口生成，支持设置失效时间 - 失效方式配置： ▷ 绝对时间（expire_time）：Unix时间戳，与当前时间间隔不超过30天 ▷ 相对天数（expire_interval）：设置间隔天数，最长30天 - 参数组合规则： • 当is_expire=true且expire_type=0时，必须填写expire_time • 当is_expire=true且expire_type=1时，必须填写expire_interval 2. **明文URL Scheme**： - 由开发者自行拼接生成，无需接口调用 - 有效性取决于： ▷ 小程序页面路径是否持续有效（需已发布） ▷ 参数格式是否符合规范（如字符集限制、url_encode等） **核心区别**： - 加密Scheme必须通过API生成，且参数设置的有效期最长30天 - 明文Scheme无系统预设有效期，但若页面路径被删除或参数格式变更，会导致链接失效 **注意事项**： 1. 所有Scheme最终有效性受小程序页面发布状态影响 2. 加密Scheme的expire_time参数必须设置为未来时间，且与当前时间间隔≤30天 3. 明文Scheme参数变更（如path或query调整）会导致历史链接失效 参考文档： - [获取小程序链接](https://developers.weixin.qq.com/miniprogram/dev/framework/open-ability/url-scheme.html) - [生成加密scheme码接口](https://developers.weixin.qq.com/miniprogram/dev/OpenApiDoc/qrcode-link/url-scheme/generateScheme.html)