微信公眾平臺開發(fā)技術(shù)第2章微信公眾平臺開發(fā)準(zhǔn)備課件

1、第2章 微信公眾平臺開發(fā)準(zhǔn)備能力CAPACITY要求能夠搭建好開發(fā)環(huán)境。掌握接口在線調(diào)試工具調(diào)試接口的方法。掌握基礎(chǔ)接口調(diào)用憑證與獲取微信服務(wù)器IP地址的方法。掌握微信Web開發(fā)調(diào)試工具的使用方法?；A(chǔ)接口開發(fā)環(huán)境搭建微信Web開發(fā)調(diào)試工具2.1 開發(fā)環(huán)境搭建01OPTION02OPTION03OPTION接入指南接口測試號申請接口在線調(diào)試2.1 開發(fā)環(huán)境搭建 2.1.1接入指南 獲取服務(wù)器資源 服務(wù)器類型虛擬空間百度BAE新浪SAE云主機.指自己托管于IDC機房的服務(wù)器或者第三方服務(wù)商提供的服務(wù)器，一般一個人使用一整臺服務(wù)器。第三方服務(wù)商將一臺主機分成多個虛擬主機，供多人使用可以申請免費使用

2、，但是有一定條件限制可以申請免費使用，但是有一定條件限制2.1 開發(fā)環(huán)境搭建2.1.1接入指南 獲取服務(wù)器資源（1）申請賬號 /（2）創(chuàng)建應(yīng)用以新浪SAE為例介紹如何申請免費的SAE應(yīng)用空間以及上傳程序文件2.1 開發(fā)環(huán)境搭建（3）創(chuàng)建版本（4）上傳代碼2.1.1接入指南 獲取服務(wù)器資源2.1 開發(fā)環(huán)境搭建2.1.1接入指南 填寫服務(wù)器配置（1）服務(wù)器地址URL 開發(fā)者用來接收微信消息和事件的接口URL，該URL必須正確響應(yīng)微信發(fā)送的Token驗證。（2）Token Token是由開發(fā)者任意填寫的簽名，該Token會與服務(wù)器接口URL中包含的Token進(jìn)行比對，從而驗證安全性。 （3）Enco

3、dingAESKey 由開發(fā)者手動填寫或隨機生成的，主要用于消息體加密解密的密鑰。2.1 開發(fā)環(huán)境搭建2.1.1接入指南 填寫服務(wù)器配置服務(wù)器配置填寫2.1 開發(fā)環(huán)境搭建2.1.1接入指南 驗證服務(wù)器地址的有效性 開發(fā)者提交配置信息后，微信服務(wù)器將發(fā)送GET請求到填寫的服務(wù)器地址URL上從而驗證消息的確來自微信服務(wù)器，GET請求攜帶參數(shù)如下表所示：參數(shù)描述signature微信加密簽名，signature結(jié)合了開發(fā)者請求中的timestamp參數(shù)，nonce參數(shù)。timestamp時間戳nonce隨機數(shù)echostr隨機字符串GET請求參數(shù)列表2.1 開發(fā)環(huán)境搭建2.1.1接入指南 驗證服務(wù)器

