Spec-Zone .ru
спецификации, руководства, описания, API

Библиотека Разработчика iOS

Разработчик

Ссылка платформы AVFoundation ссылка класса AVCaptureVideoPreviewLayer

Опции
Развертывание Target:

На этой странице
Язык:

AVCaptureVideoPreviewLayer

Наследование

Соответствует

Оператор импорта

Swift

import AVFoundation

Objective C

@import AVFoundation;

Доступность

Доступный в iOS 4.0 и позже.

AVCaptureVideoPreviewLayer подкласс CALayer то, что Вы используете для отображения видео, поскольку оно получается устройством ввода данных.

Вы используете этот уровень предварительного просмотра в сочетании с сеансом получения AV, как проиллюстрировано в следующем фрагменте кода:

  • AVCaptureSession *captureSession = <#Get a capture session#>;
  • AVCaptureVideoPreviewLayer *previewLayer = [AVCaptureVideoPreviewLayer layerWithSession:captureSession];
  • UIView *aView = <#The view in which to present the layer#>;
  • previewLayer.frame = aView.bounds; // Assume you want the preview layer to fill the view.
  • [aView.layer addSublayer:previewLayer];

Вы используете videoGravity свойство, чтобы влиять, как содержание просматривается относительно границ слоев. На некоторых аппаратных конфигурациях можно управлять ориентацией использования уровня orientation и mirrored.

Создание уровня предварительного просмотра
  • init (сеанс:) - initWithSession:

    Инициализирует уровень предварительного просмотра с данным сеансом получения.

    Объявление

    Swift

    init!(session session: AVCaptureSession!)

    Objective C

    - (id)initWithSession:(AVCaptureSession *)session

    Параметры

    session

    Сеанс получения, из которого можно получить предварительный просмотр.

    Возвращаемое значение

    Уровень предварительного просмотра, инициализированный для использования session.

    Оператор импорта

    Objective C

    @import AVFoundation;

    Swift

    import AVFoundation

    Доступность

    Доступный в iOS 4.0 и позже.

    См. также

    + layerWithSession:
    – initWithSessionWithNoConnection:

  • layerWithSession (_:) + layerWithSession:

    Возвращает уровень предварительного просмотра, инициализированный с данным сеансом получения.

    Объявление

    Swift

    class func layerWithSession(_ session: AVCaptureSession!) -> AnyObject!

    Objective C

    + (id)layerWithSession:(AVCaptureSession *)session

    Параметры

    session

    Сеанс получения, из которого можно получить предварительный просмотр.

    Возвращаемое значение

    Уровень предварительного просмотра, инициализированный для использования session.

    Оператор импорта

    Objective C

    @import AVFoundation;

    Swift

    import AVFoundation

    Доступность

    Доступный в iOS 4.0 и позже.

    См. также

    – initWithSession:
    + layerWithSessionWithNoConnection:

  • init (sessionWithNoConnection:) - initWithSessionWithNoConnection:

    Инициализирует уровень предварительного просмотра с помощью данного сеанса получения, но не делая соединений.

    Объявление

    Swift

    init!(sessionWithNoConnection session: AVCaptureSession!)

    Objective C

    - (id)initWithSessionWithNoConnection:(AVCaptureSession *)session

    Параметры

    session

    Сеанс получения, который будет предварительно просмотрен.

    Возвращаемое значение

    Уровень предварительного просмотра, инициализированный с session но без соединений с любым из sessionприемлемые видеовходы

    Обсуждение

    Только используйте этот инициализатор, если Вы намереваетесь вручную сформировать соединение между желаемым AVCaptureInputPort возразите и использование получателя addConnection:.

    Оператор импорта

    Objective C

    @import AVFoundation;

    Swift

    import AVFoundation

    Доступность

    Доступный в iOS 8.0 и позже.

    См. также

    + layerWithSessionWithNoConnection:
    – initWithSession:

  • layerWithSessionWithNoConnection (_:) + layerWithSessionWithNoConnection:

    Возвращает уровень предварительного просмотра с помощью данного сеанса получения, но не делая соединений.

    Объявление

    Swift

    class func layerWithSessionWithNoConnection(_ session: AVCaptureSession!) -> AnyObject!

    Objective C

    + (id)layerWithSessionWithNoConnection:(AVCaptureSession *)session

    Параметры

    session

    Сеанс получения, который будет предварительно просмотрен.

    Возвращаемое значение

    Уровень предварительного просмотра, инициализированный с session но без соединений с любым из sessionприемлемые видеовходы

    Обсуждение

    Только используйте этот метод, если Вы намереваетесь вручную сформировать соединение между желаемым AVCaptureInputPort возразите и использование получателя addConnection:.

    Оператор импорта

    Objective C

    @import AVFoundation;

    Swift

    import AVFoundation

    Доступность

    Доступный в iOS 8.0 и позже.

    См. также

    – initWithSessionWithNoConnection:
    + layerWithSession:

