微信開(kāi)放標(biāo)簽是微信公眾平臺(tái)面向網(wǎng)頁(yè)開(kāi)發(fā)者提供的擴(kuò)展標(biāo)簽集合懈词。通過(guò)使用微信開(kāi)放標(biāo)簽谴供,網(wǎng)頁(yè)開(kāi)發(fā)者可安全便捷地使用微信或系統(tǒng)的能力脂信,為微信用戶提供更優(yōu)質(zhì)的網(wǎng)頁(yè)體驗(yàn)迟郎。此文檔面向網(wǎng)頁(yè)開(kāi)發(fā)者剥险,介紹微信開(kāi)放標(biāo)簽如何使用及相關(guān)注意事項(xiàng)。需要注意的是宪肖,微信開(kāi)放標(biāo)簽有最低的微信版本要求表制,以及最低的系統(tǒng)版本要求。微信版本要求為:7.0.12及以上控乾。 系統(tǒng)版本要求為:iOS 10.3及以上么介、Android 5.0及以上。
開(kāi)放標(biāo)簽使用步驟
1.綁定域名
登錄微信公眾平臺(tái)進(jìn)入“公眾號(hào)設(shè)置”的“功能設(shè)置”里填寫(xiě)“JS接口安全域名”, JS接口安全域名對(duì)應(yīng)H5頁(yè)面域名地址
2.引入JS文件
在需要調(diào)用JS接口的頁(yè)面引入如下JS文件:http://res.wx.qq.com/open/js/jweixin-1.6.0.js (支持https)
也支持npm包方式引入, 版本需==1.6.0==及以上
3.通過(guò)config接口注入權(quán)限驗(yàn)證配置并申請(qǐng)所需開(kāi)放標(biāo)簽
與使用JS-SDK配置方式相同阱持,所有需要使用開(kāi)放標(biāo)簽的頁(yè)面必須先注入配置信息夭拌,并通過(guò)openTagList字段申請(qǐng)所需要的開(kāi)放標(biāo)簽,否則將無(wú)法使用(同一個(gè)url僅需調(diào)用一次)衷咽。
wx.config({
debug: true, // 開(kāi)啟調(diào)試模式,調(diào)用的所有api的返回值會(huì)在客戶端alert出來(lái)鸽扁,若要查看傳入的參數(shù),可以在pc端打開(kāi)镶骗,參數(shù)信息會(huì)通過(guò)log打出桶现,僅在pc端時(shí)才會(huì)打印
appId: '', // 必填,公眾號(hào)的唯一標(biāo)識(shí)
timestamp: , // 必填鼎姊,生成簽名的時(shí)間戳
nonceStr: '', // 必填骡和,生成簽名的隨機(jī)串
signature: '',// 必填相赁,簽名
jsApiList: [], // 必填,需要使用的JS接口列表
openTagList: [] // 可選慰于,需要使用的開(kāi)放標(biāo)簽列表钮科,例如['wx-open-launch-app']
});
4.頁(yè)面喚起小程序代碼
<wx-open-launch-weapp
id="launch-btn"
username="gh_XXXXX"
weappid="wxd44d0XXX0f0dXXX"
path="/pages/page/page.html?id=aaa"
>
<script type="text/wxtag-template">
<!--html頁(yè)面展示代碼-->
</script>
</wx-open-launch-weapp>
注意點(diǎn)
1.此功能的開(kāi)放對(duì)象
- 已認(rèn)證的服務(wù)號(hào),服務(wù)號(hào)綁定“JS接口安全域名”下的網(wǎng)頁(yè)可使用此標(biāo)簽跳轉(zhuǎn)任意合法合規(guī)的小程序婆赠。
- 已認(rèn)證的非個(gè)人主體的小程序绵脯,使用小程序云開(kāi)發(fā)的靜態(tài)網(wǎng)站托管綁定的域名下的網(wǎng)頁(yè),可以使用此標(biāo)簽跳轉(zhuǎn)任意合法合規(guī)的小程序休里。
2.參數(shù)說(shuō)明
- username 所需跳轉(zhuǎn)的==小程序原始id==蛆挫,即小程序?qū)?yīng)的以gh_開(kāi)頭的id, 注意不是公眾號(hào)的id
- 對(duì)于path屬性,所聲明的頁(yè)面路徑必須添加.html后綴妙黍,如
pages/home/index.html
- 如果跳轉(zhuǎn)提示缺少ID, 檢查username對(duì)應(yīng)原始ID是否正確
3. Vue項(xiàng)目中會(huì)報(bào)錯(cuò)該標(biāo)簽不存在, 在main.js文件中添加忽略代碼
// 忽略打開(kāi)微信小程序的組件
Vue.config.ignoredElements = ['wx-open-launch-weapp']