阅读 191

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

说明

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

此书对应的代码地址

SceneKit系列文章目录

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

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

  • macOS游戏Geometry Fighter
    WX20171202-194556@2x.png
  • tvOS游戏Breaker
    WX20171202-194627@2x.png
  • watchOS游戏Geometry Fighter
    WX20171202-194641@2x.png

16-macOS游戏Geometry Fighter

创建项目

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

WX20171202-203043@2x.png

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

WX20171202-203139@2x.png

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

WX20171202-203807@2x.png

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

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

WX20171202-203823@2x.png

转换SceneKit游戏

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

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

WX20171202-205516@2x.png

选择Add Target...

WX20171202-205530@2x.png

选择macOS平台,然后选择Game

WX20171202-210513@2x.png

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

WX20171202-210528@2x.png

选择GeometryFighterMac > My Mac作为Active Scheme.

WX20171202-210842@2x.png

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

多个target内容共享

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

WX20171202-212027@2x.png

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

WX20171202-212430@2x.png
WX20171202-212449@2x.png

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

WX20171202-213237@2x.png

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

WX20171202-213444@2x.png
WX20171202-213503@2x.png
WX20171202-213521@2x.png

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

#if os(iOS)
import UIKit
#endif
#if os(macOS)
import Cocoa
#endif
复制代码

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

WX20171202-215444@2x.png
WX20171202-215540@2x.png

清理

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

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

WX20171202-220527@2x.png

还要做的是恢复新的GameViewControllerMainMenu.xib之间的联系.

WX20171202-221725@2x.png

鼠标输入

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

WX20171202-221925@2x.png

添加连接函数:

WX20171202-222021@2x.png

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

WX20171202-222317@2x.png

运行一下程序:

WX20171202-222411@2x.png

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

17-tvOS游戏Breaker

创建项目

创建项目

WX20171203-094525@2x.png
WX20171203-094555@2x.png

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

WX20171203-094800@2x.png

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

WX20171203-095059@2x.png

移植到tvOS

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

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

WX20171203-095620@2x.png
WX20171203-095637@2x.png
WX20171203-095650@2x.png
WX20171203-095741@2x.png

targets间内容共享

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

WX20171203-095834@2x.png
WX20171203-095850@2x.png

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

WX20171203-100814@2x.png
WX20171203-100828@2x.png
WX20171203-100912@2x.png
WX20171203-100927@2x.png

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

添加专用代码

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

#if os(tvOS)
  scnView.pointOfView = horizontalCameraNode
#endif
复制代码

还有shouldAutorotate, prefersStatusBarHiddenviewWillTransition()也不需要了:

#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
复制代码
图标

图标资源在本章节对应的resources文件夹下.

打开BreakerTV/Assets.xcassets,选中App Icon & Top Shelf Image,将图片拖放进去:

WX20171203-110510@2x.png

运行一下,看到图标出现在Apple TV首页上了:

WX20171203-110525@2x.png

点击进入游戏,开始玩吧:

WX20171203-111349@2x.png

18-watchOS游戏Geometry Fighter

在Xcode中,并没有专门的watchOS版游戏的模板,我们需要做的是创建一个iOS的游戏,再给它添加watchOS的支持.

添加watchOS支持

我们直接在原iOS项目基础上添加watchOS的target:

WX20171203-111712@2x.png
WX20171203-111736@2x.png
WX20171203-111810@2x.png

Active Scheme中选择GeometryFighterWatch > iPhone 6s Plus + Apple Watch - 42mm

WX20171203-112044@2x.png

运行一下,看看效果:

WX20171203-112108@2x.png

targets间内容共享

创建Shared文件夹,移动需要的文件

WX20171203-113835@2x.png

然后依次选中各个文件夹下面的所有文件,添加Target Membership:

WX20171203-113941@2x.png
WX20171203-114001@2x.png
WX20171203-114021@2x.png
WX20171203-114035@2x.png

添加界面控制器

首先清理项目,选中InterfaceController.swiftart.scnassets.右键--删除--Move to Trash.

WX20171203-114804@2x.png

现在需要添加新的InterfaceController.swift.在本章节对应代码的resources/source文件夹下,拖放到Xcode中.

WX20171203-115029@2x.png

然后建立连接:

WX20171203-115144@2x.png

添加触摸输入

选中Interface.storyboard,拖放一个Tap Gesture Recognizer过来.

WX20171203-115320@2x.png

建立手势的连接:

WX20171203-115417@2x.png

现在已经基本完成了.

图标

所需图片资源在本章节对应的resource/AppIcon文件夹下.

选中Assets.xcassets下面的AppIcon,将图片拖放到其中:

WX20171203-115723@2x.png

运行一下,可以愉快地玩耍了!

WX20171203-115751@2x.png

项目的最终完成版本章节对应的projects/ final/GeometryFighter/ 文件夹下.