Конфигурация уровня
  • videoGravity Свойство

    Указывает, как видео выведено на экран в проигрывателе границы уровня rect.

    Объявление

    Swift

    var videoGravity: String!

    Objective C

    @property(copy) NSString *videoGravity

    Обсуждение

    Опции AVLayerVideoGravityResizeAspect, AVLayerVideoGravityResizeAspectFill и AVLayerVideoGravityResize. Значение по умолчанию AVLayerVideoGravityResizeAspect.

    Это свойство animatable.

    Оператор импорта

    Objective C

    @import AVFoundation;

    Swift

    import AVFoundation

    Доступность

    Доступный в iOS 4.0 и позже.

  • orientation (iOS 6.0) Свойство

    Ориентация уровня.

    Оператор осуждения

    Использовать videoOrientation (AVCaptureConnection) вместо этого.

    Объявление

    Objective C

    @property(nonatomic) AVCaptureVideoOrientation orientation

    Обсуждение

    Изменения в ориентации не поддерживаются на всех аппаратных конфигурациях. Необходимо проверить значение supportsVideoOrientation (AVCaptureConnection) прежде, чем попытаться изменить ориентацию получателя. Если это требование проигнорировано, исключение повышено.

    Оператор импорта

    Objective C

    @import AVFoundation;

    Доступность

    Доступный в iOS 4.0 и позже.

    Осуждаемый в iOS 6.0.

    См. также

    orientationSupported

  • orientationSupported (iOS 6.0) Свойство

    Указывает ли поддержки дисплея уровня, изменяющие ориентацию. (только для чтения)

    Оператор осуждения

    Использовать supportsVideoOrientation (AVCaptureConnection) вместо этого.

    Объявление

    Objective C

    @property(nonatomic, readonly, getter=isOrientationSupported) BOOL orientationSupported

    Оператор импорта

    Objective C

    @import AVFoundation;

    Доступность

    Доступный в iOS 4.0 и позже.

    Осуждаемый в iOS 6.0.

    См. также

    ориентация

  • mirrored (iOS 6.0) Свойство

    Указывает, зеркально отражается ли дисплей уровня.

    Оператор осуждения

    Использовать videoMirrored (AVCaptureConnection) вместо этого.

    Объявление

    Objective C

    @property(nonatomic, getter=isMirrored) BOOL mirrored

    Обсуждение

    Изменить значение этого свойства, значение automaticallyAdjustsMirroring должен быть NOfalse.

    Зеркальное отражение не поддерживается на всех аппаратных конфигурациях. Необходимо проверить значение supportsVideoMirroring (AVCaptureConnection) прежде, чем попытаться изменить это значение.

    Оператор импорта

    Objective C

    @import AVFoundation;

    Доступность

    Доступный в iOS 4.0 и позже.

    Осуждаемый в iOS 6.0.

    См. также

    automaticallyAdjustsMirroring

  • mirroringSupported (iOS 6.0) Свойство

    Указывает, поддерживает ли дисплей уровня зеркальное отражение. (только для чтения)

    Оператор осуждения

    Использовать supportsVideoMirroring (AVCaptureConnection) вместо этого.

    Объявление

    Objective C

    @property(nonatomic, readonly, getter=isMirroringSupported) BOOL mirroringSupported

    Оператор импорта

    Objective C

    @import AVFoundation;

    Доступность

    Доступный в iOS 4.0 и позже.

    Осуждаемый в iOS 6.0.

    См. также

    зеркальный

  • automaticallyAdjustsMirroring (iOS 6.0) Свойство

    Указывает, корректирует ли дисплей уровня автоматически зеркальное отражение.

    Оператор осуждения

    Использовать automaticallyAdjustsVideoMirroring (AVCaptureConnection) вместо этого.

    Объявление

    Objective C

    @property(nonatomic) BOOL automaticallyAdjustsMirroring

    Обсуждение

    Для некоторых конфигураций сеанса предварительный просмотр будет зеркально отражен по умолчанию.

    Когда значение этого свойства YEStrue, значение mirrored может измениться в зависимости от конфигурации сеанса, например после переключения на различный ввод устройства захвата изображения.

    Оператор импорта

    Objective C

    @import AVFoundation;

    Доступность

    Доступный в iOS 4.0 и позже.

    Осуждаемый в iOS 6.0.

    См. также

    зеркальный
    mirroringSupported

