需适配的组件汇总

  • 多端框架是基于与小程序同源的技术实现,大部分的小程序组件在多端应用中均可使用,但的确有部分的组件因为产品载体已经变成为 App,无法再支持的,开发者需对这部分的组件进行兼容性处理
  • 为方便开发者对组件进行兼容处理,本文将需开发者适配处理的组件进行汇总,如对相关的内容有疑问,可联系小助手open in new window进行反馈处理

一、需开发者进行适配兼容的组件

  • 下方功能需使用新的接口或者组件进行实现
名称功能说明备注
buttonopen in new window按钮支持,但 open-type 涉及的微信开放能力均不支持
imageopen in new window图片支持,但是长按识别的功能尚不支持

1、button

open-type功能说明兼容备注
contact打开客服会话• 在 App 中不支持使用小程序客服能力,开发者可使用微信客服功能代替,查看接口详情wx.miniapp.openCustomerServiceChatopen in new window
share转发• 在 App 中如需使用微信分享能力,可使用 wx.miniapp.shareImageMessageopen in new windowwx.miniapp.shareMiniProgramMessageopen in new windowwx.miniapp.shareTextMessageopen in new windowwx.miniapp.shareWebPageMessageopen in new windowwx.miniapp.shareVideoMessageopen in new window
getPhoneNumber获取手机号• 在 App 中可使用新组件本机号码一键登录open in new window 实现
getUserInfo获取用户信息• 在 App 中可使用新接口 wx.miniapp.loginopen in new window 或者 wx.weixinAppLoginopen in new window 实现获取用户的头像和昵称
chooseAvatar获取用户头像• 在 App 中可使用新接口 wx.miniapp.loginopen in new window 或者 wx.weixinAppLoginopen in new window 实现获取用户的头像和昵称
launchApp打开 App• 在 App 中暂未支持打开另一个 App,后续会提供新的接口实现该功能
openSetting打开授权设置页• 在 App 中使用 wx.openAppAuthorizeSetting 代替
feedback打开“意见反馈”页面• 在 App 中不支持打开“意见反馈”页面

2、 image

  • imageopen in new window 组件中 show-menu-by-longpress 的功能(长按图片显示发送给朋友、收藏、保存图片、搜一搜、打开名片/前往群聊/打开小程序)暂不支持

3、web-view

  • 从 iOS >= 1.0.17,Android >= 1.0.8 开始,web-view 打开 h5 获取到的 UA 将不再带有微信相关的标识,同时新增了 SAAASDK 用于表示多端的运行环境。
  • 如开发者在多端应用中的 h5 中使用到了 jssdk 用于与小程序交互,需将 jssdk 升级至 1.6.2open in new window
  • 补充说明 1:在多端应用中通过 web-view 打开 H5,无需在平台中配置业务域名,直接可打开
  • 补充说明 2:Skyline 暂不支持 web-view 组件,建议承载 web-view 的页面单独配置 "renderer": "webview",详情可查看文档open in new window
  • jssdk 支持的接口情况可查看

小程序相关的接口

接口名说明
wx.miniProgram.navigateTo参数与小程序接口一致
wx.miniProgram.navigateBack参数与小程序接口一致
wx.miniProgram.switchTab参数与小程序接口一致
wx.miniProgram.reLaunch参数与小程序接口一致
wx.miniProgram.redirectTo参数与小程序接口一致
wx.miniProgram.postMessage向小程序发送消息,会在以下特定时机触发组件的message事件:小程序后退、组件销毁、分享、复制链接({%version('2.31.1')%})
wx.miniProgram.getEnv获取当前环境

其他 JSSDK 接口

接口模块接口说明具体接口多端应用 支持情况
判断客户端是否支持jscheckJSApiAndroid支持
图像接口拍照或上传chooseImageAndroid支持
预览图片previewImage
上传图片uploadImage
下载图片downloadImage
获取本地图片getLocalImgData
音频接口开始录音startRecord
停止录音stopRecord
监听录音自动停止onVoiceRecordEnd
播放语音playVoice
暂停播放pauseVoice
停止播放stopVoice
监听语音播放完毕onVoicePlayEnd
上传接口uploadVoice
下载接口downloadVoice
智能接口识别音频translateVoice
设备信息获取网络状态getNetworkTypeAndroid支持
地理位置使用内置地图打开地点openLocation
获取地理位置getLocationAndroid支持(需在 project.miniapp.json 中勾选 扩展 LBS SDK )
摇一摇周边开启ibeaconstartSearchBeacons
关闭ibeaconstopSearchBeacons
监听ibeacononSearchBeacons
微信扫一扫调起微信扫一扫scanQRCode
微信卡券拉取使用卡券列表chooseCard
批量添加卡券接口addCard
查看微信卡包的卡券openCard
长按识别小程序圆形码

4、video

在 App 中使用 video 组件实现投屏的功能时,需要申请组播权限,相关的操作如下:

二、尚未支持的组件