[SceneKit专题]跨平台游戏(macOS,tvOS,watchOS)

说明

本系列文章是对<3D Apple Games by Tutorials>一书的学习记录和体会此书对应的代码地址

SceneKit系列文章目录

更多iOS相关知识查看github上WeekWeekUpProject

以前面的游戏为例,将其改为跨平台版本:

macOS游戏Geometry Fighter

[email protected]
tvOS游戏Breaker

[email protected]
watchOS游戏Geometry Fighter

[email protected]

16-macOS游戏Geometry Fighter

创建项目

打开Xcode创建新项目,选择macOS平台,选择Game类型,点击Next继续.

[SceneKit专题]跨平台游戏(macOS,tvOS,watchOS)_第3张图片

[email protected]

输入游戏名SceneKitGame,选择Swift语言,SceneKit游戏技术,取消Unit和UI Tests,点击Finish.

[SceneKit专题]跨平台游戏(macOS,tvOS,watchOS)_第4张图片

[email protected]

生成的项目类似于iOS项目,但不完全相同:

[SceneKit专题]跨平台游戏(macOS,tvOS,watchOS)_第5张图片

[email protected]

GameView.swift:继承于SCNView,可以响应鼠标键盘事件但不能触摸.
GameViewController.swift:继承于NSViewController.
MainMenu.xib:控制器的xib.

选择My Mac,运行一下游戏:

[SceneKit专题]跨平台游戏(macOS,tvOS,watchOS)_第6张图片

[email protected]

转换SceneKit游戏

可以在projects/ starter/GeometryFighter/中打到原iOS版的项目.

打开iOS版项目,点击GeometryFighter,添加新的target:

[SceneKit专题]跨平台游戏(macOS,tvOS,watchOS)_第7张图片

[email protected]

选择Add Target...

[SceneKit专题]跨平台游戏(macOS,tvOS,watchOS)_第8张图片

[email protected]

选择macOS平台,然后选择Game

[SceneKit专题]跨平台游戏(macOS,tvOS,watchOS)_第9张图片

[email protected]

输入项目名GeometryFighterMac,选择SceneKit,取消Unit Tests和UI Tests,点击Finish:

[SceneKit专题]跨平台游戏(macOS,tvOS,watchOS)_第10张图片

[email protected]

选择GeometryFighterMac > My Mac作为Active Scheme.

[SceneKit专题]跨平台游戏(macOS,tvOS,watchOS)_第11张图片

[email protected]

运行后,看到的还是默认的飞机场景,那是因为还需要其他步骤.

多个target内容共享

可以在iOS和macOS之间共享原来的代码和资源.创建一个Shared分组

[SceneKit专题]跨平台游戏(macOS,tvOS,watchOS)_第12张图片

[email protected]

将下列文件和文件夹移动到Shared下面:

[SceneKit专题]跨平台游戏(macOS,tvOS,watchOS)_第13张图片

[email protected]

[SceneKit专题]跨平台游戏(macOS,tvOS,watchOS)_第14张图片

[email protected]

按住Shift键,选中GeometryFighter/ Shared/Particles下面的全部文件,打开右侧的属性检查器,勾选Target Membership下面的GeometryFighterMac;这样就能在iOS target和macOS target之间共享了.

[SceneKit专题]跨平台游戏(macOS,tvOS,watchOS)_第15张图片

[email protected]

Shared下面的其他几个也是类似操作.

[SceneKit专题]跨平台游戏(macOS,tvOS,watchOS)_第16张图片

[email protected]

[SceneKit专题]跨平台游戏(macOS,tvOS,watchOS)_第17张图片

[email protected]

[SceneKit专题]跨平台游戏(macOS,tvOS,watchOS)_第18张图片

[email protected]

为了解决跨平台带来的问题,还需要添加下列代码:

#if os(iOS)
import UIKit
#endif
#if os(macOS)
import Cocoa
#endif

当然了,我们不需要每个文件都去添加,只需要将已创建好的resources/ GameUtils/文件导入进来就可以了.首先,删除一些旧文件,选中GameHelper.swift和UIColor+Extensions.swift.
右键--删除--Move to Trash.
将resources/ GameUtils/下面的所有文件拖放到Shared/ GameUtils/文件夹下

[SceneKit专题]跨平台游戏(macOS,tvOS,watchOS)_第19张图片

[email protected]

[SceneKit专题]跨平台游戏(macOS,tvOS,watchOS)_第20张图片

[email protected]

清理

还需要清理一下项目.选中GameView.swift, GameViewController.swift和art.scnassets.右键删除--Move to Trash.

然后从示例代码中本章节的resources/GameViewController文件夹下拖放GameView.swift和GameViewController.swift到项目中,选中Copy items if needed和GeometryFighterMac,点击Finish完成.