Конфигурация
  • connection Свойство

    Соединение получения, описывающее AVCaptureInputPort с которым подключен уровень предварительного просмотра. (только для чтения)

    Объявление

    Swift

    var connection: AVCaptureConnection! { get }

    Objective C

    @property(nonatomic, readonly) AVCaptureConnection *connection

    Обсуждение

    Если Вы вызываете initWithSession:, layerWithSession:, или setSession: (см. session) с допустимым AVCaptureSession экземпляр, соединение формируется к первому приемлемому видео AVCaptureInput объект. Если уровень предварительного просмотра отсоединяется от сеанса, свойство соединения становится nil.

    Оператор импорта

    Objective C

    @import AVFoundation;

    Swift

    import AVFoundation

    Доступность

    Доступный в iOS 6.0 и позже.

  • session Свойство

    Предварительно просматриваемый экземпляр сеанса получения.

    Объявление

    Swift

    var session: AVCaptureSession!

    Objective C

    @property(nonatomic, retain) AVCaptureSession *session

    Оператор импорта

    Objective C

    @import AVFoundation;

    Swift

    import AVFoundation

    Доступность

    Доступный в iOS 4.0 и позже.

  • setSessionWithNoConnection (_:) - setSessionWithNoConnection:

    Присоединяет получатель к данному сеансу, неявно не формируя соединение.

    Объявление

    Swift

    func setSessionWithNoConnection(_ session: AVCaptureSession!)

    Objective C

    - (void)setSessionWithNoConnection:(AVCaptureSession *)session

    Параметры

    session

    Сеанс получения.

    Обсуждение

    Этот метод присоединяет получатель к данному сеансу, неявно не формируя соединение с первым приемлемым видео AVCaptureInputPort объект. Если Вы намереваетесь вручную сформировать соединение между желаемым, необходимо только использовать этот метод AVCaptureInputPort возразите и использование получателя addConnection:.

    Оператор импорта

    Objective C

    @import AVFoundation;

    Swift

    import AVFoundation

    Доступность

    Доступный в iOS 8.0 и позже.

