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 场景不缩放,场景自动调整大小以适应视图

你可能感兴趣的:(sc)