搜尋
首頁web前端js教程微信JS介面彙總及使用詳解_javascript技巧

基本說明

使用說明

1.引入JS檔
在需要呼叫JS介面的頁面引入如下JS文件,(支援https):http://res.wx.qq.com/open/js/jweixin-1.0.0.js

備註:支援使用 AMD/CMD 標準模組載入方法載入

2.注入設定config介面
所有需要使用JSSDK的頁面必須先註入配置訊息,否則將無法呼叫(同一個url僅需呼叫一次,對於變化url的SPA的web app可在每次url變化時進行呼叫)。

複製程式碼 程式碼如下:

wx.config({
debug: true, // 開啟調試模式,調用的所有api的回傳值會在客戶端alert出來,若要查看傳入的參數,可以在pc端打開,參數資訊會透過log打出,僅在pc端時才會列印。
 appId: '', // 必填,公眾號碼的唯一識別
 timestamp: , // 必填,產生簽章的時間戳記
 nonceStr: '', // 必填,產生簽章的隨機字串
 signature: '',// 必填,簽名,見附錄1
 jsApiList: [] // 必填,需要使用的JS介面列表,所有JS介面列表請見附錄2
});

3.驗證透過ready介面

複製程式碼 程式碼如下:

wx.ready(function(){

    // config資訊驗證後會執行ready方法,所有介面呼叫都必須在config介面取得結果之後,config是客戶端的非同步操作,所以如果需要在頁面載入時就呼叫相關接口,則須把相關介面放在ready函數中呼叫來確保正確執行。對於使用者觸發時才調用的接口,則可以直接調用,不需要放在ready函數中。
});

4.驗證失敗error介面

複製程式碼 程式碼如下:

wx.error(function(res){
// config資訊驗證失敗會執行error函數,如簽章過期導致驗證失敗,特定錯誤訊息可以開啟config的debug模式查看,也可以在傳回的res參數中查看,對於SPA可以在這裡更新簽章。
});

介面呼叫說明
所有介面透過wx對象(也可使用jWeixin對象)來調用,參數是一個對象,除了每個接口本身需要傳的參數之外,還有以下通用參數:

success:介面呼叫成功時執行的回呼函數。
fail:介面呼叫失敗時執行的回呼函數。
complete:介面呼叫完成時執行的回呼函數,無論成功或失敗都會執行。
cancel:使用者點選取消時的回呼函數,只有部分有使用者取消操作的api才會用到。
trigger: 監聽Menu中的按鈕點擊時觸發的方法,該方法僅支援Menu中的相關介面。

以上幾個函數都帶有一個參數,類型為對象,其中除了每個接口本身返回的資料之外,還有一個通用屬性errMsg,其值格式如下:

呼叫成功時:"xxx:ok" ,其中xxx為呼叫的介面名稱
使用者取消時:"xxx:cancel",其中xxx為呼叫的介面名稱
呼叫失敗時:其值為具體錯誤訊息

基礎介面
判斷目前客戶端版本是否支援指定JS介面

複製程式碼 程式碼如下:

wx.checkJsApi({
jsApiList: ['chooseImage'] // 需要偵測的JS介面列表,所有JS介面列表見附錄2,
success: function(res) {
// 以鍵值對的形式傳回,可用的api值true,不可用為false
// 如:{"checkResult":{"chooseImage":true},"errMsg":"checkJsApi:ok"}

});

分享介面

取得「分享到朋友圈」按鈕點選狀態及自訂分享內容介面

複製程式碼 程式碼如下:

wx.onMenuShareTimeline({
    title: '', // 分享標題
    link: '', // 分享連結
imgUrl: '', // 分享圖示
success: function () {
// 使用者確認分享後執行的回呼函數
},
cancel: function () {
// 使用者取消分享後執行的回呼函數
}
});

取得「分享給朋友」按鈕點選狀態及自訂分享內容介面

複製程式碼 程式碼如下:

wx.onMenuShareAppMessage({
    title: '', // 分享標題
    desc: '', // 分享描述
    link: '', // 分享連結
    imgUrl: '', // 分享圖示
    type: '', // 分享類型,music、video或link,不填預設為link
dataUrl: '', // 如果type是music或video,則要提供資料鏈接,預設為空
success: function () {
// 使用者確認分享後執行的回呼函數
},
cancel: function () {
// 使用者取消分享後執行的回呼函數
}
});

取得「分享到QQ」按鈕點選狀態及自訂分享內容介面

複製程式碼 程式碼如下:

wx.onMenuShareQQ({
    title: '', // 分享標題
    desc: '', // 分享描述
    link: '', // 分享連結
    imgUrl: '' // 分享圖示
success: function () {
// 使用者確認分享後執行的回呼函數
},
cancel: function () {
// 使用者取消分享後執行的回呼函數
}
});

取得「分享到騰訊微博」按鈕點選狀態及自訂分享內容介面

複製程式碼 程式碼如下:

wx.onMenuShareWeibo({
    title: '', // 分享標題
    desc: '', // 分享描述
    link: '', // 分享連結
    imgUrl: '' // 分享圖示
success: function () {
// 使用者確認分享後執行的回呼函數
},
cancel: function () {
// 使用者取消分享後執行的回呼函數
}
});

影像介面

拍照或從手機相簿中選圖介面

複製程式碼 程式碼如下:

wx.chooseImage({
    success: function (res) {
        var localIds = res.localIds; // 傳回選定照片的本機ID列表,localId可以作為img標籤的src屬性顯示圖片
    }
});

預覽圖片介面

複製程式碼 程式碼如下:

wx.previewImage({
    current: '', // 目前顯示的圖片連結
    urls: [] // 需要預覽的圖片連結清單
});

上傳圖片介面

複製程式碼 程式碼如下:

wx.uploadImage({
localId: '', // 需要上傳的圖片的本機ID,由chooseImage介面取得
isShowProgressTips: 1// 預設為1,顯示進度提示
    success: function (res) {
        var serverId = res.serverId; // 回傳圖片的伺服器端ID
    }
});

備註:可用微信下載多媒體檔案介面下載上傳的圖片,此處取得的 serverId 即 media_id,參考文件../12/58bfcfabbd501c7cd77c19bd9cfa8354.html

下載圖片介面

複製程式碼 程式碼如下:

wx.downloadImage({
serverId: '', // 需要下載的圖片的伺服器端ID,由uploadImage介面取得
isShowProgressTips: 1// 預設為1,顯示進度提示
    success: function (res) {
        var localId = res.localId; // 回傳圖片下載後的本地ID
    }
});

音訊介面

開始錄音介面

複製程式碼 程式碼如下:

wx.startRecord();

停止錄音介面

複製程式碼 程式碼如下:

wx.stopRecord({
    success: function (res) {
        var localId = res.localId;
    }
});

監聽錄音自動停止介面

複製程式碼 程式碼如下:

wx.onVoiceRecordEnd({
  // 錄音時間超過一分鐘沒有停止的時候會執行 complete 回檔
complete: function (res) {
var localId = res.localId;
}
});

播放語音介面

複製程式碼 程式碼如下:

wx.playVoice({
    localId: '' // 需要播放的音訊的本機ID,由stopRecord介面取得
});

暫停播放介面

複製程式碼 程式碼如下:

wx.pauseVoice({
    localId: '' // 需要暫停的音訊的本機ID,由stopRecord介面取得
});


停止播放介面

複製程式碼 程式碼如下:

wx.stopVoice({
    localId: '' // 需要停止的音訊的本機ID,由stopRecord介面取得
});

監聽語音播放完畢介面

複製程式碼 程式碼如下:

wx.onVoicePlayEnd({
    serverId: '', // 需要下載的音訊的伺服器端ID,由uploadVoice介面取得
    success: function (res) {
        var localId = res.localId; // 回傳音訊的本機ID
    }
});

上傳語音介面

複製程式碼 程式碼如下:

wx.uploadVoice({
localId: '', // 需要上傳的音訊的本機ID,由stopRecord介面取得
isShowProgressTips: 1// 預設為1,顯示進度提示
    success: function (res) {
        var serverId = res.serverId; // 傳回音訊的伺服器端ID
    }
});

備註:可用微信下載多媒體檔案介面下載上傳的語音,此處取得的 serverId 即 media_id,參考文件../12/58bfcfabbd501c7cd77c19bd9cfa8354.html

下載語音介面

複製程式碼 程式碼如下:

wx.downloadVoice({
serverId: '', // 需要下載的音訊的伺服器端ID,由uploadVoice介面取得
isShowProgressTips: 1// 預設為1,顯示進度提示
    success: function (res) {
        var localId = res.localId; // 回傳音訊的本機ID
    }
});
 

智慧型介面

辨識音訊並回傳辨識結果介面

複製程式碼 程式碼如下:

wx.translateVoice({
localId: '', // 需要辨識的音訊的本地Id,由錄音相關介面取得
isShowProgressTips: 1, // 預設為1,顯示進度提示
success: function (res) {
alert(res.translateResult); // 語音辨識的結果
}
});

設備資訊

取得網路狀態介面

複製程式碼 程式碼如下:

wx.getNetworkType({
    success: function (res) {
        var networkType = res.networkType; // 回網路類型2g,3g,4g,wifi
    }
});

地理位置

使用微信內建地圖檢視位置介面

複製程式碼 程式碼如下:

wx.openLocation({
    latitude: 0, // 緯度,浮點數,範圍為90 ~ -90
    longitude: 0, // 經度,浮點數,範圍為180 ~ -180。
    name: '', // 位置名稱
    address: '', // 地址詳情說明
    scale: 1, // 地圖縮放等級,整形值,範圍從1~28。預設為最大
infoUrl: '' // 在查看位置介面底部顯示的超連結,可點擊跳轉
});

取得地理位置介面

複製程式碼 程式碼如下:

wx.getLocation({
    timestamp: 0, // 位置簽章時間戳,僅在需要相容6.0.2版本之前時提供
    nonceStr: '', // 位置簽章隨機串,僅在需要相容6.0.2版本之前時提供
    addrSign: '', // 位置簽名,僅在需要相容6.0.2版本之前時提供,詳見附錄4
    success: function (res) {
        var longitude = res.longitude; // 緯度,浮點數,範圍為90 ~ -90
        var latitude = res.latitude; // 經度,浮點數,範圍為180 ~ -180。
        var speed = res.speed; // 速度,以公尺/每秒計
        var accuracy = res.accuracy; // 位置精確度
    }
});

介面操作

複製程式碼 程式碼如下:

隱藏右上角選單介面
wx.hideOptionMenu();
顯示右上角選單介面
wx.showOptionMenu();
關閉目前網頁視窗介面
wx.closeWindow();
批次隱藏功能按鈕介面
wx.hideMenuItems({
    menuList: [] // 要隱藏的選單項目,所有menu項見附錄3
});
批次顯示功能按鈕介面
wx.showMenuItems({
    menuList: [] // 要顯示的選單項目,所有menu項見附錄3
});
隱藏所有非基礎按鈕介面
wx.hideAllNonBaseMenuItem();
顯示所有功能按鈕介面
wx.showAllNonBaseMenuItem();
微信掃一掃
調起微信掃一掃介面
wx.scanQRCode({
desc: 'scanQRCode desc',
needResult: 0, // 預設為0,掃描結果由微信處理,1則直接回傳掃描結果,
scanType: ["qrCode","barCode"], // 可以指定掃二維碼還是一維碼,預設二者都有
success: function () {
var result = res.resultStr; // 當needResult 為 1 時,掃碼回傳的結果
}
});

收穫地址

編輯收貨地址介面

複製程式碼 程式碼如下:

wx.editAddress(
    timestamp: 0, // 位置簽章時間戳,僅在需要相容6.0.2版本之前時提供
    nonceStr: '', // 位置簽章隨機串,僅在需要相容6.0.2版本之前時提供
    addrSign: '', // 位置簽名,僅在需要相容6.0.2版本之前時提供,詳見附錄4
    success: function (res) {
        var userName = res.userName; // 收貨人姓名
        var telNumber = res.telNumber; // 收貨人電話
        var postalCode = res.postalCode; // 郵編
        var provinceName = res.provinceName; // 國標收貨地址第一級地址
        var cityName = res.cityName; // 國標收貨地址第二級地址
        var countryName = res.countryName; // 國標收貨地址第三級地址
        var address = res.address; // 詳細收貨地址資料
        var nationalCode = res.nationalCode; // 收貨位址國家碼
    }
});