Преобразование между системами координат
  • captureDevicePointOfInterestForPoint (_:) - captureDevicePointOfInterestForPoint:

    Преобразовывает точку от координат уровня до координатного пространства устройства захвата изображения.

    Объявление

    Swift

    func captureDevicePointOfInterestForPoint(_ pointInLayer: CGPoint) -> CGPoint

    Objective C

    - (CGPoint)captureDevicePointOfInterestForPoint:(CGPoint)pointInLayer

    Параметры

    pointInLayer

    Точка в системе координат этого расположенного на слое объекта. Координаты этой точки представляют пиксельные значения.

    Возвращаемое значение

    Скалярная точка, координаты которой относительно системы координат устройства захвата изображения, обеспечивающего ввод для уровня.

    Обсуждение

    Координаты в структуре точки, возвращенной этим методом, находятся в диапазоне 0.0 к 1,0. Точка (0.0, 0.0) соответствует верхнему левому углу неповернутого изображения, и точка (1.0, 1.0) представляет правый нижний угол неповернутого изображения.

    Преобразование, выполняемое этим методом, берет тип телосложения уровня и получатель videoGravity свойство в рассмотрение.

    Оператор импорта

    Objective C

    @import AVFoundation;

    Swift

    import AVFoundation

    Доступность

    Доступный в iOS 6.0 и позже.

  • pointForCaptureDevicePointOfInterest (_:) - pointForCaptureDevicePointOfInterest:

    Преобразовывает точку из координатного пространства устройства захвата изображения к координатному пространству уровня.

    Объявление

    Swift

    func pointForCaptureDevicePointOfInterest(_ captureDevicePointOfInterest: CGPoint) -> CGPoint

    Objective C

    - (CGPoint)pointForCaptureDevicePointOfInterest:(CGPoint)captureDevicePointOfInterest

    Параметры

    captureDevicePointOfInterest

    Скалярная точка, координаты которой относительно системы координат устройства захвата изображения, обеспечивающего ввод для уровня. Координаты в этой точке должны быть в диапазоне 0.0 к 1,0, где точка (0.0, 0.0) соответствует верхнему левому углу неповернутого изображения, и точка (1.0, 1.0) представляет правый нижний угол неповернутого изображения.

    Возвращаемое значение

    Точка в системе координат этого расположенного на слое объекта. Координаты этой точки представляют пиксельные значения.

    Обсуждение

    Преобразование, выполняемое этим методом, берет тип телосложения уровня и получатель videoGravity свойство в рассмотрение.

    Оператор импорта

    Objective C

    @import AVFoundation;

    Swift

    import AVFoundation

    Доступность

    Доступный в iOS 6.0 и позже.

  • transformedMetadataObjectForMetadataObject (_:) - transformedMetadataObjectForMetadataObject:

    Преобразовывает метаданные визуальные свойства объекта для разделения на уровни координат.

    Объявление

    Swift

    func transformedMetadataObjectForMetadataObject(_ metadataObject: AVMetadataObject!) -> AVMetadataObject!

    Objective C

    - (AVMetadataObject *)transformedMetadataObjectForMetadataObject:(AVMetadataObject *)metadataObject

    Параметры

    metadataObject

    Метаданные возражают, чьи визуальные свойства Вы хотите преобразовать. Объект метаданных должен произойти из того же AVCaptureInput как уровень предварительного просмотра.

    Возвращаемое значение

    Метаданные возражают, чьи визуальные свойства были преобразованы в координаты уровня, или nil если metadataObject происходит из входного источника кроме того из уровня предварительного просмотра.

    Обсуждение

    AVMetadataObjectграницы могут быть выражены как rect, где точка источника (0.0, 0.0) представляет верхний левый угол неповернутого изображения и (1.0, 1.0) представляет нижний правый угол неповернутого изображения. Объекты метаданных поверхности также выражают отклонение от курса и угол вращения относительно неповернутого изображения. Этот метод преобразовывает все визуальные свойства объекта метаданных к координатному пространству получателя, принимая во внимание ориентацию, зеркальное отражение, границы слоев и videoGravity.

    Оператор импорта

    Objective C

    @import AVFoundation;

    Swift

    import AVFoundation

    Доступность

    Доступный в iOS 6.0 и позже.

  • metadataOutputRectOfInterestForRect (_:) - metadataOutputRectOfInterestForRect:

    Преобразовывает прямоугольник в системе координат уровня предварительного просмотра одной в системе координат, используемой для выводов метаданных.

    Объявление

    Swift

    func metadataOutputRectOfInterestForRect(_ rectInLayerCoordinates: CGRect) -> CGRect

    Objective C

    - (CGRect)metadataOutputRectOfInterestForRect:(CGRect)rectInLayerCoordinates

    Параметры

    rectInLayerCoordinates

    Прямоугольник в AVCaptureVideoPreviewLayer система координат объекта.

    Возвращаемое значение

    Прямоугольник в AVCaptureMetadataOutput система координат.

    Обсуждение

    Представляющий интерес прямоугольник для AVCaptureMetadataOutput объект находится в системе координат, расширяющейся от (0,0) в верхнем левом к (1,1) в нижнем правом относительно естественной ориентации устройства. Выходной объект получения использует пиксельное координатное пространство, которое может масштабироваться, поворачиваться или зеркально отражаться. Используйте этот удобный метод быстро преобразовать между координатными пространствами.

    Оператор импорта

    Objective C

    @import AVFoundation;

    Swift

    import AVFoundation

    Доступность

    Доступный в iOS 7.0 и позже.

  • rectForMetadataOutputRectOfInterest (_:) - rectForMetadataOutputRectOfInterest:

    Преобразовывает прямоугольник в системе координат, привыкшей для выводов метаданных к одному в системе координат уровня предварительного просмотра.

    Объявление

    Swift

    func rectForMetadataOutputRectOfInterest(_ rectInMetadataOutputCoordinates: CGRect) -> CGRect

    Objective C

    - (CGRect)rectForMetadataOutputRectOfInterest:(CGRect)rectInMetadataOutputCoordinates

    Параметры

    rectInMetadataOutputCoordinates

    Прямоугольник в AVCaptureMetadataOutput система координат.

    Возвращаемое значение

    Прямоугольник в AVCaptureVideoPreviewLayer система координат объекта.

    Обсуждение

    Представляющий интерес прямоугольник для AVCaptureMetadataOutput объект находится в системе координат, расширяющейся от (0,0) в верхнем левом к (1,1) в нижнем правом относительно естественной ориентации устройства. Выходной объект получения использует пиксельное координатное пространство, которое может масштабироваться, поворачиваться или зеркально отражаться. Используйте этот удобный метод быстро преобразовать между координатными пространствами.

    Оператор импорта

    Objective C

    @import AVFoundation;

    Swift

    import AVFoundation

    Доступность

    Доступный в iOS 7.0 и позже.