4、地址的有效性 獲得 GET請求的幾個參數(shù)后，開發(fā)者就可以通過signature對請求進(jìn)行校驗。開發(fā)者開發(fā)的校驗程序要能夠處理GET請求，并對請求者進(jìn)行身份驗證，確保請求來自微信服務(wù)器。校驗流程為：首先將token、timestamp、nonce三個參數(shù)進(jìn)行字典序排序；隨后將三個參數(shù)字符串拼接成一個字符串并進(jìn)行sha1加密；開發(fā)者獲得加密后的字符串可與signature對比，標(biāo)識該請求來源于微信，原樣返回echostr參數(shù)內(nèi)容，則接入生效。2.1 開發(fā)環(huán)境搭建2.1.1接入指南 驗證服務(wù)器地址的有效性 public void ProcessRequest (HttpContext context

5、) string s = ; Listl = newList(); l.Add (你填寫的token); l.Add (context.Request.QueryStringtimestamp); l.Add (context.Request.QueryStringnonce); l.Sort (); foreach (string_s in l) s +=_s; s= FormsAuthentication.HashPasswordForStoringInConfigFiles (s, SHA1).ToLower(); if (s = context.Request.QueryStrings

6、ignature) context.Response.Write(context.Request.QueryStringechostr); public bool IsReusable get return false; 2.1 開發(fā)環(huán)境搭建01OPTION02OPTION03OPTION接入指南接口測試號申請接口在線調(diào)試2.1 開發(fā)環(huán)境搭建2.1.2 接口測試號申請 由于用戶體驗和安全性方面的考慮，微信公眾號的注冊有一定的門檻，某些高級接口權(quán)限需要微信認(rèn)證后才可以獲取，微信認(rèn)證必須是企業(yè)或組織才能申請認(rèn)證，而個人是不可以的。所以，為了幫助開發(fā)者快速了解和上手微信公眾號開發(fā)，熟悉各個接口的調(diào)用

7、，微信團(tuán)隊推出了微信公眾賬號測試號 。測試號申請網(wǎng)址：/debug/cgi-bin/sandbox?t=sandbox/login 2.1 開發(fā)環(huán)境搭建2.1.2 接口測試號申請 在出現(xiàn)的頁面中單擊登錄即會跳轉(zhuǎn)至如左側(cè)所示的一個微信二維碼頁面，使用手機微信掃一掃網(wǎng)頁中二維碼，手機則會出現(xiàn)如右圖所示的界面登陸公眾平臺測試賬號系統(tǒng)。 2.1 開發(fā)環(huán)境搭建2.1.2 接口測試號申請測試號接口權(quán)限表2.1 開發(fā)環(huán)境搭建01OPTION02OPTION03OPTION接入指南接口測試號申請接口在線調(diào)試2.1 開發(fā)環(huán)境搭建2.1.3 接口在線測試微信公眾平臺接口在線調(diào)試工具微信公眾平臺接口在線調(diào)試網(wǎng)站：/

8、debug基礎(chǔ)接口開發(fā)環(huán)境搭建微信Web開發(fā)調(diào)試工具 2.2 基礎(chǔ)接口1、access_token的使用2、access_token的生成獲取接口調(diào)用憑證獲取微信服務(wù)器IP地址 如果公眾號基于安全等考慮，需要獲知微信服務(wù)器的IP地址列表，以便進(jìn)行相關(guān)限制，可以通過以下接口獲得微信服務(wù)器IP地址列表或者IP網(wǎng)段信息。access_token是公眾號的全局唯一接口調(diào)用憑據(jù)，公眾號調(diào)用各接口時都需使用access_token。2.2 基礎(chǔ)接口 2.2.1獲取接口調(diào)用憑證access_token的使用 為了對appsecrect進(jìn)行保密，開發(fā)者或運營商需要一個access_token獲取和刷新的中控服

9、務(wù)器。而其他業(yè)務(wù)邏輯服務(wù)器所使用的access_token均來自于該中控服務(wù)器，不應(yīng)該各自去刷新，否則會造成access_token覆蓋而影響業(yè)務(wù)；目前access_token的有效期通過返回的expire_in來傳達(dá)，目前是7200秒之內(nèi)的值。中控服務(wù)器需要根據(jù)這個有效時間提前去刷新access_token。在刷新過程中，中控服務(wù)器對外輸出的依然是舊的access_token。access_token的有效時間可能會在未來有調(diào)整，所以中控服務(wù)器不僅需要內(nèi)部定時主動刷新，還需要提供被動刷新access_token的接口。2.2 基礎(chǔ)接口 2.2.1獲取接口調(diào)用憑證access_token的生成

10、 公眾號可以使用AppID和AppSecret調(diào)用接口來獲取access_token。AppID和AppSecret可在微信公眾平臺官網(wǎng)-開發(fā)頁中獲得。http請求方式:GET/cgi-bin/token?grant_type=client_credential&appid=APPID&secret=APPSECRET2.2 基礎(chǔ)接口 2.2.1獲取接口調(diào)用憑證access_token的生成 獲取access_token參數(shù)說明表參數(shù)名稱是否必須參數(shù)描述grant_type是獲取access_token填寫client_credentialappid是第三方用戶唯一憑證secret是第三方用戶

