QQ小程序平台接入遇到的坑

本文档持续更新

1. 分享提示“分享过于频繁，稍后再试”
   解决办法：这是QQ官方的设定，限制每天只能分享10次（弹出好友框就算1次，而不管是否真的有发送分享），游戏内要做好逻辑，满次数了就不要再引导用户分享了

2. egret开发的游戏，安卓/ios，矩形Rect 当fillAlpha=0时，必现变成纯黑色
   官方已知Bug，（后面版本已修复，未验证），
   避坑办法： 把fillAlpha=0的改成0.01，可修改egret引擎文件eui.min.js，这样就无需修改业务代码。注意Rect 不能设置strokeColor和strokeWeight，设置了的话即使改成0.01也无效

3. ios真机界面部分文字偶现显示异常，如a界面有b按钮，在c界面中的d按钮上的文字显示成了b按钮
   解决办法：官方已知Bug，（后面版本已修复，未验证），暂无避坑方法。

4. egret开发的游戏，安卓/ios真机，必现渲染异常，具体表现为使用egret.Rectangle 坐标偏移的动画 区域不对
   解决办法：底层Bug，截止到2019.8.8 还未修复，暂无避坑方法。

5. 部分机型屏幕坐标异常，如小米8（华为荣耀x5, 三星s9 也有这个问题）
   解决办法：底层Bug，最新QQ 客户端已修复（大概2019年6月）

6. websocket 底层断开之后未派发断开事件，安卓/ios真机
   解决办法：底层Bug，截止到2019年7月还未修复，暂无避坑方法

7. 安卓 gif头像无法显示
   解决办法：qq头像支持gif动态图，但是 egret游戏不支持，暂无解决办法

8. 部分机器没有震动，如华为荣耀x5
   解决办法：截止到2019年6月暂无避坑方法

9. 弹出授权框，点击禁止后，再点击授权按钮不会弹出授权框
   解决办法：底层Bug，截止到2019年6月还未修复，暂无避坑方法

10. ios真机 发热严重、偶现闪退
    解决办法：升级到最新QQ 客户端正常（大概2019年6月）

11. 后台配置了服务器websocket域名，但仍然连接失败
    解决办法：QQ小游戏不像微信，只配置域名就可以，QQ平台需要同时配置域名和端口，比如s1001.xxxx.xxxx.com:8044

12. 分享链接邀请好友，有好友进来统计不到用户（android必现，ios正常）
    解决办法：这是安卓客户端的bug，具体为：getLaunchOptionsSync() api返回的属性query为空。（大概2019年7月版本已修复）

13. Banner广告调用hide后不消失
    解决办法：这是一个Bug，原因是调用show后马上调用hide会导致 hide不成功，可通过加延时hide来避坑

14. 部分机型（mate 10 pro）广告位置异常问题
    解决办法：升级到最新QQ 客户端正常（大概2019年6月）

15. api qq.navigateToMiniProgram跳转到别的游戏后，之前游戏就退出了 这样就没办法实现“试玩有礼功能”
    这是QQ平台的机制，且从2019年7月开始，QQ已经禁止使用这个api了。

16. qq.onKeyboardComplete里面调用qq.hideKeyboard，在qq-ios 里面会死循环
    解决办法：qq.onKeyboardComplete里面不要调用qq.hideKeyboard，代码示例如下：

window["wx"].showKeyboard({
       defaultValue: "132",
        maxLength: 999,
        multiple: false,
        confirmHold: true,
        confirmType: "send",
        success: ()=>{
        }
 })
window["wx"].onKeyboardComplete(()=>{
	//window["wx"].hideKeyboard({}); //不要调用这句
 });

17. Laya项目 iphoneX真机，加粗（size=30）会导致数字高高低低显示不整齐
    解决办法：不要加粗，代码：this.coin.bold = false;

18. egret项目 ios真机，声音文件播放2次（同样代码 安卓/微信小游戏/字节小游戏没有此问题）
    解决办法：这是一个大坑，经过排查发现是白鹭底层调用play后又设置了seek，刚好触发了这个问题。解决方法是 修改egret.wxgame.js 文件，改变代码顺序，先设置 seek，再调用play

本文原创，转载请注明出处