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