微信小遊戲API (doing)

1. 登入

wx.login({
    success: function(response) {
        if (response.code) {
            wx.request({
                url: 'https://serverurl/login/',
                data: {
                    code: response.code
                }
            })
        } else {
            console.log("登入失敗"
 
 + response.errMsg);
        }
    },
    timeout: 100, //超時時間，單位 ms
    fail: function() {}, // 失敗的回撥函式
    complete: function() {}, //介面呼叫結束的回撥函式（呼叫成功、失敗都會執行）
});

2. 使用者資訊

2.1授權

2.2 使用者資訊

1. 需要許可權 scope.userInfo
2. ​

wx.getUserInfo({
    success: function(res) {
        var userInfo = res.userInfo
        var
 
 nickName = userInfo.nickName // 暱稱
        var avatarUrl = userInfo.avatarUrl // 使用者頭像，最後一個數值代表正方形頭像大小（有0、46、64、96、132數值可選，0代表640*640正方形頭像），使用者沒有頭像時該項為空。若使用者更換頭像，原有頭像URL將失效。
        var gender = userInfo.gender //性別 0：未知、1：男、2：女
        var province = userInfo.province // 使用者所在省份
        var city = userInfo.city
        var
 
 country = userInfo.country
  }
})

3. 轉發分享

轉發： 使用者在使用小遊戲過程中，可轉發訊息給其他使用者或群聊。

// 1. 被動轉發
// 點選右上角按鈕，會彈出選單，選單中的“轉發”選項預設不展示。通過 wx.showShareMenu() 和 wx.hideShareMenu() 可動態顯示、隱藏這個選項。
wx.onShareAppMessage(function () {
  // 使用者點選了“轉發”按鈕
  return {
    title: '轉發標題'
  }
});

// 2. 主動轉發
wx.shareAppMessage({
    title: '轉發標題'
})
// 轉發圖片 圖示最佳顯示比例為 5:4
wx.onShareAppMessage(function () {
    return {
        title: '轉發標題',
        imageUrl: canvas.toTempFilePathSync({
            destWidth: 500,
            destHeight: 400
        })
    }
})

// 3. withShareTicket 模式

4. 關係鏈

// 對使用者託管資料進行寫資料操作
wx.setUserCloudStorage(obj);
/**
 * obj
 * +- KVDataList: Array<KVData>
 * +- success
 * +- fail
 * +- complete
 */


// 開放資料域
// wx.getUserCloudStorage、wx.getFriendCloudStorage() 和 wx.getGroupCloudStorage() 只能在開放資料域中呼叫。
// game.json配置
{
  "deviceOrientation": "portrait",
  "openDataContext": "src/myOpenDataContext"
}

託管資料的限制

• 每個openid所標識的微信使用者在每個遊戲上託管的資料不能超過128個key-value對。
• 上報的key-value列表當中每一項的key+value長度都不能超過1K(1024)位元組。
• 上報的key-value列表當中每一個key長度都不能超過128位元組。

4.2 開放域

開放域和主域的通訊問題：

// game.js
let openDataContext = wx.getOpenDataContext()
openDataContext.postMessage({
    text: 'hello',
    year: (new Date()).getFullYear()
})
// 在開放資料域中通過 wx.onMessage() 方法可以監聽從主域發來的訊息。
wx.onMessage(data => {
  console.log(data)
  /* {
    text: 'hello',
    year: 2018
  } */
})

4.3 展示關係鏈資料

如果想要展示通過關係鏈 API 獲取到的使用者資料，如繪製排行榜等業務場景，需要將排行榜繪製到 sharedCanvas 上，再在主域將 sharedCanvas 渲染上屏。

// src/myOpenDataContext/index.js
let sharedCanvas = wx.getSharedCanvas()

function drawRankList (data) {
  data.forEach((item, index) => {
    // ...
  })
}

wx.getFriendUserGameData({
  success: res => {
    let data = res.data
    drawRankList(data)
  }
})

// src/myOpenDataContext/index.js
let sharedCanvas = wx.getSharedCanvas()
let context = sharedCanvas.getContext('2d')
context.fillStyle = 'red'
context.fillRect(0, 0, 100, 100)

// 獲取開放域
let openDataContext = wx.getOpenDataContext()
let sharedCanvas = openDataContext.canvas

let canvas = wx.createCanvas()
let context = canvas.getContext('2d')
context.drawImage(sharedCanvas, 0, 0)

5. 支付

支付檔位

// 購買遊戲幣的時候，buyQuantity 不可任意填寫。
// 需滿足 buyQuantity * 遊戲幣單價 = 限定的價格等級
wx.requestMidasPayment({
    mode: 'game',
    offerId: '',  // 在米大師側申請的應用 id
    buyQuantity: 10, // 幣種
    zoneId: 1, // 分割槽 ID
    success() {
        // 支付成功
    },
    fail({ errMsg, errCode }) {
        // 支付失敗
        console.log(errMsg, errCode)
    }
})

6. 檔案系統

6.1 程式碼包檔案

程式碼包檔案指的是在專案目錄中新增的檔案。由於程式碼包檔案大小限制，程式碼包檔案適用於放置首次載入時需要的檔案，對於內容較大或需要動態替換的檔案，不推薦用新增到程式碼包中，推薦在小遊戲啟動之後再用下載介面下載到本地。

訪問程式碼包檔案：

本地檔案：

本地檔案指的是小程式被使用者新增到手機後，會有一塊獨立的檔案儲存區域，以使用者維度隔離。

本地使用者檔案是從1.7.0 版本開始新增的概念。微信提供了一個使用者檔案目錄給開發者，開發者對這個目錄有完全自由的讀寫許可權。通過 wx.env.USER_DATA_PATH 可以獲取到這個目錄的路徑。

const fs = wx.getFileSystemManager()
fs.writeFileSync(`${wx.env.USER_DATA_PATH}/hello.txt`, 'hello, world', 'utf8')

本地快取檔案：

本地儲存檔案只能通過呼叫特定介面產生，不能直接寫入內容。本地快取檔案產生後，重啟之後仍可用。本地快取檔案只能通過 FileSystemManager.saveFile() 介面將本地臨時檔案儲存獲得。

fs.saveFile({
    tempFilePath: '', // 傳入一個本地臨時檔案路徑
    success(res) {
        console.log(res.savedFilePath) // res.savedFilePath 為一個本地快取檔案路徑
    }
})

本地臨時檔案：

本地臨時檔案只能通過呼叫特定介面產生，不能直接寫入內容。本地臨時檔案產生後，僅在當前生命週期內有效，重啟之後即不可用。因此，不可把本地臨時檔案路徑儲存起來下次使用。如果需要下次在使用，可通過 FileSystemManager.saveFile() 或 FileSystemManager.copyFile() 介面把本地臨時檔案轉換成本地儲存檔案或本地使用者檔案。