微信小程序开发文档—

开放能力

open-data （用于展示微信开放的数据。）

web-view（web-view 组件是一个可以用来承载网页的容器，会自动铺满整个小程序页面。个人类型与海外类型的小程序暂不支持使用。）

ad（广告。目前暂时以邀请制开放申请，请留意后续模板消息的通知）

official-account（用户扫码打开小程序时，开发者可在小程序内配置公众号关注组件，方便用户快捷关注公众号，可嵌套在原生组件内。）

open-data

属性名类型默认值说明

type String 开放数据类型

open-gid String 当 type="groupName" 时生效, 群id

lang String en 当 type="user*" 时生效，以哪种语言展示 userInfo，有效值有：en, zh_CN, zh_TW

type 有效值：

值说明最低版本

groupName 拉取群名称 1.4.0

userNickName 用户昵称 1.9.90

userAvatarUrl 用户头像 1.9.90

userGender 用户性别 1.9.90

userCity 用户所在城市 1.9.90

userProvince 用户所在省份 1.9.90

userCountry 用户所在国家 1.9.90

userLanguage 用户的语言 1.9.90
<open-data type="groupName" open-gid="xxxxxx"></open-data>
<open-data type="userAvatarUrl"></open-data>
<open-data type="userGender" lang="zh_CN"></open-data>

属性名	类型	默认值	说明
type	String		开放数据类型
open-gid	String		当 type="groupName" 时生效, 群id
lang	String	en	当 type="user*" 时生效，以哪种语言展示 userInfo，有效值有：en, zh_CN, zh_TW

值	说明	最低版本
groupName	拉取群名称	1.4.0
userNickName	用户昵称	1.9.90
userAvatarUrl	用户头像	1.9.90
userGender	用户性别	1.9.90
userCity	用户所在城市	1.9.90
userProvince	用户所在省份	1.9.90
userCountry	用户所在国家	1.9.90
userLanguage	用户的语言	1.9.90

web-view

属性名类型默认值说明

src String webview 指向网页的链接。可打开关联的公众号的文章，其它网页需登录小程序管理后台配置业务域名。

bindmessage EventHandler 网页向小程序 postMessage 时，会在特定时机（小程序后退、组件销毁、分享）触发并收到消息。e.detail = { data }，data是多次 postMessage 的参数组成的数组

bindload EventHandler 网页加载成功时候触发此事件。e.detail = { src }

binderror EventHandler 网页加载失败的时候触发此事件。e.detail = { src }


<web-view src="https://mp.weixin.qq.com/"></web-view>
相关接口 1:

<web-view>网页中可使用JSSDK 1.3.2提供的接口返回小程序页面。支持的接口有：

接口名说明最低版本

wx.miniProgram.navigateTo 参数与小程序接口一致 1.6.4

wx.miniProgram.navigateBack 参数与小程序接口一致 1.6.4

wx.miniProgram.switchTab 参数与小程序接口一致 1.6.5

wx.miniProgram.reLaunch 参数与小程序接口一致 1.6.5

wx.miniProgram.redirectTo 参数与小程序接口一致 1.6.5

wx.miniProgram.postMessage 向小程序发送消息，会在特定时机（小程序后退、组件销毁、分享）触发组件的message事件 1.7.1

wx.miniProgram.getEnv 获取当前环境 1.7.1

