Codename One 覆盖了 iOS、Android、macOS、Windows、Linux、网页、手表和电视,现在又加上了嵌入式板卡。唯独少了一类:游戏主机。
从技术角度看,这件事似乎没那么难。主机就是一台带 GPU 和手柄的电脑,而这个框架已经在通过 Metal、Direct3D 和 OpenGL ES 渲染画面,也早就把手柄按键映射成了游戏动作。真正难的地方在于,主机相关的一切都被锁在保密协议(NDA)后面。本周迈出的第一步,恰好是不需要签协议的那一步。
一个构建参数
任何一台零售版 Xbox 都能切换到开发者模式(Developer Mode),从而侧载 UWP 应用用于测试。Codename One 现在可以构建出这个包,只需要一个构建参数:
codename1.arg.windows.xbox=true
它会把原生 Windows 移植版构建成 UWP 应用,并打包成已签名的 .msix 文件。如果没有提供证书,构建过程会在包旁边自动生成一个自签名的开发证书。接下来的步骤是:
- 在主机上安装 Dev Home,打开开发者模式和远程访问;
- 在浏览器中打开设备门户(Device Portal),地址为 https://:11443;
- 在 Home 页面下添加 .msix,并选择构建产出的 .cer 证书。
也可以先在 Windows 电脑上试同一个包:把证书导入本地计算机的“受信任人”存储,然后对 .msix 执行 Add-AppxPackage。
主机上要改的三件事
主机应用不是屏幕更大的桌面应用。移植版里有三处必须调整:
第一是应用容器。这里没有桌面窗口,移植版运行在 CoreWindow 上,用 Direct2D 绘制到 Direct3D 交换链。构建只链接 WindowsApp.lib,这等于在构建阶段就证明移植版发出的每个系统调用都在容器允许范围内。如果有调用不被允许,失败会发生在构建时,而不是主机上。
第二是手柄。方向键和左摇杆会以四个方向的形式传入,A 键对应开火,B 键对应返回,走的是游戏里已经在用的 Display.getGameAction(),和方向键的处理路径相同。用 com.codename1.gaming 写的游戏,或者从 Unity 2D 项目导入的游戏,不需要为主机单独写输入代码。
第三是电视。电视机会裁掉画面边缘,主机上报的可见区域通过 Display.getDisplaySafeArea() 获取。用它把分数和菜单放在观众看得到的位置。
下面这段读取输入的代码,从手机到桌面再到主机完全不变:
public void keyPressed(int keyCode) {
switch (Display.getInstance().getGameAction(keyCode)) {
case Display.GAME_LEFT: player.moveLeft(); break;
case Display.GAME_RIGHT: player.moveRight(); break;
case Display.GAME_FIRE: player.jump(); break;
}
}
目前的真实状态
这套东西是实验性的,限制也很实在。
持续集成在 Linux 上交叉编译目标,把包装到一台 Windows 机器上,检查它能否在应用容器内渲染出第一帧。目前还没有在真机 Xbox 上跑过。手柄输入和过扫描(overscan)只存在于主机上,所以这两项都未经验证。
桌面移植版的一些能力在容器里不可用:次级窗口、菜单、托盘、原生文本编辑器、文件对话框、剪贴板、打印、摄像头、录音和分享面板。唯一的文件根目录是应用自己的本地文件夹。
最关键的一点:开发者模式是测试沙箱,不是商店。用这种方式不能卖游戏。零售版 Xbox 游戏要在发行协议下,用微软的游戏开发工具包(Game Development Kit)构建。
主机需要的是另一种帮助
微软、索尼、任天堂,每一家主机平台方都把 SDK、开发硬件和认证流程放在保密协议后面。你要签发行或开发者协议才能拿到访问权,而在协议下了解到的东西不能公开。这对开源项目是一堵硬墙:使用这些 SDK 的代码不能放进公开仓库,甚至连在公开 issue 里描述这些 API 都不行。
所以主机移植分成两半:
- 可移植的那一半属于 Codename One,公开进行:无窗口宿主、手柄映射、安全区域,以及在任何平台都能跑的游戏代码。本周的 Xbox 工作构建并验证的就是这一半。
- 平台相关的那一半依赖各家 SDK,只能保持专有,并且只提供给持有对应主机 SDK 许可证的开发者。
项目方表示希望能走到那一步。如果你在平台方工作、在签有主机协议的 studio 工作,或者认识能对接的人,可以联系他们。一个用 Java 写的游戏,写一次就能同时发到主机、手机、桌面和网页,这个场景在不少小型工作室那里有需求。
Windows 章节覆盖了构建与安装,游戏主机附录则跟踪主机相关工作的进展。
热门跟贴