11、唯一憑證密鑰，即appsecret2.2 基礎(chǔ)接口 2.2.1獲取接口調(diào)用憑證access_token的生成 正常情況下，返回數(shù)據(jù)包： access_token:ACCESS_TOKEN,expires_in:7200錯誤時會返回錯誤碼等信息，數(shù)據(jù)包示例： errcode:40013,errmsg:invalidappid參數(shù)名稱參數(shù)描述expires_in憑證有效時間，單位：秒2.2 基礎(chǔ)接口 2.2.2 獲取微信服務(wù)器IP地址 http請求方式:GET/cgi-bin/getcallbackip?access_token=ACCESS_TOKEN正常情況下，返回數(shù)據(jù)包： ip_list:

12、, , /25 錯誤時返回錯誤碼信息，示例數(shù)據(jù)包： errcode:40013,errmsg:invalidappid基礎(chǔ)接口開發(fā)環(huán)境搭建微信Web開發(fā)調(diào)試工具2.3 微信Web開發(fā)調(diào)試工具01OPTION02OPTION03OPTION04OPTION調(diào)試微信網(wǎng)頁授權(quán)調(diào)試JS-SDK相關(guān)功能移動調(diào)試與Chrome集成使用2.3 微信web開發(fā)調(diào)試工具 為了幫助開發(fā)者更方便、更安全地開發(fā)和調(diào)試基于微信的網(wǎng)頁，微信公眾號團(tuán)隊推出了 Web開發(fā)者工具。它是一個桌面應(yīng)用，通過模擬微信客戶端的表現(xiàn)，使得開發(fā)者可以使用這個工具方便地在PC或者M(jìn)ac上進(jìn)行開發(fā)和調(diào)試工作。2.3 微信web開發(fā)調(diào)試工具 頂

13、部菜單欄是刷新、后退、選中地址欄等動作的統(tǒng)一入口，以及微信客戶端版本的模擬設(shè)置頁。 左側(cè)是微信的WebView模擬器，可以直接操作網(wǎng)頁，模擬用戶真實行為。 右側(cè)上方是地址欄，用于輸入待調(diào)試的頁面鏈接，以及清除緩存按鈕。 右側(cè)下方是相關(guān)的請求和返回結(jié)果，以及調(diào)試界面和登錄按鈕。2.3 微信web開發(fā)調(diào)試工具 2.3.1 調(diào)試微信網(wǎng)頁授權(quán) 開發(fā)者可以直接在PC或者M(jìn)ac上進(jìn)行網(wǎng)頁調(diào)試，具體操作步驟為：1、使用手機微信掃碼登錄2、綁定開發(fā)者微信號3、調(diào)試微信網(wǎng)頁授權(quán)2.3 微信web開發(fā)調(diào)試工具01OPTION02OPTION03OPTIONJS-SDK的使用基礎(chǔ)接口調(diào)試JS-SDK調(diào)試調(diào)試JS-S

14、DK相關(guān)功能2.3 微信web開發(fā)調(diào)試工具 2.3.2 調(diào)試JS-SDK相關(guān)功能JS-SDK的使用 微信JS-SDK是微信公眾平臺面向網(wǎng)頁開發(fā)者提供的基于微信內(nèi)的網(wǎng)頁開發(fā)工具包。JS-SDK的使用如下：（1）綁定域名 登錄微信公眾平臺進(jìn)入“公眾號設(shè)置”的“功能設(shè)置”里填寫“JS接口安全域名”就完成了域名的綁定。登錄后可在“開發(fā)者中心”查看對應(yīng)的接口權(quán)限。（2）引入JS文件 在需要調(diào)用JS接口的頁面引入如下JS文件/open/js/jweixin-1.0.0.js2.3 微信web開發(fā)調(diào)試工具 2.3.2 調(diào)試JS-SDK相關(guān)功能JS-SDK的使用（3）通過config接口注入權(quán)限驗證配置 所有