<scripttype="text/javascript"src="https://res.wx.qq.com/open/js/jweixin-1.3.2.js"
></script>// javascript wx.miniProgram.navigateTo({url: '/path/to/page'})
wx.miniProgram.postMessage({ data: 'foo' }) wx.miniProgram.postMessage({ data:
{foo: 'bar'} }) wx.miniProgram.getEnv(function(res) {
console.log(res.miniprogram) // true })
相关接口 2:

<web-view>网页中仅支持以下JSSDK接口：

接口模块接口说明具体接口

判断客户端是否支持js checkJSApi

图像接口拍照或上传 chooseImage

预览图片 previewImage

上传图片 uploadImage

下载图片 downloadImage

获取本地图片 getLocalImgData

音频接口开始录音 startRecord

停止录音 stopRecord

监听录音自动停止 onVoiceRecordEnd

播放语音 playVoice

暂停播放 pauseVoice

停止播放 stopVoice

监听语音播放完毕 onVoicePlayEnd

上传接口 uploadVoice

下载接口 downloadVoice

智能接口识别音频 translateVoice

设备信息获取网络状态 getNetworkType

地理位置使用内置地图打开地点 openLocation

获取地理位置 getLocation

摇一摇周边开启ibeacon startSearchBeacons

关闭ibeacon stopSearchBeacons

监听ibeacon onSearchBeacons

微信扫一扫调起微信扫一扫 scanQRCode

微信卡券拉取使用卡券列表 chooseCard

批量添加卡券接口 addCard

查看微信卡包的卡券 openCard

长按识别小程序圆形码无

相关接口 3:

用户分享时可获取当前<web-view>的URL，即在onShareAppMessage回调中返回webViewUrl参数。
Page({onShareAppMessage(options) {console.log(options.webViewUrl)}
})
相关接口 4

在网页内可通过window.__wxjs_environment变量判断是否在小程序环境，建议在WeixinJSBridgeReady回调中使用，也可以使用JSSDK 1.3.2提供的getEnv接口。
// web-view下的页面内
function ready() {console.log(window.__wxjs_environment === 'miniprogram') // true
}
if (!window.WeixinJSBridge || !WeixinJSBridge.invoke) {document.addEventListener('WeixinJSBridgeReady', ready, false)
} else {ready()
}// 或者
wx.miniProgram.getEnv(function (res) {console.log(res.miniprogram) // true
})
相关接口 5

从微信7.0.0开始，可以通过判断userAgent中包含miniProgram字样来判断小程序web-view环境。

属性名	类型	说明
src	String	webview 指向网页的链接。可打开关联的公众号的文章，其它网页需登录小程序管理后台配置业务域名。
bindmessage	EventHandler	网页向小程序 postMessage 时，会在特定时机（小程序后退、组件销毁、分享）触发并收到消息。e.detail = { data }，data是多次 postMessage 的参数组成的数组
bindload	EventHandler	网页加载成功时候触发此事件。e.detail = { src }
binderror	EventHandler	网页加载失败的时候触发此事件。e.detail = { src }

接口名	说明	最低版本
wx.miniProgram.navigateTo	参数与小程序接口一致	1.6.4
wx.miniProgram.navigateBack	参数与小程序接口一致	1.6.4
wx.miniProgram.switchTab	参数与小程序接口一致	1.6.5
wx.miniProgram.reLaunch	参数与小程序接口一致	1.6.5
wx.miniProgram.redirectTo	参数与小程序接口一致	1.6.5
wx.miniProgram.postMessage	向小程序发送消息，会在特定时机（小程序后退、组件销毁、分享）触发组件的message事件	1.7.1
wx.miniProgram.getEnv	获取当前环境	1.7.1

接口模块	接口说明	具体接口
判断客户端是否支持js		checkJSApi
图像接口	拍照或上传	chooseImage
	预览图片	previewImage
	上传图片	uploadImage
	下载图片	downloadImage
	获取本地图片	getLocalImgData
音频接口	开始录音	startRecord
	停止录音	stopRecord
	监听录音自动停止	onVoiceRecordEnd
	播放语音	playVoice
	暂停播放	pauseVoice
	停止播放	stopVoice
	监听语音播放完毕	onVoicePlayEnd
	上传接口	uploadVoice
	下载接口	downloadVoice
智能接口	识别音频	translateVoice
设备信息	获取网络状态	getNetworkType
地理位置	使用内置地图打开地点	openLocation
	获取地理位置	getLocation
摇一摇周边	开启ibeacon	startSearchBeacons
	关闭ibeacon	stopSearchBeacons
	监听ibeacon	onSearchBeacons
微信扫一扫	调起微信扫一扫	scanQRCode
微信卡券	拉取使用卡券列表	chooseCard
	批量添加卡券接口	addCard
	查看微信卡包的卡券	openCard
长按识别	小程序圆形码	无

ad

属性名类型默认值说明版本

unit-id String 广告单元id，可在小程序管理后台的流量主模块新建

bindload Handler 广告加载成功的回调 2.2.1

binderror Handler 当广告发生错误时，触发的事件，可以通过该事件获取错误码及原因，事件对象event.detail = {errCode: 1002} 2.2.1

注1：监听到error回调后，开发者可以针对性的处理，比如隐藏广告组件的父容器，以保证用户体验，但不要移除广告组件，否则将无法收到bindload的回调。

错误码信息与解决方案表

错误码是通过binderror回调获取到的错误信息。

代码异常情况理由解决方案

1000 后端错误调用失败该项错误不是开发者的异常情况一般情况下忽略一段时间即可恢复。

1001 参数错误使用方法错误可以前往developers.weixin.qq.com确认具体教程（小程序和小游戏分别有各自的教程，可以在顶部选项中，“设计”一栏的右侧进行切换。

1002 广告单元无效可能是拼写错误、或者误用了其他APP的广告ID 请重新前往mp.weixin.qq.com确认广告位ID。

1003 内部错误该项错误不是开发者的异常情况一般情况下忽略一段时间即可恢复。

1004 无适合的广告广告不是每一次都会出现，这次没有出现可能是由于该用户不适合浏览广告属于正常情况，且开发者需要针对这种情况做形态上的兼容。

1005 广告组件审核中你的广告正在被审核，无法展现广告请前往mp.weixin.qq.com确认审核状态，且开发者需要针对这种情况做形态上的兼容。

1006 广告组件被驳回你的广告审核失败，无法展现广告请前往mp.weixin.qq.com确认审核状态，且开发者需要针对这种情况做形态上的兼容。

1007 广告组件被驳回你的广告能力已经被封禁，封禁期间无法展现广告请前往mp.weixin.qq.com确认小程序广告封禁状态。

1008 广告单元已关闭该广告位的广告能力已经被关闭请前往mp.weixin.qq.com重新打开对应广告位的展现。

属性名	类型	说明	版本
unit-id	String	广告单元id，可在小程序管理后台的流量主模块新建
bindload	Handler	广告加载成功的回调	2.2.1
binderror	Handler	当广告发生错误时，触发的事件，可以通过该事件获取错误码及原因，事件对象event.detail = {errCode: 1002}	2.2.1

代码	异常情况	理由	解决方案
1000	后端错误调用失败	该项错误不是开发者的异常情况	一般情况下忽略一段时间即可恢复。
1001	参数错误	使用方法错误	可以前往developers.weixin.qq.com确认具体教程（小程序和小游戏分别有各自的教程，可以在顶部选项中，“设计”一栏的右侧进行切换。
1002	广告单元无效	可能是拼写错误、或者误用了其他APP的广告ID	请重新前往mp.weixin.qq.com确认广告位ID。
1003	内部错误	该项错误不是开发者的异常情况	一般情况下忽略一段时间即可恢复。
1004	无适合的广告	广告不是每一次都会出现，这次没有出现可能是由于该用户不适合浏览广告	属于正常情况，且开发者需要针对这种情况做形态上的兼容。
1005	广告组件审核中	你的广告正在被审核，无法展现广告	请前往mp.weixin.qq.com确认审核状态，且开发者需要针对这种情况做形态上的兼容。
1006	广告组件被驳回	你的广告审核失败，无法展现广告	请前往mp.weixin.qq.com确认审核状态，且开发者需要针对这种情况做形态上的兼容。
1007	广告组件被驳回	你的广告能力已经被封禁，封禁期间无法展现广告	请前往mp.weixin.qq.com确认小程序广告封禁状态。
1008	广告单元已关闭	该广告位的广告能力已经被关闭	请前往mp.weixin.qq.com重新打开对应广告位的展现。

offical-account

使用组件前，需前往小程序后台，在“设置”->“接口设置”->“公众号关注组件”中设置要展示的公众号。

注：设置的公众号需与小程序主体一致。

在一个小程序的生命周期内，只有从以下场景进入小程序，才具有展示引导关注公众号组件的能力:

当小程序从扫二维码场景（场景值1011）打开时

当小程序从扫小程序码场景（场景值1047）打开时

当小程序从聊天顶部场景（场景值1089）中的「最近使用」内打开时，若小程序之前未被销毁，则该组件保持上一次打开小程序时的状态

当从其他小程序返回小程序（场景值1038）时，若小程序之前未被销毁，则该组件保持上一次打开小程序时的状态

组件限定最小宽度为300px，高度为定值84px。

每个页面只能配置一个该组件。

属性名类型说明

bindload EventHandle 组件加载成功时触发

binderror EventHandle 组件加载失败时触发

detail对象

属性名类型说明

status Number 状态码

errMsg String 错误信息

状态码

值说明

-2 网络错误

-1 数据解析错误

0 加载成功

1 小程序关注公众号功能被封禁

2 关联公众号被封禁

3 关联关系解除或未选中关联公众号

4 未开启关注公众号功能

5 场景值错误

6 重复创建
<official-account></official-account>

属性名	类型	说明
bindload	EventHandle	组件加载成功时触发
binderror	EventHandle	组件加载失败时触发

属性名	类型	说明
status	Number	状态码
errMsg	String	错误信息

值	说明
-2	网络错误
-1	数据解析错误
0	加载成功
1	小程序关注公众号功能被封禁
2	关联公众号被封禁
3	关联关系解除或未选中关联公众号
4	未开启关注公众号功能
5	场景值错误
6	重复创建

微信小程序开发文档——开放能力相关推荐

微信小程序开发文档及文件上传示例（JAVA）
微信小程序开发文档及文档上传示例一.什么是微信小程序小程序是一种无需下载安装,即可使用的手机应用.只需要扫描二维码,或是搜一搜,就能立即使用. 与APP不同的是,小程序无需下载安装.无需卸载.用完 ...
微信小程序开发文档和开发工具放出破解版-亲测可用
废话不多说,直接上衔接 1,微信小程序开发文档现阶段最全的开发文档了 http://wxopen.notedown.cn/api/notice.html 2,开发工具 https://github. ...
微信小程序开发文档
官方开发文档: 小程序公众平台小程序开发者指南小程序开发者文档学习资源: 微信:官方入门教程微信:WeUI 是一套同微信原生视觉体验一致的基础样式库微信:微信小程序示例视频: 学堂在线:学 ...
学习微信小程序开发文档总结
1.认识微信小程序 1.完成小程序注册微信公众平台 (qq.com)根据步骤进行小程序注册,最终获得一个AppID,下载开发者工具,安装后建立第一个小程序项目,填入AppID,才可通过微信扫码进行真 ...
微信小程序开发文档（4）
微信小程序开放接口: 收货地址 Card卡券调起客户端小程序设置界面获取用户过去三十天微信运动步数打开小程序获取发票抬头微信小游戏开发能力: 用户授权开放能力用户登录态签名二维码开放能力 ...
微信小程序开发文档-小程序配置 /全局配置
# 全局配置小程序根目录下的 app.json 文件用来对微信小程序进行全局配置.文件内容为一个 JSON 对象,有以下属性: # 配置项属性类型必填描述最低版本 entryPagePat ...
微信小程序开发文档——地图
地图 map map 属性名类型默认值说明最低版本 longitude Number 中心经度 latitude Number 中心纬度 scale Number 16 缩放级 ...
微信小程序开发文档链接
https://developers.weixin.qq.com 转载于:https://www.cnblogs.com/QGqiezi/p/9316130.html
微信小程序开发文档官方
原文地址:https://developers.weixin.qq.com/miniprogram/dev/component/view.html

微信小程序开发文档——开放能力

开放能力

微信小程序开发文档——开放能力相关推荐

最新文章

热门文章