取得最近的收貨地址介面

複製程式碼 程式碼如下:

wx.getLatestAddress({
    timestamp: 0, // 位置簽章時間戳,僅在需要相容6.0.2版本之前時提供
    nonceStr: '', // 位置簽章隨機串,僅在需要相容6.0.2版本之前時提供
    addrSign: '', // 位置簽名,僅在需要相容6.0.2版本之前時提供,詳見附錄4
    success: function (res) {
        var userName = res.userName; // 收貨人姓名
        var telNumber = res.telNumber; // 收貨人電話
        var postalCode = res.postalCode; // 郵編
        var provinceName = res.provinceName; // 國標收貨地址第一級地址
        var cityName = res.cityName; // 國標收貨地址第二級地址
        var countryName = res.countryName; // 國標收貨地址第三級地址
        var address = res.address; // 詳細收貨地址資料
        var nationalCode = res.nationalCode; // 收貨位址國家碼
    }
});

微信小店

跳轉微信商品頁介面

複製程式碼 程式碼如下:

wx.openProductSpecificView({
productId: '', // 商品id
viewType: '' // 0.預設值,普通商品詳情頁1.掃一掃商品詳情頁2.小店商品詳情頁
});

微信卡券

調起適用於門市的卡券清單並取得使用者選擇清單

