常見問題

Q: 小游戲的文檔在哪里？
A: 我們會把最新的文檔更新在 https://mp.weixin.qq.com/debug/wxagame/dev/index.html，分為教程和 API 索引兩部分。其中教程部分是一些對小程序開發(fā)的指引和接口、能力的介紹，API 索引部分則陳列了每個接口的參數(shù)和返回值。

Q: 什么時候可以注冊申請小游戲？
A: 請關(guān)注我們后期的公告。

Q: 小程序如何創(chuàng)建和獲取畫布？
A: 調(diào)用 wx.createCanvas() 接口即可創(chuàng)建畫布，畫布的使用方法詳見教程的 快速上手 部分

Q: 小游戲可以使用 document 和 window 嗎？
A: 不可以，小游戲的運(yùn)行環(huán)境是一個暴露了 wx API 的 JavaScript 運(yùn)行環(huán)境。對于小游戲運(yùn)行環(huán)境的介紹以及如何適配游戲引擎詳見教程的 Adapter 部分

Q: 小游戲支持 WebGL 嗎？
A: 小游戲支持 WebGL 1.0，通過 Canvas.getContext('webgl') 獲取 WebGL 渲染上下文。

Q: 小游戲有獲取用戶好友和群成員的接口嗎？ 
A: 目前不開放。

Q: 小游戲開發(fā)者工具無法上傳？
A: 目前開放出來的是小游戲開發(fā)的體驗(yàn)?zāi)Ｊ?，幫助開發(fā)者提前了解小程序的開發(fā)以及在移動設(shè)備上預(yù)覽小游戲，所以沒有上傳以及提交體驗(yàn)的功能。

Q：工具中提示域名不在合法域名列表？

A：這是工具的設(shè)置的一個問題，目前請開發(fā)者修改項(xiàng)目目錄下的 project.config.json 中的 urlCheck 的值為 false,即可跳過域名校驗(yàn)。在移動設(shè)備上打開調(diào)試，也可以跳過域名校驗(yàn)。

Q: 小游戲支持 WebGL 嗎？
A: 小游戲支持 WebGL 1.0，通過 Canvas.getContext('webgl') 獲取 WebGL 渲染上下文。  
A: 開發(fā)者工具在部分 windows 機(jī)器上，無法獲取 webgl 上下文，原因正在檢查中

啟動

Q: 小游戲啟動時一直卡在 loading 頁。
A: 小游戲只有真正繪制了首幀之后，才會隱藏 loading 頁，以減少用戶看到黑屏的概率。所以開發(fā)者最好在游戲開始時進(jìn)行一次簡單的繪制，來減少用戶等待的時間。

Q: 如何加快小游戲啟動速度？

A: 小游戲啟動階段包括幾個耗時部分：

1. 下載小游戲資源包

2. 初始化界面

3. decode 圖片資源

4. 繪制

所以想加快小游戲啟動，建議可以從這幾個點(diǎn)入手：

1. 縮減小游戲資源包大小

2. 圖片資源小一些

3. 先盡快繪制一個簡單的界面讓加載頁面消失，讓用戶能看到頁面

內(nèi)存

Q: 小游戲內(nèi)存為什么一直在上漲？
A: 平臺側(cè)不清楚何時進(jìn)行內(nèi)存釋放，所以需要游戲開發(fā)側(cè)在合適的時機(jī)調(diào)用 wx.triggerGC 釋放內(nèi)存。

分享

Q: 為何分享沒有圖片
A: 小游戲分享和小程序分享不同,小游戲不支持截屏,支持imageUrl參數(shù),可以通過保存Canvas接口存圖后,將路徑填入imageUrl中

Q: 為何分享替換了圖片卻沒有效果
A: Android 端對網(wǎng)絡(luò)圖片存在緩存,下載后不會主動刪除,所以不能只換圖不換url

Q: 為何分享圖片比例不對/顯示有黑邊或白邊
A: 顯示時會對圖片進(jìn)行裁剪放縮,圖片長寬比最好是5:4

圖片

Q: 為何加載圖片失敗
A: 小游戲圖片類型和大小有限制,格式目前支持png/jpeg（或jpeg/bmp(etc1, etc2, rgba)/gif/svg 大小 2048 * 2048 以下,圖片加載失敗的信息也會打印在 vConsole 中

Q: 為何預(yù)覽接口提示data too large
A: Android 中預(yù)覽接口的數(shù)據(jù)是通過 intent 傳輸?shù)筋A(yù)覽界面的,而整個系統(tǒng)對 intent 的資源空間大小是共用的1M, 所以這里傳入base64的數(shù)據(jù)會導(dǎo)致程序崩潰,所以建議傳url; 如果沒有 url 圖片,可以調(diào)用寫文件接口把圖片存到本地后,再傳文件路徑即可.

音頻

Q: 為何音頻播放有損
A: 小游戲音頻最多只支持10個音源同時播放,當(dāng)超過這個數(shù)量時,會丟棄當(dāng)前的播放請求.

Q: 為何音頻不同步
A: 小游戲音頻資源申請是異步的,如果有強(qiáng)依賴音頻的邏輯,建議在調(diào)用音頻接口后,等獲取到對應(yīng)的回調(diào)后再繼續(xù)往下處理

性能

Q: 在部分低端機(jī)型上性能很差
A: 低端機(jī)對部分函數(shù)的支持較差,可以嘗試去除一些陰影,減少一些紋理來降低性能的消耗.