常见问题

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: 低端机对部分函数的支持较差,可以尝试去除一些阴影,减少一些纹理来降低性能的消耗.