PC 小游戏接入指南

PC 端微信已经支持大部分运行原来手机小游戏所需要的接口,包括但不限于虚拟支付、激励视频广告、开放数据域、触摸事件等。大多数小游戏可以在不更改代码的情况下以兼容模式运行在 PC 端微信上。

为了让用户在 PC 端拥有更好的小游戏体验,我们提供了一些额外的接口与功能。

大屏支持

PC 端小游戏窗口大小默认和移动端一致,如果想获取更好的大屏体验,可以在 game.json 配置项中开启 {"resizable": true}

关于 resizable 配置的详细解释可以参见 框架-小游戏配置

键盘事件

PC 端微信提供 keydown, keyup 两个键盘事件,返回的 KeyEvent 对象为 Web 标准对象的子集,包括 key, code 等属性

详细文档参见 key-event

鼠标事件

鼠标事件有 mousedown, mouseup, mousemove 三种,返回的 MouseEvent 对象为 Web 标准对象的子集,包括 x, y, button 等属性

需要注意,PC 端也有 touch 事件,其用法与手机上完全一致,通过鼠标左键事件分发,目的是为了兼容手机小游戏

详细文档参见 mouse-event

滚轮事件

滚轮事件只有一个,返回的 WheelEvent 对象为 web 标准对象的子集,包括 deltaX, deltaY 等属性

需要注意,delta 的值大小可能与滚轮转动的幅度无关,请只关注数值的正负性*

详细文档参见 wheel-event

自定义光标

自定义光标接口允许开发者设置游戏窗口内的鼠标图片,如果需要实现窗口内不同位置(元素)的鼠标样式不同,可以配合鼠标移动事件一起使用

详细文档请参见 wx.setCursor

虚拟支付

使用原有的接口 wx.requestMidasPayment 即可实现虚拟支付,但是有一点需要注意,传入的参数中 platform 字段使用“windows”

测试方法

  1. 测试正式版/体验版小游戏

登录最新版微信后,通过左侧工具栏的小程序面板点击小游戏即可;也可以通过手机分享给文件传输助手后打开

  1. 测试开发版小游戏

在开发工具里,设置 - 通用设置 选择 启动 PC 端自动预览,然后在工具栏预览图标里选择 自动预览 Tab,点击 编译并预览 即可

  1. 问题反馈

若遇到问题,可在 PC小游戏社区 发帖反馈,我们将协助解决