簡介
TNW: TypeScript(The) + Node.js(Next) + WeChat 微信公眾號開發腳手架,支援任何 Node.js 的服務端框架(Express、Nest、egg 等)
介面許可權以及文件
JSSDK使用步驟
步驟一:繫結域名
正式號:登入微信公眾平臺進入 公眾號設定
的 功能設定
裡填寫 JS介面安全域名
測試號:進入微信公眾帳號測試號申請系統 找到 JS介面安全域名
點選 修改
步驟二:引入JS檔案
在需要呼叫JS介面的頁面引入如下JS檔案:res2.wx.qq.com/open/js/jwe… (支援https)
步驟三:通過config介面注入許可權驗證配置
wx.config({
debug: true,
appId: '{{ appId }}',
timestamp: '{{ timestamp }}',
nonceStr: '{{ nonceStr }}',
signature: '{{ signature }}',
jsApiList: [
'checkJsApi',
'...省略其他'
]
});
複製程式碼
TNW 中籤名實現
簽名演算法見 官方文件附錄1
特別注意: url 必須為頁面完整的URL包括引數
@Get('jssdk')
@Render('jssdk.hbs')
async jssdk(@Req() request: Request, @Res() response: Response) {
let appId = ApiConfigKit.getApiConfig.getAppId;
let timestamp = new Date().getTime() / 1000;
let nonceStr = uuid.v1();
let url = "http://xxxx/jssdk?....";//填寫完整頁面的URL包括引數
// 生成簽名
let signature = await WeChat.jssdkSignature(nonceStr, timestamp, url);
return {
appId: appId,
timestamp: timestamp,
nonceStr: nonceStr,
signature: signature
};
}
複製程式碼
步驟四:通過ready介面處理成功驗證
wx.ready(function(){
// config 資訊驗證後會執行 ready 方法,所有介面呼叫都必須在 config 介面獲得結果之後,config 是一個客戶端的非同步操作,所以如果需要在頁面載入時就呼叫相關介面,則須把相關介面放在 ready 函式中呼叫來確保正確執行。對於使用者觸發時才呼叫的介面,則可以直接呼叫,不需要放在 ready 函式中。
});
複製程式碼
步驟五:通過error介面處理失敗驗證
wx.error(function(res){
// config 資訊驗證失敗會執行 error 函式,如簽名過期導致驗證失敗,具體錯誤資訊可以開啟 config 的 debug 模式檢視,也可以在返回的 res 引數中檢視,對於 SPA 可以在這裡更新簽名。
});
複製程式碼
JSSDK 案例
所有JS介面列表見 官方文件附錄2
特別注意:
- 原有的 wx.onMenuShareTimeline、wx.onMenuShareAppMessage、wx.onMenuShareQQ、wx.onMenuShareQZone 介面,即將廢棄。請儘快遷移使用客戶端 6.7.2 及 JSSDK 1.4.0 以上版本支援的 wx.updateAppMessageShareData、updateTimelineShareData 介面。
- 分享介面中的
link
連結必須 JS 介面安全域名下的連結 - 公眾號微信支付後面再詳細介紹
<!DOCTYPE html>
<html>
<head>
<meta charset="utf-8">
<title>TNW 微信公眾號開發腳手架</title>
<meta charset="utf-8">
<meta http-equiv="pragma" content="no-cache">
<meta http-equiv="cache-control" content="no-cache">
<meta http-equiv="expires" content="0">
<meta http-equiv="keywords" content="tnw,nodejs,微信公眾號開發">
<meta http-equiv="description" content="tnw 微信公眾號開發腳手架,可整合到任何 Node.js MVC後端框架中">
<meta name="viewport"
content="width=device-width, initial-scale=1.0, minimum-scale=1.0, maximum-scale=1.0, user-scalable=no">
<link rel="stylesheet" href="https://www.weixinsxy.com/jssdk/css/style.css">
</head>
<body>
<div class="wxapi_container">
<div class="wxapi_index_container">
<ul class="label_box lbox_close wxapi_index_list">
<li class="label_item wxapi_index_item"><a class="label_inner" href="#menu-basic">基礎介面</a></li>
<li class="label_item wxapi_index_item"><a class="label_inner" href="#menu-share">分享介面</a></li>
<li class="label_item wxapi_index_item"><a class="label_inner" href="#menu-image">影像介面</a></li>
<li class="label_item wxapi_index_item"><a class="label_inner" href="#menu-voice">音訊介面</a></li>
<li class="label_item wxapi_index_item"><a class="label_inner" href="#menu-smart">智慧介面</a></li>
<li class="label_item wxapi_index_item"><a class="label_inner" href="#menu-device">裝置資訊介面</a></li>
<li class="label_item wxapi_index_item"><a class="label_inner" href="#menu-location">地理位置介面</a></li>
<li class="label_item wxapi_index_item"><a class="label_inner" href="#menu-webview">介面操作介面</a></li>
<li class="label_item wxapi_index_item"><a class="label_inner" href="#menu-scan">微信掃一掃介面</a></li>
<li class="label_item wxapi_index_item"><a class="label_inner" href="#menu-shopping">微信小店介面</a></li>
<li class="label_item wxapi_index_item"><a class="label_inner" href="#menu-card">微信卡券介面</a></li>
<li class="label_item wxapi_index_item"><a class="label_inner" href="#menu-pay">微信支付介面</a></li>
</ul>
</div>
<div class="lbox_close wxapi_form">
<h3 id="menu-basic">基礎介面</h3>
<span class="desc">判斷當前客戶端是否支援指定JS介面</span>
<button class="btn btn_primary" id="checkJsApi">checkJsApi</button>
<h3 id="menu-share">分享介面</h3>
<span class="desc">“分享給朋友”及“分享到QQ”</span>
<button class="btn btn_primary" id="updateAppMessageShareData">updateAppMessageShareData</button>
<span class="desc">“分享到朋友圈”及“分享到QQ空間”</span>
<button class="btn btn_primary" id="updateTimelineShareData">updateTimelineShareData</button>
<span class="desc">分享到騰訊微博</span>
<button class="btn btn_primary" id="onMenuShareWeibo">onMenuShareWeibo</button>
<h3 id="menu-image">影像介面</h3>
<span class="desc">拍照或從手機相簿中選圖介面</span>
<button class="btn btn_primary" id="chooseImage">chooseImage</button>
<span class="desc">預覽圖片介面</span>
<button class="btn btn_primary" id="previewImage">previewImage</button>
<span class="desc">上傳圖片介面</span>
<button class="btn btn_primary" id="uploadImage">uploadImage</button>
<span class="desc">下載圖片介面</span>
<button class="btn btn_primary" id="downloadImage">downloadImage</button>
<h3 id="menu-voice">音訊介面</h3>
<span class="desc">開始錄音介面</span>
<button class="btn btn_primary" id="startRecord">startRecord</button>
<span class="desc">停止錄音介面</span>
<button class="btn btn_primary" id="stopRecord">stopRecord</button>
<span class="desc">播放語音介面</span>
<button class="btn btn_primary" id="playVoice">playVoice</button>
<span class="desc">暫停播放介面</span>
<button class="btn btn_primary" id="pauseVoice">pauseVoice</button>
<span class="desc">停止播放介面</span>
<button class="btn btn_primary" id="stopVoice">stopVoice</button>
<span class="desc">上傳語音介面</span>
<button class="btn btn_primary" id="uploadVoice">uploadVoice</button>
<span class="desc">下載語音介面</span>
<button class="btn btn_primary" id="downloadVoice">downloadVoice</button>
<h3 id="menu-smart">智慧介面</h3>
<span class="desc">識別音訊並返回識別結果介面</span>
<button class="btn btn_primary" id="translateVoice">translateVoice</button>
<h3 id="menu-device">裝置資訊介面</h3>
<span class="desc">獲取網路狀態介面</span>
<button class="btn btn_primary" id="getNetworkType">getNetworkType</button>
<h3 id="menu-location">地理位置介面</h3>
<span class="desc">使用微信內建地圖檢視位置介面</span>
<button class="btn btn_primary" id="openLocation">openLocation</button>
<span class="desc">獲取地理位置介面</span>
<button class="btn btn_primary" id="getLocation">getLocation</button>
<h3 id="menu-webview">介面操作介面</h3>
<span class="desc">隱藏右上角選單介面</span>
<button class="btn btn_primary" id="hideOptionMenu">hideOptionMenu</button>
<span class="desc">顯示右上角選單介面</span>
<button class="btn btn_primary" id="showOptionMenu">showOptionMenu</button>
<span class="desc">關閉當前網頁視窗介面</span>
<button class="btn btn_primary" id="closeWindow">closeWindow</button>
<span class="desc">批量隱藏功能按鈕介面</span>
<button class="btn btn_primary" id="hideMenuItems">hideMenuItems</button>
<span class="desc">批量顯示功能按鈕介面</span>
<button class="btn btn_primary" id="showMenuItems">showMenuItems</button>
<span class="desc">隱藏所有非基礎按鈕介面</span>
<button class="btn btn_primary" id="hideAllNonBaseMenuItem">hideAllNonBaseMenuItem</button>
<span class="desc">顯示所有功能按鈕介面</span>
<button class="btn btn_primary" id="showAllNonBaseMenuItem">showAllNonBaseMenuItem</button>
<h3 id="menu-scan">微信掃一掃</h3>
<span class="desc">調起微信掃一掃介面</span>
<button class="btn btn_primary" id="scanQRCode0">scanQRCode(微信處理結果)</button>
<button class="btn btn_primary" id="scanQRCode1">scanQRCode(直接返回結果)</button>
</div>
</div>
</body>
<script type="text/javascript" src="http://res2.wx.qq.com/open/js/jweixin-1.4.0.js"></script>
<script type="text/javascript"></script>
</html>
複製程式碼
Java 版本
開源推薦
TNW
微信公眾號開發腳手架:gitee.com/javen205/TN…IJPay
讓支付觸手可及:gitee.com/javen205/IJ…- SpringBoot 微服務高效開發
mica
工具集:gitee.com/596392912/m… Avue
一款基於 vue 可配置化的神奇框架:gitee.com/smallweigit…pig
宇宙最強微服務(架構師必備):gitee.com/log4j/pigSpringBlade
完整的線上解決方案(企業開發必備):gitee.com/smallc/Spri…