ARSession

ARSessio的属性及其实例方法

//ARSession类在设备上配置并运行不同的增强现实技术。
API_AVAILABLE(ios(11.0)) API_UNAVAILABLE(macos, watchos, tvos)
@interface ARSession : NSObject

 //用于接收ARSession更新的代表。代理属性
@property (nonatomic, weak) id <ARSessionDelegate> delegate;

/**
 执行委托调用的调度队列。
  @discussion如果没有提供或没有，将在主队列上执行委托呼叫。
 */
@property (nonatomic, strong, nullable) dispatch_queue_t delegateQueue;

/**
 会话的当前帧。
 */
@property (nonatomic, copy, nullable, readonly) ARFrame *currentFrame;

 //会话正在使用的ARConfiguration。
@property (nonatomic, copy, nullable, readonly) ARConfiguration *configuration;

/**
 使用提供的配置运行会话。
  @discussion在已经开始的会话上调用运行
  过渡到立即使用新的配置。
  @param配置要使用的配置。
 */
- (void)runWithConfiguration:(ARConfiguration *)configuration NS_SWIFT_UNAVAILABLE("Use run(_:options:) instead");

/**
 使用提供的配置和选项运行会话。
  @discussion在已经开始的会话上调用运行过渡到立即使用新的配置。选项可用于在转换配置时更改默认行为。
  @param配置要使用的配置。
  @param选项要使用的运行选项。
 */
- (void)runWithConfiguration:(ARConfiguration *)configuration options:(ARSessionRunOptions)options NS_SWIFT_NAME(run(_:options:));

/**
 暂停会话
  @discussion一旦暂停，将不会收到更多的更新
  会话直到再次调用。
 */
- (void)pause;

/**
 在会话中添加一个锚点。
  @discussion锚将被添加到下一帧更新中。
  @param anchor要添加的锚点。
 */
- (void)addAnchor:(ARAnchor *)anchor NS_SWIFT_NAME(add(anchor:));

/**
从会话中删除一个锚点。
  @discussion锚将从后续的帧更新中删除。
  @param anchor要移除的锚点。
 */
- (void)removeAnchor:(ARAnchor *)anchor NS_SWIFT_NAME(remove(anchor:));

ARSession观察者协议方法

/**
 会话失败时调用。
  @discussion失败时，会话将暂停。
  @param session失败的会话。
  @param错误正在报告的错误（请参阅ARError.h）
 */
- (void)session:(ARSession *)session didFailWithError:(NSError *)error;

/**
 当相机的跟踪状态发生变化时，会调用此功能。
  @param session正在运行的会话。
  @param相机更改跟踪状态的相机。
 */
- (void)session:(ARSession *)session cameraDidChangeTrackingState:(ARCamera *)camera;

/**
 当会话中断时调用此方法。
  @discussion会话将被中断，不再能跟踪什么时候
  它无法接收所需的传感器数据。 当视频捕获中断时，
  例如当应用程序被发送到后台或当有的时候
  多个前台应用程序（请参阅AVCaptureSessionInterruptReason）。
  在中断结束之前，不会传送额外的帧更新。
  @param session中断的会话。
 */
- (void)sessionWasInterrupted:(ARSession *)session;

/**
 当会话中断结束时调用。
 
  @discussion会话将从最后一次已知的状态继续运行一次
  中断已经结束。 如果设备移动，锚点将不对齐。
  为避免这种情况，一些应用程序可能想要重置跟踪（请参阅ARSessionRunOptions）。
  @param session中断的会话。
 */
- (void)sessionInterruptionEnded:(ARSession *)session;

/**
 当会话输出新的音频采样缓冲区时，这被称为。
  @param session正在运行的会话。
  @param audioSampleBuffer捕获的音频采样缓冲区。
 */
- (void)session:(ARSession *)session didOutputAudioSampleBuffer:(CMSampleBufferRef)audioSampleBuffer;

@end

ARSessionDelegate 代理方法

/**
 当新的帧被更新时调用。
  @param session正在运行的会话。
  @param frame已更新的框架。
 */
- (void)session:(ARSession *)session didUpdateFrame:(ARFrame *)frame;

/**
 当新的锚点被添加到会话时，这被称为。
  @param session正在运行的会话。
  @param anchors一个添加的锚的数组。
 */
- (void)session:(ARSession *)session didAddAnchors:(NSArray<ARAnchor*>*)anchors;

/**
 当锚更新时调用。
  @param session正在运行的会话。
  @param anchors一组更新的锚点。
 */
- (void)session:(ARSession *)session didUpdateAnchors:(NSArray<ARAnchor*>*)anchors;

/**
 当从会话中删除锚时，会调用此方法。
  @param session正在运行的会话。
  @param anchors已删除的锚点的数组。
 */
- (void)session:(ARSession *)session didRemoveAnchors:(NSArray<ARAnchor*>*)anchors;