[SceneKit专题]跨平台游戏(macOS,tvOS,watchOS)_第21张图片

[email protected]

还要做的是恢复新的GameViewController与MainMenu.xib之间的联系.

[SceneKit专题]跨平台游戏(macOS,tvOS,watchOS)_第22张图片

[email protected]

鼠标输入

选中MainMenu.xib,从右侧对象库中拖放一个Click Gesture Recognizer到Game View中.

[SceneKit专题]跨平台游戏(macOS,tvOS,watchOS)_第23张图片

[email protected]

添加连接函数:

[SceneKit专题]跨平台游戏(macOS,tvOS,watchOS)_第24张图片

[email protected]

现在还差最后一步,添加AppIcon,你可以从本章节的resources/AppIcon/文件夹中找到,拖放到Assets.xcassets中的AppIcon下:

[SceneKit专题]跨平台游戏(macOS,tvOS,watchOS)_第25张图片

[email protected]

运行一下程序:

[SceneKit专题]跨平台游戏(macOS,tvOS,watchOS)_第26张图片

[email protected]

本项目的最终完成版代码可以在对应章节的projects/ final/GeometryFighter/下找到.

17-tvOS游戏Breaker

创建项目

[SceneKit专题]跨平台游戏(macOS,tvOS,watchOS)_第27张图片

[email protected]

[SceneKit专题]跨平台游戏(macOS,tvOS,watchOS)_第28张图片

[email protected]

在Active Scheme中选择SceneKitGame > tvOS Simulator > Apple TV 1080p:

[SceneKit专题]跨平台游戏(macOS,tvOS,watchOS)_第29张图片

[email protected]

运行一下,可以看到默认的飞机模型.但是真实的Apple TV是要用遥控器操作的,怎么用呢?在模拟器的Hardware > Show Apple TV Remote中,就可以调出遥控器了:

[SceneKit专题]跨平台游戏(macOS,tvOS,watchOS)_第30张图片

[email protected]

移植到tvOS

在代码中找到本章节的projects/ starter/Breaker/文件夹接着处理.

和前面类似,选中Breaker,添加新的target,在弹出窗中选择tvOS和Game.

[SceneKit专题]跨平台游戏(macOS,tvOS,watchOS)_第31张图片

[email protected]

[SceneKit专题]跨平台游戏(macOS,tvOS,watchOS)_第32张图片

[email protected]

[SceneKit专题]跨平台游戏(macOS,tvOS,watchOS)_第33张图片

[email protected]

[SceneKit专题]跨平台游戏(macOS,tvOS,watchOS)_第34张图片

[email protected]

targets间内容共享

添加一个Shared分组,并将原来的文件拖放进来:

[SceneKit专题]跨平台游戏(macOS,tvOS,watchOS)_第35张图片

[email protected]

[SceneKit专题]跨平台游戏(macOS,tvOS,watchOS)_第36张图片

[email protected]

逐一选中文件夹下的所有文件,添加Target Membership:

[SceneKit专题]跨平台游戏(macOS,tvOS,watchOS)_第37张图片

[email protected]

[SceneKit专题]跨平台游戏(macOS,tvOS,watchOS)_第38张图片

[email protected]

[SceneKit专题]跨平台游戏(macOS,tvOS,watchOS)_第39张图片

[email protected]

[SceneKit专题]跨平台游戏(macOS,tvOS,watchOS)_第40张图片

[email protected]

还需要清理一下代码.
选中BreakerTV/art.scnassets和BreakerTV/GameViewController.swift,删除--Move To Trash:

添加专用代码

打开GameViewController.swift,在setupNodes()末尾添加代码:

#if os(tvOS)
  scnView.pointOfView = horizontalCameraNode
#endif

还有shouldAutorotate, prefersStatusBarHidden和viewWillTransition()也不需要了:

#if os(iOS)
override var shouldAutorotate: Bool {
... }
override var prefersStatusBarHidden: Bool {
... }
override func viewWillTransition(to size: CGSize, with coordinator:
  UIViewControllerTransitionCoordinator) {
... }
#endif

遥控触摸事件

和iOS的触摸事件不同,遥控上更接近MacBook的触摸板的逻辑,touchesBegin()的初始位置总是(x:960, y: 540),即1080p显示器的中心,touchesMoved()时的位置则是相对于初始点的位置.

另外还有一个问题:tvOS遥控器的触摸板太灵敏了,轻微移动就是很长距离.我们需要在GameViewController中找到下面的代码:

 paddleNode.position.x = paddleX +
  (Float(location.x - touchX) * 0.1)

将其更改为:

#if os(iOS)
  paddleNode.position.x = paddleX +
    (Float(location.x - touchX) * 0.1)
#elseif os(tvOS)
  paddleNode.position.x = paddleX +
    (Float(location.x - touchX) * 0.01)
#endif