# 需适配的 API 汇总
- 多端框架是基于与小程序同源的技术实现,大部分的小程序 JSAPI 在多端应用中均可使用,但的确有部分的 API 因为产品载体已经变成为 App,无法再支持的,开发者需对这部分的 API 进行兼容性处理
- 为方便开发者对 API 进行兼容处理,本文将需开发者适配处理的 API 进行汇总,如对相关的内容有疑问,可联系小助手进行反馈处理
对于不支持的 API,通常可分为 3 种情况:
- 部分是有新的 API 进行替换或者是原有的 API 在参数上进行了一些调整:开发者使用条件编译语法进行兼容处理即可
- 部分 API 是尚未支持:是官方有计划支持或者已经在开发中,届时上线后,开发者使用条件编译语法进行兼容处理即可
- 部分 API 无法在 App 中支持:此种情况需开发者提前了解,需寻求其他替换方案或者在 App 中不提供相关功能
# 一、需开发者进行适配兼容的接口
- 下方功能需使用新的 API 进行实现
名称 | 功能说明 | 需使用新 API |
---|---|---|
wx.login | 小程序登录 | • 关于在 App 中实现登录的功能,平台提供了多种方案,涉及多个 API • 详情可查看微信登录说明 以及小程序登录适配方案说明 |
wx.showShareXXX | 转发(微信分享相关功能) | • 在 App 中使用微信分享(分享图片、分享文本、分享网页、分享小程序等)功能,需使用新的 wx.miniapp.shareXXXX 接口实现,详情可查看转发 |
- | App 拉起小程序 | • 在 App 中拉起小程序需要使用新接口,详情可查看wx.miniapp.launchMiniProgram |
wx.requestPayment | 微信支付 | • 需使用新接口 wx.miniapp.requestPayment • 部分 iOS 场景中,需使用苹果内购 IAP(In-App Purchase),详情可查看 wx.miniapp.IAP |
wx.openCustomerServiceChat | 打开微信客服 | • 需使用新接口 wx.miniapp.openCustomerServiceChat |
wx.requestSubscribeMessage | 订阅消息 | • 小程序订阅消息能力在 App 中无法使用; • App 中支持一次性订阅消息接口 wx.miniapp.requestSubscribeMessage - App 的消息推送可查看消息推送使用指南 |
wx.getSystemInfo | 获取系统信息 | • 该接口的返回参数有所调整,详情可查看wx.getSystemInfo • wx.getSystemInfoSync 的参数返回处理同 wx.getSystemInfo |
wx.getAppBaseInfo | 获取 App 基础信息 | • 该接口的返回参数有所调整,详情可查看wx.getAppBaseInfo |
wx.getLaunchOptionsSync | 获取本次应用启动时的参数 | • 该接口的返回参数有所调整,详情可查看wx.getLaunchOptionsSync |
wx.getEnterOptionsSync | 获取应用启动时的参数 | • 该接口的返回参数有所调整,详情可查看wx.getEnterOptionsSync |
wx.getMenuButtonBoundingClientRect | 获取菜单按钮(右上角胶囊按钮)的布局位置信息 | • App里不再呈现胶囊标识,该接口依旧返回相关坐标信息,便于开发者进行多端兼容 • 需该接口当前的返回不满足需求,可联系小助手进行反馈 |
wx.getBackgroundAudioManager | 获取全局唯一的背景音频管理器 | • 该接口是在小程序提供的同名 API 上拓展的,详情可查看wx.getBackgroundAudioManager |
# 二、尚未支持的接口
- 包含暂无计划支持和已在开发中的接口,详情可查看 API 总览