开放能力
最后更新时间：2025-04-29 18:40:51
ad
功能说明：Banner 广告
参数及说明：使用小程序广告功能的前提是开启了商业化权限。
属性 | 类型 | 默认值 | 说明 |
unit-id | string | - | 广告单元 id，可在控制台广告模块创建 ，必填 |
bindload | eventhandler | - | 广告加载成功的回调 |
binderror | eventhandler | - | 广告加载失败的回调，event.detail = {errCode: 1002} |
错误码信息
错误码是通过 error 获取到的错误信息。调试期间，可以通过异常返回来捕获信息。可以针对异常返回加上适当的监控信息辅助排查现网情况。
错误码 | 异常情况 | 理由 |
1000 | 后端接口调用失败 | 该项错误不是开发者导致的异常情况 |
1001 | 参数错误 | 使用方法错误 |
1002 | 广告单元无效 | 可能是广告位 ID 拼写错误或者是误用了其他 APP 的广告 ID |
1003 | 内部错误 | 该项错误不是开发者导致的异常情况 |
1004 | 无合适的广告 | 广告不是每一次都会出现，这次没有出现可能是由于该用户不适合浏览广告 |
1010 | 广告功能已禁用 | 您的广告功能已禁用 |
web-view
功能说明：承载网页的容器。会自动铺满整个小程序页面。
参数及说明：
属性 | 类型 | 默认值 | 说明 |
src | string | - | webview 指向网页的链接。网页需登录小程序管理后台配置业务域名。 离线的 H5 网页，以 file:// 和 / 开头的路径（指向html页面，如：file://xxx/index.html）。需在 app.json 里面配置 staticPath 属性（字符串数组）,如：["xxx"]。 |
use-web-title | boolean | true | web-view 组件所在页面的导航栏标题是否显示网页的title |
bindmessage | eventhandler | - | 网页使用 wx.miniProgram.postMessage 方法向小程序发送消息时，小程序会在特定时机（小程序后退、组件销毁、分享）触发并收到消息。e.detail = { data }，data 是多次 postMessage 的参数组成的数组 |
bindload | eventhandler | - | 网页加载成功时候触发此事件。e.detail = { src } |
binderror | eventhandler | - | 网页加载失败的时候触发此事件。e.detail = { url, fullUrl }，其中 fullUrl 为加载失败时的完整 url |
bindevent | eventhandler | - | 网页使用 wx.miniProgram.sendWebviewEvent 方法向小程序发送消息时，小程序会触发此事件。e.detail = { data }，data 是 sendWebviewEvent 的参数 |
注意：
网页内 iframe 的域名也需要配置到域名白名单。
开发者工具上，可以在 <web-view> 组件上点击调试按钮，打开 <web-view> 组件的调试。
每个页面只能有一个 <web-view>，<web-view> 会自动铺满整个页面，并覆盖其他组件。
<web-view> 网页与小程序之间不支持除 JSSDK 提供的接口之外的通信。
避免在链接中带有中文字符，在 iOS 中会有打开白屏的问题，建议加一下 encodeURIComponent。
相关接口详见 JSSDK接口说明。
<web-view>组件所在页面的导航栏标题优先级：
<title></title>(H5网页中已配置 title 且use-web-title为 true ) > navigationBarTitleText(page.json)> navigationBarTitleText(app.json)src 填写静态资源地址时必须以 file:// 和 / 开头，且具体到某个 html 页面，静态资源需要在小程序的根目录下，同时需要在 app.json 中配置 staticPath 属性（string[]，静态资源的目录名称），可配置多个静态资源，静态资源只支持在主包内，小程序上传时所有静态资源和小程序一同上传，且整体大小不能超过小程序的整包大小限制。
授权
部分接口需要经过用户授权同意才能调用。我们把这些接口按使用范围分成多个 scope ，用户选择对 scope 来进行授权，当授权给一个 scope 之后，其对应的所有接口都可以直接使用。
此类接口调用时：
如果用户未接受或拒绝过此权限，会弹窗询问用户，用户单击同意后方可调用接口；
如果用户已授权，可以直接调用接口；
如果用户已拒绝授权，则不会出现弹窗，而是直接进入接口 fail 回调。请开发者兼容用户拒绝授权的场景。
获取用户授权设置
开发者可以使用 wx.getSetting 获取用户当前的授权状态。
打开设置界面
用户可以在小程序设置界面（「右上角」 - 「设置」）中控制对该小程序的授权状态。
开发者可以调用 wx.openSetting 打开设置界面，引导用户开启授权。
提前发起授权请求
开发者可以使用 wx.authorize 在调用需授权 API 之前，提前向用户发起授权请求。
scope 列表
scope | 对应接口 | 描述 |
scope.userinfo | wx.getUserInfo | 用户信息 |
scope.userLocation | wx.getLocation、wx.startLocationUpdate、wx.startLocationUpdateBackground | 获取地理位置信息 |
scope.userFuzzyLocation | wx.getFuzzyLocation | 获取模糊地理位置信息 |
scope.record | live-pusher 组件 or wx.startRecord、wx.operateRecorder | 直播或者录音 |
scope.camera | camera 组件 | 相机组件 |
scope.addPhoneCalendar | wx.addPhoneCalendar | 添加日志 |
scope.writePhotosAlbum | wx.saveImageToPhotosAlbum | 保存图片到相册 |
scope.bluetooth | wx.openBluetoothAdapter | 蓝牙 |
scope.chooseImage | wx.chooseImage | 选择相册中的图片 |
scope.chooseVideo | wx.chooseVideo | 选择相册中的视频 |
scope.chooseMedia | wx.chooseMedia | 从手机相册中选择图片或视频 |
scope.makeMedia | wx.makeMedia | 拍摄视频或图片 |
scope.addPhoneContact | wx.addPhoneContact、wx.chooseContact | 添加/选择联系人 |
授权有效期
一旦用户明确同意或拒绝过授权，其授权关系会记录在客户端本地，直到删除小程序。
实践指南
在真正需要使用授权接口时，才向用户发起授权申请，并在授权申请中说明清楚要使用该功能的理由。
文档反馈