常見問題

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

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

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

Q: 小游戲可以使用 document 和 window 嗎？
A: 不(bu)可以(yi)，小(xiao)游(you)戲的(de)運(yun)行(xing)環(huan)境是一(yi)個暴露了(le) wx API 的(de) JavaScript 運(yun)行(xing)環(huan)境。對于小(xiao)游(you)戲運(yun)行(xing)環(huan)境的(de)介紹以(yi)及(ji)如何適配游(you)戲引擎詳見(jian)教程的(de) Adapter 部(bu)分

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

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

Q: 小游戲開發者工具無法上傳？
A: 目前開放(fang)出(chu)來的(de)(de)(de)是小(xiao)游(you)戲開發(fa)(fa)的(de)(de)(de)體驗模(mo)式(shi)，幫助開發(fa)(fa)者提前了解小(xiao)程序的(de)(de)(de)開發(fa)(fa)以(yi)及在移動(dong)設備上(shang)預覽小(xiao)游(you)戲，所(suo)以(yi)沒有(you)上(shang)傳以(yi)及提交體驗的(de)(de)(de)功(gong)能(neng)。

Q：工具中(zhong)提示域名不(bu)在(zai)合法(fa)域名列(lie)表？

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

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

啟動

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

Q: 如(ru)何加快小(xiao)游戲啟動速度？

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

1. 下(xia)載小游(you)戲資源包

2. 初始(shi)化界面

3. decode 圖片資源(yuan)

4. 繪制

所以(yi)想(xiang)加快小游(you)戲啟動(dong)，建(jian)議可以從這幾(ji)個點入手：

1. 縮減小游戲(xi)資(zi)源包大(da)小

2. 圖片資源(yuan)小一些

3. 先(xian)盡快繪制一個簡(jian)單(dan)的界面(mian)讓(rang)加載頁面(mian)消失，讓(rang)用(yong)戶(hu)能看到頁面(mian)

內存

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

分享

Q: 為何分享沒有圖片
A: 小游戲(xi)分(fen)享和(he)小程序分(fen)享不同,小游戲(xi)不支(zhi)持截屏,支(zhi)持imageUrl參數,可以通過(guo)保存Canvas接口存圖后(hou),將(jiang)路徑填(tian)入(ru)imageUrl中(zhong)

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

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

圖片

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

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

音頻

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

Q: 為何音頻不同步
A: 小(xiao)游戲音(yin)頻(pin)資源申請是異步的(de),如果有強依(yi)賴(lai)音(yin)頻(pin)的(de)邏輯(ji),建議在調用音(yin)頻(pin)接口后(hou),等獲取(qu)到對應的(de)回調后(hou)再繼續往(wang)下(xia)處理

性能

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