iOS开发之SceneKit框架--SCNView.h

1、SCNView

　　在macOS中，SCNView是NSView的子类，在iOS和tvOS中，SCNView是UIView的子类。SCNView用于显示SceneKit的3D场景，而需要设置场景的相关内容和属性需要通过SCNScene。SCNView需要遵循SCNSceneRenderer协议和SCNTechniqueSupport协议。

2、相关API简介

• 初始化方法　　

- (instancetype)initWithFrame:(CGRect)frame options:(nullable NSDictionary<NSString *, id> *)options;

• 设置SCNScene场景

@property(nonatomic, retain, nullable) SCNScene *scene;

• 对视图进行配置

//视图在什么时候重绘
//当YES时，视图在显示链接帧速率上继续重绘。
//当设NO时，该视图将只在某些改变或在接收器场景中动画时重新绘制。默认为NO。
@property(nonatomic, assign) BOOL rendersContinuously;
//设置动画帧速率
@property(nonatomic) NSInteger preferredFramesPerSecond API_AVAILABLE(macos(10.12));
//设置抗锯齿模式me局
@property(nonatomic) SCNAntialiasingMode antialiasingMode API_AVAILABLE(macos(10.10));

• 相机管理控制

//允许操纵相机，用户可以改变视角的位置和方向
@property(nonatomic) BOOL allowsCameraControl;

//allowsCameraControl为YES时 获取当前相机的相关配置（只读属性）
@property(nonatomic, readonly) id <SCNCameraControlConfiguration> cameraControlConfiguration API_AVAILABLE(macos(10.13), ios(11.0), tvos(11.0), watchos(4.0));

//allowsCameraControl为YES时 获取默认相机控制器
@property(nonnull, nonatomic, readonly) SCNCameraController* defaultCameraController API_AVAILABLE(macos(10.13), ios(11.0), tvos(11.0), watchos(4.0));

• 在视图的场景中播放动作和动画

//恢复播放视图的场景。
- (IBAction)play:(nullable id)sender;

//暂停视图场景的播放。
- (IBAction)pause:(nullable id)sender;

//停止回放视图的场景，并将场景时间重置到其开始时间
- (IBAction)stop:(nullable id)sender;

• 其它方法

//指定与接收器相关的EAGL上下文。
//如果当前API为金属，则此属性返回零，并没有影响。
@property(nonatomic, retain, nullable) EAGLContext *eaglContext;

//截屏
- (UIImage *)snapshot API_AVAILABLE(macos(10.10));

• 相关枚举和结构体

#if defined(SWIFT_SDK_OVERLAY2_SCENEKIT_EPOCH) && SWIFT_SDK_OVERLAY2_SCENEKIT_EPOCH >= 3
typedef NSString * SCNViewOption NS_STRING_ENUM;
#else
typedef NSString * SCNViewOption;
#endif

//SCNRenderingAPI
FOUNDATION_EXTERN SCNViewOption const SCNPreferredRenderingAPIKey API_AVAILABLE(macos(10.11), ios(9.0)) __WATCHOS_UNAVAILABLE;

//The value is directly a id <MTLDevice>. 金属
FOUNDATION_EXTERN SCNViewOption const SCNPreferredDeviceKey API_AVAILABLE(macos(10.11), ios(9.0));

//The value is a NSNumber wrapping a BOOL. Defaults to NO. 非金属
FOUNDATION_EXTERN SCNViewOption const SCNPreferLowPowerDeviceKey API_AVAILABLE(macos(10.11), ios(9.0));

#define SCNViewOptionPreferredRenderingAPI SCNPreferredRenderingAPIKey
#define SCNViewOptionPreferredDevice       SCNPreferredDeviceKey
#define SCNViewOptionPreferLowPowerDevice  SCNPreferLowPowerDeviceKey

//相机控制器相关信息
API_AVAILABLE(macos(10.13), ios(11.0), tvos(11.0), watchos(4.0))
@protocol SCNCameraControlConfiguration <NSObject>
@property(nonatomic, assign) BOOL autoSwitchToFreeCamera;
@property(nonatomic, assign) BOOL allowsTranslation;
@property(nonatomic, assign) CGFloat flyModeVelocity; // in m/s
@property(nonatomic, assign) CGFloat panSensitivity;
@property(nonatomic, assign) CGFloat truckSensitivity;
@property(nonatomic, assign) CGFloat rotationSensitivity;
@end