15、需要使用JS-SDK的頁面首先需要注入配置信息，否則將無法調(diào)用。而同一個URL僅需調(diào)用一次，對于變化URL的SPA的Web App可以在每次URL變化的時進(jìn)行調(diào)用。wx.config( debug: true, / 開啟調(diào)試模式,調(diào)用的所有api的返回值會在客戶端alert出來，若要查看傳入的參數(shù)，可以在pc端打開，參數(shù)信息會通過log打出，僅在pc端時才會打印。 appId: , / 必填，公眾號的唯一標(biāo)識 timestamp: , / 必填，生成簽名的時間戳 nonceStr: , / 必填，生成簽名的隨機串 signature: ,/ 必填，簽名，見附錄1 jsApiList: / 必填

16、，需要使用的JS接口列表，所有JS接口列表見附錄2);2.3 微信web開發(fā)調(diào)試工具 2.3.2 調(diào)試JS-SDK相關(guān)功能JS-SDK的使用（4）通過ready接口處理成功驗證 wx.ready(function() / config信息驗證后會執(zhí)行ready方法，所有接口調(diào)用都必須在config接口獲得結(jié)果之后，config是一個客戶端的異步操作，所以如果需要在頁面加載時就調(diào)用相關(guān)接口，則須把相關(guān)接口放在ready函數(shù)中調(diào)用來確保正確執(zhí)行。對于用戶觸發(fā)時才調(diào)用的接口，則可以直接調(diào)用，不需要放在ready函數(shù)中。 );2.3 微信web開發(fā)調(diào)試工具 2.3.2 調(diào)試JS-SDK相關(guān)功能JS-S

17、DK的使用（5）通過error接口處理失敗驗證wx.error(function(res) /config信息驗證失敗會執(zhí)行error函數(shù)，如簽名過期導(dǎo)致驗證失敗，具體錯誤信息可以打開config的debug模式查看，也可以在返回的res參數(shù)中查看，對于SPA可以在這里更新簽名。 );2.3 微信web開發(fā)調(diào)試工具 2.3.2 調(diào)試JS-SDK相關(guān)功能JS-SDK的使用以上所有接口通過wx對象(也可使用jWeixin對象)來調(diào)用，參數(shù)是一個對象，除了每個接口本身需要傳的參數(shù)之外，還有以下通用參數(shù)：1、success：接口調(diào)用成功時執(zhí)行的回調(diào)函數(shù)。2、fail：接口調(diào)用失敗時執(zhí)行的回調(diào)函數(shù)。3、

18、complete：接口調(diào)用完成時執(zhí)行的回調(diào)函數(shù)，無論成功或失敗都會執(zhí)行。4、cancel：用戶單擊取消時的回調(diào)函數(shù)，僅部分有用戶取消操作的api才會用到。5、trigger: 監(jiān)聽Menu中的按鈕單擊時觸發(fā)的方法，該方法僅支持Menu中的相關(guān)接口。2.3 微信web開發(fā)調(diào)試工具 2.3.2 調(diào)試JS-SDK相關(guān)功能JS-SDK的使用以上所有接口通過wx對象(也可使用jWeixin對象)來調(diào)用，參數(shù)是一個對象，除了每個接口本身需要傳的參數(shù)之外，還有以下通用參數(shù)：1、success：接口調(diào)用成功時執(zhí)行的回調(diào)函數(shù)。2、fail：接口調(diào)用失敗時執(zhí)行的回調(diào)函數(shù)。3、complete：接口調(diào)用完成時執(zhí)行的

19、回調(diào)函數(shù)，無論成功或失敗都會執(zhí)行。4、cancel：用戶單擊取消時的回調(diào)函數(shù)，僅部分有用戶取消操作的api才會用到。5、trigger: 監(jiān)聽Menu中的按鈕單擊時觸發(fā)的方法，該方法僅支持Menu中的相關(guān)接口。2.3 微信web開發(fā)調(diào)試工具 2.3.2 調(diào)試JS-SDK相關(guān)功能基礎(chǔ)接口調(diào)試判斷當(dāng)前客戶端版本是否支持指定JS接口的方法如下：wx.checkJsApi jsApiList: chooseImage, / 需要檢測的JS接口列表，所有JS接口列表見附錄2, success: function(res) / 以鍵值對的形式返回，可用的api值true，不可用為false / 如：che