複製程式碼 程式碼如下:

wx.chooseCard({
    shopId: '', // 門市Id
    cardType: '', // 卡券類型
    cardId: '', // 卡券Id
    timeStamp: 0, // 卡券簽章時間戳記
    nonceStr: '', // 卡券簽章隨機串
    cardSign: '', // 卡券簽名,詳見附錄6
    success: function (res) {
        var cardList= res.cardList; // 使用者選取的卡券清單資訊
    }
});

大量新增卡券介面

複製程式碼 程式碼如下:

wx.addCard({
cardList: [{
cardId: '',
cardExt: ''
}], // 需要新增的卡券清單
    success: function (res) {
        var cardList = res.cardList; // 新增的卡券清單資訊
    }
});

查看微信卡包中的卡券介面

複製程式碼 程式碼如下:

wx.openCard({
cardList: [{
cardId: '',
code: ''
}]// 需要開啟的卡券清單
});

微信支付

發起一個微信支付請求

複製程式碼 程式碼如下:

wx.chooseWXPay({
timestamp: 0, // 支付簽章時間戳記
noncestr: '', // 支付簽章隨機字串
package: '', // 訂單詳情擴充字串,詳見附錄5
paySign: '', // 支付簽名,詳見附錄5
});
陳述
本文內容由網友自願投稿,版權歸原作者所有。本站不承擔相應的法律責任。如發現涉嫌抄襲或侵權的內容,請聯絡admin@php.cn
JavaScript是用C編寫的嗎?檢查證據JavaScript是用C編寫的嗎?檢查證據Apr 25, 2025 am 12:15 AM

是的,JavaScript的引擎核心是用C語言編寫的。 1)C語言提供了高效性能和底層控制,適合JavaScript引擎的開發。 2)以V8引擎為例,其核心用C 編寫,結合了C的效率和麵向對象特性。 3)JavaScript引擎的工作原理包括解析、編譯和執行,C語言在這些過程中發揮關鍵作用。

JavaScript的角色:使網絡交互和動態JavaScript的角色:使網絡交互和動態Apr 24, 2025 am 12:12 AM

JavaScript是現代網站的核心,因為它增強了網頁的交互性和動態性。 1)它允許在不刷新頁面的情況下改變內容,2)通過DOMAPI操作網頁,3)支持複雜的交互效果如動畫和拖放,4)優化性能和最佳實踐提高用戶體驗。

C和JavaScript:連接解釋C和JavaScript:連接解釋Apr 23, 2025 am 12:07 AM

