常見問題

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

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

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

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

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

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

Q: 小游戲開發者工具無法上傳？
A: 目前開放出來的是小游戲開發的體驗模式，幫助開發者提前了解小程序的開發以及在移動設備上預覽小游戲，所以沒有上傳以及提交體驗的功能。

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

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

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

啟動

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

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

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

 

1. 下載小游戲資源包

2. 初始化界面

3. decode 圖片資源

4. 繪制

 

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

 

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

2. 圖片資源小一些

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

內存

Q: 小游戲內存為什么一直在上漲？
A: 平臺側不清楚何時進行內存釋放，所以需要游戲開發側在合適的時機調用 wx.triggerGC 釋放內存。

分享

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

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

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

圖片

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

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

音頻

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

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

性能

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