20、ckResult:chooseImage:true,errMsg:checkJsApi:ok );2.3 微信web開發(fā)調(diào)試工具 2.3.2 調(diào)試JS-SDK相關(guān)功能基礎(chǔ)接口調(diào)試（1）分享接口獲取“分享到朋友圈”按鈕單擊狀態(tài)及自定義分享內(nèi)容接口：wx.onMenuShareTimeline( title: , / 分享標(biāo)題 link: , / 分享鏈接 imgUrl: , / 分享圖標(biāo) success: function () /用戶確認(rèn)分享后執(zhí)行的回調(diào)函數(shù) , cancel:function () / 用戶取消分享后執(zhí)行的回調(diào)函數(shù) );2.3 微信web開發(fā)調(diào)試工具 2.3.2 調(diào)試JS-S

21、DK相關(guān)功能基礎(chǔ)接口調(diào)試（1）分享接口獲取“分享給朋友”按鈕單擊狀態(tài)及自定義分享內(nèi)容接口：wx.onMenuShareAppMessage( title: , / 分享標(biāo)題 desc: , / 分享描述 link: , / 分享鏈接 imgUrl: , / 分享圖標(biāo) type: , / 分享類型,music、video或link，不填默認(rèn)為link dataUrl: , / 如果type是music或video，則要提供數(shù)據(jù)鏈接，默認(rèn)為空 success: function () /用戶確認(rèn)分享后執(zhí)行的回調(diào)函數(shù), cancel:function () / 用戶取消分享后執(zhí)行的回調(diào)函數(shù));2.3

22、 微信web開發(fā)調(diào)試工具 2.3.2 調(diào)試JS-SDK相關(guān)功能基礎(chǔ)接口調(diào)試（1）分享接口獲取“分享到QQ”按鈕單擊狀態(tài)及自定義分享內(nèi)容接口：wx.onMenuShareQQ( title: , / 分享標(biāo)題 desc: , / 分享描述 link: , / 分享鏈接 imgUrl: , / 分享圖標(biāo) success: function () /用戶確認(rèn)分享后執(zhí)行的回調(diào)函數(shù) , cancel:function () / 用戶取消分享后執(zhí)行的回調(diào)函數(shù));2.3 微信web開發(fā)調(diào)試工具 2.3.2 調(diào)試JS-SDK相關(guān)功能基礎(chǔ)接口調(diào)試（1）分享接口獲取“分享到騰訊微博”按鈕單擊狀態(tài)及自定義分享內(nèi)容接