C 和JavaScript通過WebAssembly實現互操作性。 1)C 代碼編譯成WebAssembly模塊,引入到JavaScript環境中,增強計算能力。 2)在遊戲開發中,C 處理物理引擎和圖形渲染,JavaScript負責遊戲邏輯和用戶界面。

從網站到應用程序:JavaScript的不同應用從網站到應用程序:JavaScript的不同應用Apr 22, 2025 am 12:02 AM

JavaScript在網站、移動應用、桌面應用和服務器端編程中均有廣泛應用。 1)在網站開發中,JavaScript與HTML、CSS一起操作DOM,實現動態效果,並支持如jQuery、React等框架。 2)通過ReactNative和Ionic,JavaScript用於開發跨平台移動應用。 3)Electron框架使JavaScript能構建桌面應用。 4)Node.js讓JavaScript在服務器端運行,支持高並發請求。

Python vs. JavaScript:比較用例和應用程序Python vs. JavaScript:比較用例和應用程序Apr 21, 2025 am 12:01 AM

Python更適合數據科學和自動化,JavaScript更適合前端和全棧開發。 1.Python在數據科學和機器學習中表現出色,使用NumPy、Pandas等庫進行數據處理和建模。 2.Python在自動化和腳本編寫方面簡潔高效。 3.JavaScript在前端開發中不可或缺,用於構建動態網頁和單頁面應用。 4.JavaScript通過Node.js在後端開發中發揮作用,支持全棧開發。

C/C在JavaScript口譯員和編譯器中的作用C/C在JavaScript口譯員和編譯器中的作用Apr 20, 2025 am 12:01 AM

C和C 在JavaScript引擎中扮演了至关重要的角色,主要用于实现解释器和JIT编译器。1)C 用于解析JavaScript源码并生成抽象语法树。2)C 负责生成和执行字节码。3)C 实现JIT编译器,在运行时优化和编译热点代码,显著提高JavaScript的执行效率。

JavaScript在行動中:現實世界中的示例和項目JavaScript在行動中:現實世界中的示例和項目Apr 19, 2025 am 12:13 AM

JavaScript在現實世界中的應用包括前端和後端開發。 1)通過構建TODO列表應用展示前端應用,涉及DOM操作和事件處理。 2)通過Node.js和Express構建RESTfulAPI展示後端應用。

JavaScript和Web:核心功能和用例JavaScript和Web:核心功能和用例Apr 18, 2025 am 12:19 AM

JavaScript在Web開發中的主要用途包括客戶端交互、表單驗證和異步通信。 1)通過DOM操作實現動態內容更新和用戶交互;2)在用戶提交數據前進行客戶端驗證,提高用戶體驗;3)通過AJAX技術實現與服務器的無刷新通信。

See all articles

熱AI工具

Undresser.AI Undress

Undresser.AI Undress

人工智慧驅動的應用程序,用於創建逼真的裸體照片

AI Clothes Remover

AI Clothes Remover

用於從照片中去除衣服的線上人工智慧工具。

Undress AI Tool

Undress AI Tool

免費脫衣圖片

Clothoff.io

Clothoff.io

AI脫衣器

Video Face Swap

Video Face Swap

使用我們完全免費的人工智慧換臉工具,輕鬆在任何影片中換臉!

熱工具

WebStorm Mac版

WebStorm Mac版

好用的JavaScript開發工具

DVWA

DVWA

Damn Vulnerable Web App (DVWA) 是一個PHP/MySQL的Web應用程序,非常容易受到攻擊。它的主要目標是成為安全專業人員在合法環境中測試自己的技能和工具的輔助工具,幫助Web開發人員更好地理解保護網路應用程式的過程,並幫助教師/學生在課堂環境中教授/學習Web應用程式安全性。 DVWA的目標是透過簡單直接的介面練習一些最常見的Web漏洞,難度各不相同。請注意,該軟體中

SublimeText3 英文版

SublimeText3 英文版

推薦:為Win版本,支援程式碼提示!

EditPlus 中文破解版

EditPlus 中文破解版

體積小,語法高亮,不支援程式碼提示功能

記事本++7.3.1

記事本++7.3.1

好用且免費的程式碼編輯器