| 继承自 | NSObject |
| 符合 | NSCoding NSObject(NSObject) |
| 框架 | /System/Library/Frameworks/SpriteKit.framework |
| 可用性 | 可用于iOS 7.0或者更晚的版本 |
| 声明于 | SKPhysicsWorld.h |
| 参考指南 | Sprite Kit Progamming Guide |
概览
| 重要提示：这是一个初步的API或者开发技术文档。虽然已经审阅了本文档的技术准确性，但是它不是最终的版本。本机密信息仅适用于苹果开发者计划的注册会员。苹果提供这些机密信息来帮助你采用这些技术和编程接口。此信息如果有变更，根据本文档实现的软件应使用操作系统软件和最终文档测试。新版本的文档可能会拥有新的API或者技术。 |
SKPhysicsWorld实例模拟碰撞和其他物理属性。你不需要直接创建SKPhysicsWorld属性，你可以查看SKScene的physicsWorld属性。
SKPhysicsWorld实例可以允许你执行以下操作:
| 模拟一个全局的属性，比如重力 |
| 创建一个两个物理体之间的联合 |
| 设置一个接收两个相连物理体之间消息的代理 |
| 判断物理体之间的点、矩形、射线相交 |
方法
将物理体联合在一起。
| - addJoint: |
向物理世界中添加一个联合。
- (void)addJoint:(SKPhysicsJoint *)joint
| 参数 | joint:待添加的联合 |
| 返回值 |
论述
一个联合要产生作用，它必须要添加到物理世界中。
| - removeAllJonits |
移除物理世界中的所有联合。
- (void)removeAllJoints
| - removeJonit: |
移除物理世界中的指定联合。
- (void)removeJoint:(SKPhysicsJoint *)joint
| 参数 | joint:待移除的联合 |
| 返回值 |
查找物理世界中的物理体
| - bodyAlongRayStart:end: |
查找与射线相交的第一个物理体。
- (SKPhysicsBody *)bodyAlongRayStart:(CGPoint)start end:(CGPoint)end
| 参数 | start:射线的起始点 end:射线的结束点 |
| 返回值 | 与射线相交的第一个物理体，若没有，则返回nil |
| - bodyAtPoint: |
查找包含某个点的第一个物理体。
- (SKPhysicsBody *)bodyAtPoint:(CGPoint)point
| 参数 | point:场景坐标系中的一个点 |
| 返回值 | 包含这个点的第一个物理体，若没有，则返回nil |
| - bodyInRect |
查找与指定矩形相交的第一个物理体。
- (SKPhysicsBody *)bodyInRect:(CGRect)rect
| 参数 | rect:场景坐标系中的一个矩形 |
| 返回值 | 与这个矩形相交的第一个物理体，若没有，则返回nil |
| - enumerateBodiesAlongRayStart:end:usingBlock: |
枚举与射线相交的所有物理体。
- (void)enumerateBodiesAlongRayStart:(CGPoint)start end:(CGPoint)end usingBlock:(void(^)(SKPhysicsBody *body, CGPoint poing, CGpint normal, BOOL *stop))block
| 参数 | start:射线的起始点 end:射线的结束点 block:一个语法块，每一个与射线相交的物理体都会触发 body:与射线相交的物理体 point:射线与物理体的交点 normal:相交处的法线向量 stop:一个布尔值，用以终止枚举 |
| 返回值 |
| - enumerateBodiesAtPoint:usingBlock: |
枚举包含某个点的所有物理体。
- (void)enumerateBodiesAtPoint:(CGPoint)point usingBlock:(void(^)(SKPhysicsBody *body, BOOL *stop))block
| 参数 | point:场景坐标系中的点 block:一个语法块，每一个包含该点的物理体都会触发 body:射线相交的物理体 stop:一个布尔值，用以终止枚举 |
| 返回值 |
| - enumerateBodiesInRect:usingBlock: |
枚举与指定矩形相交的所有物理体。
- (void)enumerateBodiesInRect:(CGRect)rect usingBlock:(void(^)(SKPhysicsBody *body, BOOL *stop))block
| 参数 | rect:场景坐标系中的矩形 block:一个语法块，每一个与该矩形相交的物理体都会触发 body:与该矩形相交的物理体 stop:一个布尔值，用以终止枚举 |
| 返回值 |
属性
模拟物理世界
| gravity |
一个向量，指定物理世界的重力加速度。
@property(atomic) CGPoint gravity
论述
这个属性的单位是米每秒，默认值为(0.0,-9.8)，代表了地球重力加速度。
| speed |
模拟的执行速率。
@property(atomic)CGFloat speed
论述
默认值为1.0，表示模拟以正常速率执行。一个不同于默认值的值将改变模拟的执行速率。例如，一个2.0的值，表示模拟将以两倍速率执行。若只为0.0，则表示暂定模拟。
在物理世界检测碰撞。
| contactDelegate |
一个代理，当两个连在一起的物理体进来时，这个代理将被调用。
@property(atomic, assign) id<SKPhysicsContactDelegate> contactDelegate
论述
当两个物理体交叠时，连接就会被创建。一个拥有contactTestBitMask属性的物理体与另一个物理体的categoryBitMask属性交叠。