23、口：wx.onMenuShareWeibo( title: , / 分享標(biāo)題 desc: , / 分享描述 link: , / 分享鏈接 imgUrl: , / 分享圖標(biāo) success: function () /用戶確認(rèn)分享后執(zhí)行的回調(diào)函數(shù) , cancel:function () / 用戶取消分享后執(zhí)行的回調(diào)函數(shù) );2.3 微信web開發(fā)調(diào)試工具 2.3.2 調(diào)試JS-SDK相關(guān)功能基礎(chǔ)接口調(diào)試（1）分享接口獲取“分享到QQ空間”按鈕單擊狀態(tài)及自定義分享內(nèi)容接口：wx.onMenuShareQZone( title: , / 分享標(biāo)題 desc: , / 分享描述 link: , /

24、分享鏈接 imgUrl: , / 分享圖標(biāo) success: function () /用戶確認(rèn)分享后執(zhí)行的回調(diào)函數(shù), cancel:function () / 用戶取消分享后執(zhí)行的回調(diào)函數(shù) );2.3 微信web開發(fā)調(diào)試工具 2.3.2 調(diào)試JS-SDK相關(guān)功能基礎(chǔ)接口調(diào)試（2）圖像接口拍照或從手機相冊中選圖接口：wx.chooseImage( count: 1, / 默認(rèn)9 sizeType: original, compressed, / 可以指定是原圖還是壓縮圖，默認(rèn)二者都有 sourceType: album, camera, / 可以指定來源是相冊還是相機，默認(rèn)二者都有 succe

25、ss: function (res) var localIds = res.localIds; / 返回選定照片的本地ID列表，localId可以作為img標(biāo)簽src屬性顯示圖片 );2.3 微信web開發(fā)調(diào)試工具 2.3.2 調(diào)試JS-SDK相關(guān)功能基礎(chǔ)接口調(diào)試（2）圖像接口預(yù)覽圖片接口：wx.previewImage( current: , / 當(dāng)前顯示圖片的http鏈接 urls: / 需要預(yù)覽的圖片http鏈接列表);2.3 微信web開發(fā)調(diào)試工具 2.3.2 調(diào)試JS-SDK相關(guān)功能基礎(chǔ)接口調(diào)試（2）圖像接口上傳圖片接口wx.uploadImage( localId: , / 需要上

26、傳的圖片的本地ID，由chooseImage接口獲得 isShowProgressTips: 1, / 默認(rèn)為1，顯示進(jìn)度提示 success: function (res) var serverId = res.serverId; / 返回圖片的服務(wù)器端ID );2.3 微信web開發(fā)調(diào)試工具 2.3.2 調(diào)試JS-SDK相關(guān)功能基礎(chǔ)接口調(diào)試（2）圖像接口下載圖片接口wx.downloadImage( serverId: , / 需要下載的圖片的服務(wù)器端口ID，由uploadImage接口獲得 isShowProgressTips: 1, / 默認(rèn)為1，顯示進(jìn)度提示 success: fun

27、ction (res) var localId = res.localId; / 返回圖片下載后的本地ID );2.3 微信web開發(fā)調(diào)試工具 2.3.2 調(diào)試JS-SDK相關(guān)功能基礎(chǔ)接口調(diào)試（3）音頻接口開始錄音接口： wx.startRecord(); 停止錄音接口：wx.stopRecord( success:function (res) var localId = res.localId; ); 2.3 微信web開發(fā)調(diào)試工具 2.3.2 調(diào)試JS-SDK相關(guān)功能基礎(chǔ)接口調(diào)試（3）音頻接口監(jiān)聽錄音自動停止接口： wx.onVoiceRecordEnd( / 錄音時間超過一分鐘沒有停止的

28、時候會執(zhí)行 complete 回調(diào) complete: function (res) var localId = res.localId; );2.3 微信web開發(fā)調(diào)試工具 2.3.2 調(diào)試JS-SDK相關(guān)功能基礎(chǔ)接口調(diào)試（3）音頻接口播放語音接口：wx.playVoice( localId: / 需要播放的音頻的本地ID，由stopRecord接口獲得); 監(jiān)聽語言播放完畢接口：wx.onVoicePlayEnd( success: function (res) var localId = res.localId; / 返回音頻的本地ID ); 2.3 微信web開發(fā)調(diào)試工具 2.3.2

