常見(jiàn)問(wèn)題

Q: 小游戲的文檔在哪里域滥？
A: 我們會(huì)把最新的文檔更新在 mp.weixin.qq.com/debug/纵柿，分為教程和 API 索引兩部分蜈抓。其中教程部分是一些對(duì)小程序開(kāi)發(fā)的指引和接口、能力的介紹昂儒，API 索引部分則陳列了每個(gè)接口的參數(shù)和返回值沟使。

Q: 什么時(shí)候可以注冊(cè)申請(qǐng)小游戲？ A: 請(qǐng)關(guān)注我們后期的公告渊跋。

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

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

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

Q: 小游戲有獲取用戶(hù)好友和群成員的接口嗎蟋软？ A: 目前不開(kāi)放镶摘。

Q: 小游戲開(kāi)發(fā)者工具無(wú)法上傳？ A: 目前開(kāi)放出來(lái)的是小游戲開(kāi)發(fā)的體驗(yàn)?zāi)Ｊ皆朗兀瑤椭_(kāi)發(fā)者提前了解小程序的開(kāi)發(fā)以及在移動(dòng)設(shè)備上預(yù)覽小游戲凄敢，所以沒(méi)有上傳以及提交體驗(yàn)的功能。

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

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

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

啟動(dòng)

Q: 小游戲啟動(dòng)時(shí)一直卡在 loading 頁(yè)玩徊。
A: 小游戲只有真正繪制了首幀之后，才會(huì)隱藏 loading 頁(yè)谨究，以減少用戶(hù)看到黑屏的概率恩袱。所以開(kāi)發(fā)者最好在游戲開(kāi)始時(shí)進(jìn)行一次簡(jiǎn)單的繪制，來(lái)減少用戶(hù)等待的時(shí)間胶哲。

Q: 如何加快小游戲啟動(dòng)速度畔塔？

A: 小游戲啟動(dòng)階段包括幾個(gè)耗時(shí)部分：

1. 下載小游戲資源包

2. 初始化界面

3. decode 圖片資源

4. 繪制

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

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

2. 圖片資源小一些

3. 先盡快繪制一個(gè)簡(jiǎn)單的界面讓加載頁(yè)面消失，讓用戶(hù)能看到頁(yè)面

內(nèi)存

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

分享

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

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

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

圖片

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

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

音頻

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

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

性能

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