iOS -- SKScene类

 

SKScene类

继承自	SKEffectNode:SKNode:UIResponder:NSObject
符合	NSCoding(SKNode) NSCopying(SKNode) NSObject(NSObject)
框架	/System/Library/Frameworks/SpriteKit.framework
可用性	可用于iOS 7.0或者更晚的版本
声明于	SKScene.h
参考指南	Sprite Kit Progamming Guide

概览

重要提示：这是一个初步的API或者开发技术文档。虽然已经审阅了本文档的技术准确性，但是它不是最终的版本。本机密信息仅适用于苹果开发者计划的注册会员。苹果提供这些机密信息来帮助你采用这些技术和编程接口。此信息如果有变更，根据本文档实现的软件应使用操作系统软件和最终文档测试。新版本的文档可能会拥有新的API或者技术。

一个SKScene实例表示一个游戏中的场景。一个场景节点通常是节点树中的根节点。节点树中的其他节点负责提供游戏内容，场景节点则负责渲染和显示。要显示一个场景，你需要先将它present到一个SKView实例中。

一个场景通过以下的处理来计算内容

1.场景调用update:方法。

2.场景执行其子节点的动作。

3.场景调用didEvaluateActions方法。

4.场景执行加入到场景中的物理体的物理模拟。

5.场景调用didSimulatePhysics方法。

子类节点

有时会创建场景类的子类。在子类场景中，要创景子类场景的内容以及执行逻辑。

方法

初始化一个场景

+ sceneWithSize:

创建并返回一个新的场景实例。

+ (SKScene *)sceneWithSize:(CGSize)size

参数	size:场景的大小
返回值	一个新的场景实例

论述

这个类方法创建一个新的场景并调用它的initWithSize:方法初始化这个场景。

- initWithSize

初始化一个新的场景实例。

- (id)initWithSize:(CGSize)size

参数	size:场景的大小
返回值	一个新的初始化好的场景实例

论述

这是类方法指定的初始化方法。

转变视图和场景的坐标系

- convertPointFromView:

将视图坐标系转成场景坐标系。

- (CGPoint)converPointFromView:(CGPoint)point

参数	point:视图坐标系中的一个点
返回值	这个点在场景坐标系中的位置

论述

在调用该方法之前，场景必须已经被加到视图中了。

- convertPointTOView:

将场景坐标系转成视图坐标系。

- (CGPoint)converPointToView:(CGPoint)point

参数	point:场景坐标系中的一个点
返回值	这个点在视图坐标系中的位置

论述

在调用该方法之前，场景必须已经被加到视图中了。

改变场景的大小

- didChangeSize:

当场景大小发生改变时调用该方法。

- (void)didChangeSize:(CGSize)oldSize

参数	oldSize:场景的原大小
返回值

论述

这个方法通常会被子类重写。

检测场景的弹出改变。

- willMoveFromView:

该方法会在场景移出视图之前调用。

- (void)willMoveFromView:(SKView *)view

参数	view:持有该场景的视图
返回值

论述

这个方法通常会被子类重写。

- didMoveToView:

该方法会在场景弹到视图上之后调用。

- (void)didMoveToView:(SKView *)view

参数	view:持有该场景的视图
返回值

论述

这个方法通常会被子类重写。

执行动画循环

- update:

在场景中动作执行之前需要执行的更新。

- (void)update:(NSTimeInterval)currentTime

参数	currentTime:已经过去的时间，保证单调递增
返回值

论述

不要直接调用这个方法，当场景加入到视图中，并且不是暂停状态时，它每一帧会被调用一次。你的场景子类应该重写这个方法，并执行一些需要的更新。

- didEvaluateActions

在场景中动作执行之后需要执行的更新。

- (void)didEvaluateActions

论述

不要直接调用这个方法，当场景加入到视图中，并且不是暂停状态时，它每一帧会被调用一次。你的场景子类应该重写这个方法，并执行一些需要的更新。

- didSimulatePhysics

在物理模拟执行之后需要执行的更新。

- (void)didSimulatePhysics

论述

不要直接调用这个方法，当场景加入到视图中，并且不是暂停状态时，它每一帧会被调用一次。你的场景子类应该重写这个方法，并执行一些需要的更新。

属性

查看视图相关属性

anchorPoint

场景原点在视图中的位置。

@property (atomic) CGPoint anchorPoint

论述

指定场景的坐标位置。默认值为(0,0)，表示场景在视图矩形的左下角。

scaleMode

定义场景如何映射到视图。

@property (atomic) SKSceneScaleMode scaleMode

论述

场景的大小和弹它出来的视图大小不相同是有可能的。该属性定义了场景如何映射到视图。详细值参见Scene Scaling Modes部分。默认值为SKSceneScaleModeFill。

view

场景所在的视图。只读。

@property (atomic, weak, readonly) SKView *view

论述

要弹出场景，需要调用SKView类的presentScene:方法或者presentScene:transition:方法。

设置场景的背景色

backgroundColor

场景的背景色。

@property (atomic, retain) SKColor *backgroundColor

论述

默认值为一个灰色的颜色值(RGBA0.15,0.15,0.15,1.0)。

改变场景的大小

size

场景的大小。

@property (atomic) CGSize *size

场景中运行的物理世界

physicsWorld

场景中的物理世界。

@property (atomic, readonly) SKPhysicsWorld *physicsWorld

论述

所有的场景自动模拟添加物理体的节点的物理特性。通过这个属性可以获取场景的全局物理属性，比如重力加速度。

常量

决定场景的弹出模式

typedef NS_ENUM(NSInteger,

SKSceneScaleMode){

SKSceneScaleModeFill,

SKSceneScaleModeAspectFill,

SKSceneScaleModeAspectFit,

SKSceneScaleModeResizeFill

}

SKSceneScaleModeFill	场景的每个轴独立缩放，场景完全映射到视图中
SKSceneScaleModeAspectFill	场景中每个轴使用相同的缩放因子，保证视图被完全填充，场景可能被剪裁
SKSceneScaleModeAspectFit	场景中每个轴使用相同的缩放因子，保证整个场景可见
SKSceneScaleModeResizeFill	场景不缩放，场景自动调整大小以适应视图