29、調(diào)試JS-SDK相關(guān)功能基礎(chǔ)接口調(diào)試（3）音頻接口上傳語音接口：wx.uploadVoice( localId: , / 需要上傳的音頻的本地ID，由stopRecord接口獲得 isShowProgressTips: 1, / 默認(rèn)為1，顯示進(jìn)度提示 success: function (res) var serverId = res.serverId; / 返回音頻的服務(wù)器端ID ); 2.3 微信web開發(fā)調(diào)試工具 2.3.2 調(diào)試JS-SDK相關(guān)功能基礎(chǔ)接口調(diào)試（3）音頻接口下載語音接口：wx.downloadVoice( serverId: , / 需要下載的音頻的服務(wù)器端ID，由u

30、ploadVoice接口獲得 isShowProgressTips: 1, / 默認(rèn)為1，顯示進(jìn)度提示 success: function (res) var localId = res.localId; / 返回音頻的本地ID );2.3 微信web開發(fā)調(diào)試工具 2.3.2 調(diào)試JS-SDK相關(guān)功能基礎(chǔ)接口調(diào)試（4）智能接口（識別音頻并返回結(jié)果）wx.translateVoice( localId: , / 需要識別的音頻的本地Id，由錄音相關(guān)接口獲得 isShowProgressTips: 1, / 默認(rèn)為1，顯示進(jìn)度提示 success: function (res) alert(res

31、.translateResult); / 語音識別的結(jié)果 );2.3 微信web開發(fā)調(diào)試工具 2.3.2 調(diào)試JS-SDK相關(guān)功能基礎(chǔ)接口調(diào)試（5）設(shè)備信息（獲取網(wǎng)絡(luò)狀態(tài)）wx.getNetworkType( success: function (res) var networkType = workType; / 返回網(wǎng)絡(luò)類型2g，3g，4g，wifi );2.3 微信web開發(fā)調(diào)試工具 2.3.2 調(diào)試JS-SDK相關(guān)功能基礎(chǔ)接口調(diào)試（6）地理位置使用微信內(nèi)置地圖查看位置接口：wx.openLocation( latitude: 0, / 緯度，浮點數(shù)，范圍為90 -90 longitud

32、e: 0, / 經(jīng)度，浮點數(shù)，范圍為180 -180 name: , / 位置名 address: , / 地址詳情說明 scale: 1, / 地圖縮放級別,整形值,范圍從128。默認(rèn)為最大 infoUrl: / 在查看位置界面底部顯示的超鏈接,可單擊跳轉(zhuǎn));2.3 微信web開發(fā)調(diào)試工具 2.3.2 調(diào)試JS-SDK相關(guān)功能基礎(chǔ)接口調(diào)試（6）地理位置獲取地理位置接口：wx.getLocation( type: wgs84, / 默認(rèn)為wgs84的gps坐標(biāo)，如果要返回直接給openLocation用的火星坐標(biāo)，可傳入gcj02 success: function (res) var lat

33、itude = res.latitude; / 緯度，浮點數(shù)，范圍為90 -90 var longitude = res.longitude; / 經(jīng)度，浮點數(shù)，范圍為180 -180 var speed = res.speed; / 速度，以米/每秒計 var accuracy = res.accuracy; / 位置精度 );2.3 微信web開發(fā)調(diào)試工具 2.3.2 調(diào)試JS-SDK相關(guān)功能基礎(chǔ)接口調(diào)試（7）搖一搖周邊開啟查找周邊ibeacon設(shè)備接口：wx.startSearchBeacons ( ticket:, /搖周邊的業(yè)務(wù)ticket, 系統(tǒng)自動添加在搖出來的頁面鏈接后面 co

34、mplete:function(argv) /開啟查找完成后的回調(diào)函數(shù) );2.3 微信web開發(fā)調(diào)試工具 2.3.2 調(diào)試JS-SDK相關(guān)功能基礎(chǔ)接口調(diào)試（7）搖一搖周邊關(guān)閉查找周邊ibeacon設(shè)備接口：wx.stopSearchBeacons ( complete:function(argv) /關(guān)閉查找完成后的回調(diào)函數(shù) );2.3 微信web開發(fā)調(diào)試工具 2.3.2 調(diào)試JS-SDK相關(guān)功能基礎(chǔ)接口調(diào)試（7）搖一搖周邊監(jiān)聽周邊ibeacon設(shè)備接口：wx.onSearchBeacons ( complete:function(argv) /回調(diào)函數(shù)，可以數(shù)組形式取得該商家注冊的在周邊的

35、相關(guān)設(shè)備列表 );2.3 微信web開發(fā)調(diào)試工具 2.3.2 調(diào)試JS-SDK相關(guān)功能基礎(chǔ)接口調(diào)試（8）界面操作關(guān)閉當(dāng)前網(wǎng)頁窗口接口： wx.closeWindow()；批量隱藏功能按鈕接口：wx.hideMenuItems( menuList: / 要隱藏的菜單項，只能隱藏“傳播類”和“保護(hù)類”按鈕)；2.3 微信web開發(fā)調(diào)試工具 2.3.2 調(diào)試JS-SDK相關(guān)功能基礎(chǔ)接口調(diào)試（8）界面操作批量顯示功能按鈕接口：wx.showMenuItems( menuList: / 要顯示的菜單項)；隱藏所有非基礎(chǔ)按鈕接口：wx.hideAllNonBaseMenuItem(); 顯示所有功能按鈕接

