1. 程式人生 > >微信小遊戲開放域之helloworld

微信小遊戲開放域之helloworld


標籤: 微信小遊戲,開放域


微信小遊戲-開放資料域的配置

概念

開放資料域 是一個封閉、獨立的 JavaScript 作用域。開放資料域主要作用就是獲取使用者的關係鏈資料,並且展示關係鏈資料
具體使用方法在官方文件已經非常詳細了-》開放資料域本文只是做一個簡單整理
具體的展示關係鏈資料

配置方法

1、新建開放資料域的程式碼目錄,以openDataContext為例,在目錄下新建index.js作為開放資料的入口檔案
2、在game.json中新增配置項 openDataContext

{
  "deviceOrientation": "portrait",
  "openDataContext": "src/openDataContext"
}

enter description hereenter description here

開放資料域限制

1、主域和開放資料域中的程式碼不能相互 require
2、wx.getUserCloudStorage、wx.getFriendCloudStorage() 和 wx.getGroupCloudStorage() 只能在 開放資料域 中呼叫。
3、wx.setUserCloudStorage() 和 wx.removeUserCloudStorage() 可以同時在 主域 和開放資料域中呼叫。
4、開放資料中不能修改sharedCanvas的寬高,如有需要,請在上屏canvas修改sharedCanvas的寬高
5、sharedCanvas只能被上屏canvas渲染


6、開放資料域不能向主域傳送訊息
7、sharedCanvas 不能呼叫 toDataURL 和 getContext。
8、開放資料域的所有 canvas 只支援 2d 渲染模式
9、開放資料域的 Image 只能使用本地或微信 CDN 的圖片,不能使用開發者自己伺服器上的圖片

主域限制

1、主域不能呼叫wx.getUserCloudStorage、wx.getFriendCloudStorage() 和 wx.getGroupCloudStorage() ,也就是說主域不能直接獲取使用者關係鏈資料,必須通過開放資料域獲取,再渲染到sharedCanvas上

主域和開放資料域的通訊

開放資料域不能向主域傳送訊息,主域可以呼叫開放資料域例項的postmassage()方法向開放資料域傳送訊息

// main.js
let openDataContext = wx.getOpenDataContext()
openDataContext.postMessage({
  text: 'hello',
  year: (new Date()).getFullYear()
})

在開放資料域中通過 wx.onMessage() 方法可以監聽從主域發來的訊息。

// src/openDataContext/index.js
wx.onMessage(data => {
  console.log(data)
  /* {
    text: 'hello',
    year: 2018
  } */
})

微信小遊戲 —— 關係鏈資料使用(排行榜的顯示)

前言

微信小遊戲屬於微信小程式的一個類目,小遊戲對比於普通的h5遊戲,其很大的一個特點是微信提供的關係鏈資料的使用,你可以獲得同玩這個遊戲的微信好友的資料,或者你在某個群的使用者資料

概念

具體概念請前往-》關係鏈資料使用指南
需要了解關係鏈api和開放域,主域等概念。以下著重介紹具體的api使用

wx.setUserCloudStorage() 託管使用者資料

ps: wx.setUserCloudStorage()介面在主域和開放資料域都可以使用

enter description hereenter description here

wx.setUserCloudStorage({
    KVDataList: [{ key: 'score', value: score }],
    success: res => {
        console.log(res);
        // 讓子域更新當前使用者的最高分,因為主域無法得到getUserCloadStorage;
        let openDataContext = wx.getOpenDataContext();
        openDataContext.postMessage({
            type: 'updateMaxScore',
        });
    },
    fail: res => {
        console.log(res);
    }
});

注意: KVDataList的value必須是字串String型別,否則會報錯

enter description hereenter description here

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

wx.getFriendCloudStorage()拉取當前使用者所有同玩好友的託管資料(開放資料域使用)

ps: 這個介面只能在開放資料域使用,即主域無法呼叫介面獲取好友資料

wx.getFriendCloudStorage({
    keyList: ['score', 'maxScore'], // 你要獲取的、託管在微信後臺都key
    success: res => {
        console.log(res.data);
    }
});

獲取到的資料如下:

enter description hereenter description here

繪製好友排行榜

沒錯,用你的canvas技術將獲取到的好友資料繪製到sharedCanvas上。sharedCanvas是微信預設提供的,不需要再次建立

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

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

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

繪製後如何顯示以及會遇到的問題?
需要在上屏canvas上通過drawImage()方法把這個sharedCanvas繪製到上屏canvas
主域的js:

//前提是要使用Wxkit
let openDataContext = this.linkOpenData({},"這裡傳寬度","這裡傳高度");
this.openDataContext = openDataContext;
this.addChild(openDataContext)

實際操作

首先把你的專案釋出為微信小遊戲專案

enter description hereenter description here enter description hereenter description here enter description hereenter description here
之後會報錯誤,這裡不用管就行了
然後在mian.js裡面加程式碼

 

public createGameScene(){
    //本來的程式碼
     //發信息給開放域,載入資料
        let openDataContext = wx.getOpenDataContext()
            openDataContext.postMessage({
            text: 'hello',
            year: (new Date()).getFullYear(),
            command:'loadRes',
        })

        let that = this;
    //這裡是讓開放域的資料先載入好
        setTimeout(function() {
        //呼叫linkOpenData方法
            let openData = that.linkOpenData({},that.stage.width,that.stage.height);
            that.addChild(openData)
        }, 2000);
}

//新增方法
 public  linkOpenData(message: {}, width?: number, height?: number, data?: Object) {
        console.log('呼叫開放資料域')

        let basic = {
            isRanking: false,
            text: "egret",
            data: data,
            year: (new Date()).getFullYear(),
            command: "open"
        }

        for (let key in message) {
            basic[key] = message[key];
        }

        let open_data_container = new egret.Sprite();
        let openDataContext = wx.getOpenDataContext();
        const bitmapdata = new egret.BitmapData(window["sharedCanvas"]);
        bitmapdata.$deleteSource = false;
        const texture = new egret.Texture();
        texture._setBitmapData(bitmapdata);
        let bitmap: egret.Bitmap;
        bitmap = new egret.Bitmap(texture);
        bitmap.width = width || 0
        bitmap.height = height || 0
        bitmap.name = "openData";
        open_data_container.addChild(bitmap);
        console.log(bitmap.width + '   ' + bitmap.height)

        egret.startTick((timeStarmp: number) => {
            egret.WebGLUtils.deleteWebGLTexture(bitmapdata.webGLTexture);
            bitmapdata.webGLTexture = null;
            return false;
        }, this);

        openDataContext.postMessage(basic);
        console.log('link_done');
        return open_data_container;
    }

執行專案,就有egret本來幫你寫好的開放域demo

enter description hereenter description here

作者簡介:何永峰,蘆葦科技web前端開發工程師,喜歡到處尋找好吃的,平時愛好是跳舞,打籃球,聽音樂,有時會出席一些大型的舞蹈商演活動,目前是Acum.Revolution現狀革命成員之一。並且代表作品:萌雞駕到、美旅出行小程式、電競桌子小程式。擅長網站建設、公眾號開發、微信小程式開發、小遊戲、公眾號開發,專注於前端領域框架、互動設計、影象繪製、資料分析等研究,訪問 www.talkmoney.cn 瞭解更多。