36、口：wx.showAllNonBaseMenuItem(); 2.3 微信web開發(fā)調(diào)試工具 2.3.2 調(diào)試JS-SDK相關(guān)功能基礎(chǔ)接口調(diào)試（9）微信掃一掃wx.scanQRCode( needResult: 0, / 默認(rèn)為0，掃描結(jié)果由微信處理，1則直接返回掃描結(jié)果， scanType: qrCode,barCode, / 可以指定掃二維碼還是一維碼，默認(rèn)二者都有 success: function (res) var result = res.resultStr; / 當(dāng)needResult 為 1 時，掃碼返回的結(jié)果 );2.3 微信web開發(fā)調(diào)試工具 2.3.2 調(diào)試JS-SDK相

37、關(guān)功能基礎(chǔ)接口調(diào)試（10）微信小店跳轉(zhuǎn)微信商品頁接口：wx.openProductSpecificView( productId: , / 商品id viewType: / 0.默認(rèn)值，普通商品詳情頁1.掃一掃商品詳情頁2.小店商品詳情頁);2.3 微信web開發(fā)調(diào)試工具 2.3.2 調(diào)試JS-SDK相關(guān)功能基礎(chǔ)接口調(diào)試（11）微信卡券 接口調(diào)用請求說明： http請求方式: GET/cgi-bin/ticket/getticket?access_token=ACCESS_TOKEN&type=wx_card 返回數(shù)據(jù)示例： errcode:0, errmsg:ok, ticket:bxLdi

38、kRXVbTPdHSM05e5u5sUoXNKdvsdshFKA, expires_in:7200參數(shù)名參數(shù)描述errmsg錯誤信息ticketapi_ticket,卡券接口中簽名所需簽證2.3 微信web開發(fā)調(diào)試工具 2.3.2 調(diào)試JS-SDK相關(guān)功能基礎(chǔ)接口調(diào)試（11）微信卡券拉取適用卡券列表并獲取用戶選擇信息：wx.chooseCard( shopId: , / 門店Id cardType: , / 卡券類型 cardId: , / 卡券Id timestamp: 0, / 卡券簽名時間戳 nonceStr: , / 卡券簽名隨機串 signType: , / 簽名方式，默認(rèn)SHA1

39、cardSign: , / 卡券簽名 success: function (res) var cardList= res.cardList; / 用戶選中的卡券列表信息 );2.3 微信web開發(fā)調(diào)試工具 2.3.2 調(diào)試JS-SDK相關(guān)功能基礎(chǔ)接口調(diào)試（11）微信卡券拉取適用卡券列表并獲取用戶選擇信息：wx.chooseCard( shopId: , / 門店Id cardType: , / 卡券類型 cardId: , / 卡券Id timestamp: 0, / 卡券簽名時間戳 nonceStr: , / 卡券簽名隨機串 signType: , / 簽名方式，默認(rèn)SHA1 cardSig

40、n: , / 卡券簽名 success: function (res) var cardList= res.cardList; / 用戶選中的卡券列表信息 );參數(shù)名稱是否必填數(shù)據(jù)類型示例值參數(shù)描述shopId否string(24)1234門店ID。shopID用于篩選出拉起帶有指定location_list(shopID)的卡券列表，非必填。cardType否string(24)GROUPON卡券類型，用于拉起指定卡券類型的卡券列表。當(dāng)cardType為空時，默認(rèn)拉起所有卡券的列表，非必填。cardId否string(32)p1Pj9jr90_SQRaVqYI239Ka1erk卡券ID，用于拉起指定cardId的卡券列表，當(dāng)cardId