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

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

Разработчик

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

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

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

AVCaptureDevice

AVCaptureDevice объект представляет физическое устройство захвата изображения и свойства, связанные с тем устройством. Вы используете устройство захвата изображения для конфигурирования свойств используемого оборудования. Устройство захвата изображения также предоставляет входные данные (такие как аудио или видео) к AVCaptureSession объект.

Вы используете методы AVCaptureDevice класс для перечисления доступных устройств запросите их возможности и будьте сообщены о том, когда устройства придут и уйдут. Прежде чем Вы попытаетесь установить свойства устройства захвата изображения (его режим фокуса, режим воздействия, и т.д.), необходимо сначала получить блокировку на устройстве с помощью lockForConfiguration: метод. Можно тогда установить свойства и выпустить блокировку с помощью unlockForConfiguration метод. Можно содержать блокировку, если Вы хотите, чтобы все устанавливаемые свойства устройства остались неизменными. Однако содержание блокировки устройства излишне может ухудшить качество получения в других приложениях, совместно использующих устройство, и не рекомендуется.

Наиболее распространенные конфигурации настроек получения доступны через AVCaptureSession возразите и его доступные предварительные установки; однако, некоторые специализированные опции (такие как высокая частота кадров) требуют непосредственно установки формата получения на AVCaptureDevice экземпляр. Следующий пример кода иллюстрирует, как выбрать максимально возможную частоту кадров устройства:

  • - (void)configureCameraForHighestFrameRate:(AVCaptureDevice *)device
  • {
  • AVCaptureDeviceFormat *bestFormat = nil;
  • AVFrameRateRange *bestFrameRateRange = nil;
  • for ( AVCaptureDeviceFormat *format in [device formats] ) {
  • for ( AVFrameRateRange *range in format.videoSupportedFrameRateRanges ) {
  • if ( range.maxFrameRate > bestFrameRateRange.maxFrameRate ) {
  • bestFormat = format;
  • bestFrameRateRange = range;
  • }
  • }
  • }
  • if ( bestFormat ) {
  • if ( [device lockForConfiguration:NULL] == YES ) {
  • device.activeFormat = bestFormat;
  • device.activeVideoMinFrameDuration = bestFrameRateRange.minFrameDuration;
  • device.activeVideoMaxFrameDuration = bestFrameRateRange.minFrameDuration;
  • [device unlockForConfiguration];
  • }
  • }
  • }

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


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


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


Swift

import AVFoundation

Objective C

@import AVFoundation;

Доступность


Доступный в OS X v10.7 и позже.
  • Возвращает массив доступных устройств захвата изображения в системе.

    Объявление

    Swift

    class func devices() -> [AnyObject]!

    Objective C

    + (NSArray *)devices

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

    Массив, содержащий доступные устройства захвата изображения в системе

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

    Objective C

    @import AVFoundation;

    Swift

    import AVFoundation

    Доступность

    Доступный в OS X v10.7 и позже.

  • Возвращает устройство с данным ID.

    Объявление

    Swift

    init!(uniqueID deviceUniqueID: String!) -> AVCaptureDevice

    Objective C

    + (AVCaptureDevice *)deviceWithUniqueID:(NSString *)deviceUniqueID

    Параметры

    deviceUniqueID

    ID устройства захвата изображения.

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

    Устройство с ID deviceUniqueID.

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

    Objective C

    @import AVFoundation;

    Swift

    import AVFoundation

    Доступность

    Доступный в OS X v10.7 и позже.

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

    Объявление

    Swift

    class func defaultDeviceWithMediaType(_ mediaType: String!) -> AVCaptureDevice!

    Objective C

    + (AVCaptureDevice *)defaultDeviceWithMediaType:(NSString *)mediaType

    Параметры

    mediaType

    Идентификатор типа среды.

    Для возможных значений см. Ссылку Констант Основы AV.

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

    Устройство по умолчанию раньше получало данные типа, обозначенного mediaType.

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

    Objective C

    @import AVFoundation;

    Swift

    import AVFoundation

    Доступность

    Доступный в OS X v10.7 и позже.

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

    Объявление

    Swift

    class func devicesWithMediaType(_ mediaType: String!) -> [AnyObject]!

    Objective C

    + (NSArray *)devicesWithMediaType:(NSString *)mediaType

    Параметры

    mediaType

    Идентификатор типа среды.

    Для возможных значений см. Ссылку Констант Основы AV.

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

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

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

    Objective C

    @import AVFoundation;

    Swift

    import AVFoundation

    Доступность

    Доступный в OS X v10.7 и позже.

  • Запрашивает эксклюзивный доступ к аппаратным свойствам устройства.

    Объявление

    Swift

    func lockForConfiguration(_ outError: NSErrorPointer) -> Bool

    Objective C

    - (BOOL)lockForConfiguration:(NSError **)outError

    Параметры

    outError

    На вводе укажите указатель на ошибочный объект. Если блокировка не может быть получена, этот указатель содержит NSError объект, описывающий проблему. Можно указать nil для этого свойства.

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

    YEStrue если блокировка была получена или NOfalse если это не было.

    Обсуждение

    Необходимо вызвать этот метод прежде, чем попытаться сконфигурировать связанные с аппаратными средствами свойства устройства. Этот метод возвраты YEStrue когда это успешно блокирует устройство для конфигурации Вашим кодом. После конфигурирования свойств устройства вызвать unlockForConfiguration выпустить блокировку конфигурации и позволить другим приложениям вносить изменения.

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

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

    Objective C

    @import AVFoundation;

    Swift

    import AVFoundation

    Доступность

    Доступный в OS X v10.7 и позже.

    См. также

    – unlockForConfiguration

  • Оставляет монопольное управление конфигурацией устройства.

    Объявление

    Swift

    func unlockForConfiguration()

    Objective C

    - (void)unlockForConfiguration

    Обсуждение

    Вызовите этот метод для выпуска полученного использования блокировки lockForConfiguration: метод, когда Вы сделаны, конфигурируя устройство.

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

    Objective C

    @import AVFoundation;

    Swift

    import AVFoundation

    Доступность

    Доступный в OS X v10.7 и позже.

    См. также

    – lockForConfiguration:

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

    Объявление

    Swift

    var suspended: Bool { get }

    Objective C

    @property(nonatomic, readonly, getter=isSuspended) BOOL suspended

    Обсуждение

    Некоторые устройства запрещают сбор данных вследствие функции на устройстве.

    Например, isSuspended возвраты YEStrue для внешней iSight камеры, когда ее ирисовая диафрагма конфиденциальности закрывается, или для внутренней iSight камеры на ноутбуке, когда закрывается дисплей ноутбука.

    Можно наблюдать изменения в значении этого свойства с помощью наблюдения Значения ключа.

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

    Objective C

    @import AVFoundation;

    Swift

    import AVFoundation

    Доступность

    Доступный в OS X v10.7 и позже.

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

    Объявление

    Swift

    var inUseByAnotherApplication: Bool { get }

    Objective C

    @property(nonatomic, readonly, getter=isInUseByAnotherApplication) BOOL inUseByAnotherApplication

    Обсуждение

    Можно наблюдать изменения в значении этого свойства с помощью наблюдения Значения ключа.

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

    Objective C

    @import AVFoundation;

    Swift

    import AVFoundation

    Доступность

    Доступный в OS X v10.7 и позже.

  • inputSources inputSources Свойство

    Массив AVCaptureDeviceInputSource объекты, представляющие входные источники, поддерживаются устройством. (только для чтения)

    Объявление

    Swift

    var inputSources: [AnyObject]! { get }

    Objective C

    @property(nonatomic, readonly) NSArray *inputSources

    Обсуждение

    Некоторые устройства могут получить данные от одного из многократных источников данных (различные входные разъемы на том же аудиоустройстве, например). Для устройств с многократными возможными источниками данных можно использовать это свойство для перечисления возможного выбора.

    Можно наблюдать изменения в значении этого свойства с помощью наблюдения Значения ключа.

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

    Objective C

    @import AVFoundation;

    Swift

    import AVFoundation

    Доступность

    Доступный в OS X v10.7 и позже.

  • В настоящее время активный входной источник.

    Объявление

    Swift

    var activeInputSource: AVCaptureDeviceInputSource!

    Objective C

    @property(nonatomic, retain) AVCaptureDeviceInputSource *activeInputSource

    Обсуждение

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

    Для установки формата необходимо сначала получить эксклюзивный доступ к использованию получателя lockForConfiguration:. Если Вы не получаете эксклюзивный доступ, setActiveInputSource: броски NSGenericException.

    Метод установки, setActiveInputSource:, броски NSInvalidArgumentException если Вы передаете формат, не существующий в formats массив.

    Можно наблюдать изменения в значении этого свойства с помощью наблюдения Значения ключа.

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

    Objective C

    @import AVFoundation;

    Swift

    import AVFoundation

    Доступность

    Доступный в OS X v10.7 и позже.

    См. также

    activeInputSource

  • linkedDevices linkedDevices Свойство

    Массив AVCaptureDevice объекты, представляющие устройства, физически соединенные с получателем. (только для чтения)

    Объявление

    Swift

    var linkedDevices: [AnyObject]! { get }

    Objective C

    @property(nonatomic, readonly) NSArray *linkedDevices

    Обсуждение

    Значение этого свойства является массивом AVCaptureDevice объекты, которые являются частью того же физического устройства как получатель. Например, для внешней iSight камеры, массив содержит AVCaptureDevice экземпляр, представляющий внешний iSight микрофон.

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

    Objective C

    @import AVFoundation;

    Swift

    import AVFoundation

    Доступность

    Доступный в OS X v10.7 и позже.

  • transportType transportType Свойство

    Тип передачи получателя. (только для чтения)

    Объявление

    Swift

    var transportType: Int32 { get }

    Objective C

    @property(nonatomic, readonly) int32_t transportType

    Обсуждение

    Значение этого свойства представляет тип передачи устройства (USB, PCI, и т.д.). Типы передачи определяются в <IOKit/audio/IOAudioTypes.h> как kIOAudioDeviceTransportType*.

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

    Objective C

    @import AVFoundation;

    Swift

    import AVFoundation

    Доступность

    Доступный в OS X v10.7 и позже.

  • форматы форматы Свойство

    Массив AVCaptureDeviceFormat объекты, представляющие форматы, поддерживаемые устройством (только для чтения)

    Объявление

    Swift

    var formats: [AnyObject]! { get }

    Objective C

    @property(nonatomic, readonly) NSArray *formats

    Обсуждение

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

    Можно установить activeFormat к любому из форматов в этом массиве.

    Можно наблюдать изменения в значении этого свойства с помощью наблюдения Значения ключа.

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

    Objective C

    @import AVFoundation;

    Swift

    import AVFoundation

    Доступность

    Доступный в OS X v10.7 и позже.

    См. также

    activeFormat

  • activeFormat activeFormat Свойство

    В настоящее время активный формат получателя.

    Объявление

    Swift

    var activeFormat: AVCaptureDeviceFormat!

    Objective C

    @property(nonatomic, retain) AVCaptureDeviceFormat *activeFormat

    Обсуждение

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

    На iOS необходимо обычно устанавливать предварительную установку сеанса на AVCaptureSession объект сконфигурировать захват изображения или видеосъемку и использовать совместно используемое AVAudioSession объект сконфигурировать аудио получение. При использовании предварительной установки сеанса сеанс автоматически управляет активным форматом устройства захвата изображения. Однако некоторые специализированные опции получения (такие как высокая частота кадров) не доступны в предварительных установках сеанса. Для этих опций можно установить активный формат устройства захвата изображения вместо этого. Выполнение так изменяет связанную предварительную установку сеанса получения на AVCaptureSessionPresetInputPriority.

    Попытка установить активный формат в один не существующий в formats выстройте бросает NSInvalidArgumentException.

    Прежде, чем изменить значение этого свойства, необходимо вызвать lockForConfiguration: получать эксклюзивный доступ к свойствам конфигурации устройства. Иначе, установка значения этого свойства повышает исключение. Когда Вы будете сделаны, конфигурируя устройство, вызвать unlockForConfiguration выпустить блокировку и позволить другим устройствам конфигурировать настройки. Необходимо также вызвать lockForConfiguration: прежде, чем вызвать AVCaptureSession метод startRunning, или предварительная установка сеанса переопределит выбранный активный формат на устройстве захвата изображения.

    Можно наблюдать изменения в значении этого свойства с помощью наблюдения значения ключа.

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

    Objective C

    @import AVFoundation;

    Swift

    import AVFoundation

    Доступность

    Доступный в OS X v10.7 и позже.

  • focusMode focusMode Свойство

    Режим фокуса устройства.

    Объявление

    Swift

    var focusMode: AVCaptureFocusMode

    Objective C

    @property(nonatomic) AVCaptureFocusMode focusMode

    Обсуждение

    Прежде, чем изменить значение этого свойства, необходимо вызвать lockForConfiguration: получать эксклюзивный доступ к свойствам конфигурации устройства. Иначе, установка значения этого свойства повышает исключение. Когда Вы будете сделаны, конфигурируя устройство, вызвать unlockForConfiguration выпустить блокировку и позволить другим устройствам конфигурировать настройки.

    Можно наблюдать изменения в значении этого свойства с помощью наблюдения Значения ключа.

    Посмотрите AVCaptureFocusMode для возможных значений.

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

    Objective C

    @import AVFoundation;

    Swift

    import AVFoundation

    Доступность

    Доступный в OS X v10.7 и позже.

  • Возвращает булево значение, указывающее, поддерживается ли данный режим фокуса.

    Объявление

    Swift

    func isFocusModeSupported(_ focusMode: AVCaptureFocusMode) -> Bool

    Objective C

    - (BOOL)isFocusModeSupported:(AVCaptureFocusMode)focusMode

    Параметры

    focusMode

    Режим фокуса. Посмотрите AVCaptureFocusMode для возможных значений.

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

    YEStrue если focusMode поддерживается, иначе NOfalse.

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

    Objective C

    @import AVFoundation;

    Swift

    import AVFoundation

    Доступность

    Доступный в OS X v10.7 и позже.

  • Интересное место для фокусировки.

    Объявление

    Swift

    var focusPointOfInterest: CGPoint

    Objective C

    @property(nonatomic) CGPoint focusPointOfInterest

    Обсуждение

    Это свойство представляет a CGPoint где {0,0} соответствует верхней левой из области изображения, и {1,1} соответствует нижнему правому в альбомном режиме с кнопкой «Домой» справа — это применяется, даже если устройство находится в режиме портрета.

    Прежде, чем изменить значение этого свойства, необходимо вызвать lockForConfiguration: получать эксклюзивный доступ к свойствам конфигурации устройства. Иначе, установка значения этого свойства повышает исключение. Когда Вы будете сделаны, конфигурируя устройство, вызвать unlockForConfiguration выпустить блокировку и позволить другим устройствам конфигурировать настройки.

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

    Objective C

    @import AVFoundation;

    Swift

    import AVFoundation

    Доступность

    Доступный в OS X v10.7 и позже.

    См. также

    exposurePointOfInterest

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

    Объявление

    Swift

    var focusPointOfInterestSupported: Bool { get }

    Objective C

    @property(nonatomic, readonly, getter=isFocusPointOfInterestSupported) BOOL focusPointOfInterestSupported

    Обсуждение

    Можно наблюдать изменения в значении этого свойства с помощью наблюдения значения ключа.

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

    Objective C

    @import AVFoundation;

    Swift

    import AVFoundation

    Доступность

    Доступный в OS X v10.7 и позже.

  • adjustingFocus adjustingFocus Свойство

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

    Объявление

    Swift

    var adjustingFocus: Bool { get }

    Objective C

    @property(nonatomic, readonly, getter=isAdjustingFocus) BOOL adjustingFocus

    Обсуждение

    Можно наблюдать изменения в значении этого свойства с помощью наблюдения значения ключа.

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

    Objective C

    @import AVFoundation;

    Swift

    import AVFoundation

    Доступность

    Доступный в OS X v10.7 и позже.

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

    Объявление

    Swift

    var adjustingExposure: Bool { get }

    Objective C

    @property(nonatomic, readonly, getter=isAdjustingExposure) BOOL adjustingExposure

    Обсуждение

    Можно наблюдать изменения в значении этого свойства с помощью наблюдения значения ключа.

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

    Objective C

    @import AVFoundation;

    Swift

    import AVFoundation

    Доступность

    Доступный в OS X v10.7 и позже.

  • exposureMode exposureMode Свойство

    Режим воздействия для устройства.

    Объявление

    Swift

    var exposureMode: AVCaptureExposureMode

    Objective C

    @property(nonatomic) AVCaptureExposureMode exposureMode

    Обсуждение

    Прежде, чем изменить значение этого свойства, необходимо вызвать lockForConfiguration: получать эксклюзивный доступ к свойствам конфигурации устройства. Иначе, установка значения этого свойства повышает исключение. Когда Вы будете сделаны, конфигурируя устройство, вызвать unlockForConfiguration выпустить блокировку и позволить другим устройствам конфигурировать настройки.

    Можно наблюдать изменения в значении этого свойства с помощью наблюдения Значения ключа.

    Посмотрите AVCaptureExposureMode для возможных значений.

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

    Objective C

    @import AVFoundation;

    Swift

    import AVFoundation

    Доступность

    Доступный в OS X v10.7 и позже.

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

    Объявление

    Swift

    func isExposureModeSupported(_ exposureMode: AVCaptureExposureMode) -> Bool

    Objective C

    - (BOOL)isExposureModeSupported:(AVCaptureExposureMode)exposureMode

    Параметры

    exposureMode

    Режим воздействия. Посмотрите AVCaptureExposureMode для возможных значений.

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

    YEStrue если exposureMode поддерживается, иначе NOfalse.

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

    Objective C

    @import AVFoundation;

    Swift

    import AVFoundation

    Доступность

    Доступный в OS X v10.7 и позже.

  • Интересное место для воздействия.

    Объявление

    Swift

    var exposurePointOfInterest: CGPoint

    Objective C

    @property(nonatomic) CGPoint exposurePointOfInterest

    Обсуждение

    Прежде, чем изменить значение этого свойства, необходимо вызвать lockForConfiguration: получать эксклюзивный доступ к свойствам конфигурации устройства. Иначе, установка значения этого свойства повышает исключение. Когда Вы будете сделаны, конфигурируя устройство, вызвать unlockForConfiguration выпустить блокировку и позволить другим устройствам конфигурировать настройки.

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

    Objective C

    @import AVFoundation;

    Swift

    import AVFoundation

    Доступность

    Доступный в OS X v10.7 и позже.

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

    Объявление

    Swift

    var exposurePointOfInterestSupported: Bool { get }

    Objective C

    @property(nonatomic, readonly, getter=isExposurePointOfInterestSupported) BOOL exposurePointOfInterestSupported

    Обсуждение

    Можно наблюдать изменения в значении этого свойства с помощью наблюдения значения ключа.

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

    Objective C

    @import AVFoundation;

    Swift

    import AVFoundation

    Доступность

    Доступный в OS X v10.7 и позже.

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

    Объявление

    Swift

    func isWhiteBalanceModeSupported(_ whiteBalanceMode: AVCaptureWhiteBalanceMode) -> Bool

    Objective C

    - (BOOL)isWhiteBalanceModeSupported:(AVCaptureWhiteBalanceMode)whiteBalanceMode

    Параметры

    whiteBalanceMode

    Режим фокуса. Посмотрите AVCaptureWhiteBalanceMode для возможных значений.

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

    YEStrue если whiteBalanceMode поддерживается, иначе NOfalse.

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

    Objective C

    @import AVFoundation;

    Swift

    import AVFoundation

    Доступность

    Доступный в OS X v10.7 и позже.

    См. также

    связанный

  • Текущий режим баланса белого.

    Объявление

    Swift

    var whiteBalanceMode: AVCaptureWhiteBalanceMode

    Objective C

    @property(nonatomic) AVCaptureWhiteBalanceMode whiteBalanceMode

    Обсуждение

    Прежде, чем изменить значение этого свойства, необходимо вызвать lockForConfiguration: получать эксклюзивный доступ к свойствам конфигурации устройства. Иначе, установка значения этого свойства повышает исключение. Когда Вы будете сделаны, конфигурируя устройство, вызвать unlockForConfiguration выпустить блокировку и позволить другим устройствам конфигурировать настройки.

    Можно наблюдать изменения в значении этого свойства с помощью наблюдения значения ключа.

    Посмотрите AVCaptureWhiteBalanceMode для возможных значений.

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

    Objective C

    @import AVFoundation;

    Swift

    import AVFoundation

    Доступность

    Доступный в OS X v10.7 и позже.

  • Указывает, корректирует ли завещанное имущество в настоящее время баланс белого. (только для чтения)

    Объявление

    Swift

    var adjustingWhiteBalance: Bool { get }

    Objective C

    @property(nonatomic, readonly, getter=isAdjustingWhiteBalance) BOOL adjustingWhiteBalance

    Обсуждение

    Можно наблюдать изменения в значении этого свойства с помощью наблюдения значения ключа.

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

    Objective C

    @import AVFoundation;

    Swift

    import AVFoundation

    Доступность

    Доступный в OS X v10.7 и позже.

  • hasFlash hasFlash Свойство

    Указывает, имеет ли устройство захвата изображения флэш-память. (только для чтения)

    Объявление

    Swift

    var hasFlash: Bool { get }

    Objective C

    @property(nonatomic, readonly) BOOL hasFlash

    Обсуждение

    Можно наблюдать изменения в значении этого свойства с помощью наблюдения значения ключа.

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

    Objective C

    @import AVFoundation;

    Swift

    import AVFoundation

    Доступность

    Доступный в OS X v10.7 и позже.

  • flashMode flashMode Свойство

    Текущий режим флэш-памяти.

    Объявление

    Swift

    var flashMode: AVCaptureFlashMode

    Objective C

    @property(nonatomic) AVCaptureFlashMode flashMode

    Обсуждение

    Прежде, чем изменить значение этого свойства, необходимо вызвать lockForConfiguration: получать эксклюзивный доступ к свойствам конфигурации устройства. Иначе, установка значения этого свойства повышает исключение. Когда Вы будете сделаны, конфигурируя устройство, вызвать unlockForConfiguration выпустить блокировку и позволить другим устройствам конфигурировать настройки.

    Можно наблюдать изменения в значении этого свойства с помощью наблюдения значения ключа.

    Посмотрите AVCaptureFlashMode для возможных значений.

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

    Objective C

    @import AVFoundation;

    Swift

    import AVFoundation

    Доступность

    Доступный в OS X v10.7 и позже.

  • Возвращает булево значение, указывающее, поддерживается ли данный режим флэш-памяти.

    Объявление

    Swift

    func isFlashModeSupported(_ flashMode: AVCaptureFlashMode) -> Bool

    Objective C

    - (BOOL)isFlashModeSupported:(AVCaptureFlashMode)flashMode

    Параметры

    flashMode

    Режим флэш-памяти. Посмотрите AVCaptureFlashMode для возможных значений.

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

    YEStrue если flashMode поддерживается, иначе NOfalse.

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

    Objective C

    @import AVFoundation;

    Swift

    import AVFoundation

    Доступность

    Доступный в OS X v10.7 и позже.

    См. также

    hasFlash
    flashMode

  • hasTorch hasTorch Свойство

    Булево значение, указывающее, имеет ли устройство захвата изображения факел. (только для чтения)

    Объявление

    Swift

    var hasTorch: Bool { get }

    Objective C

    @property(nonatomic, readonly) BOOL hasTorch

    Обсуждение

    Факел является источником света, таким как флэш-память LED, которая доступна на устройстве и используемая для освещения полученного содержания или обеспечения общего освещения. Это свойство отражается, имеет ли текущее устройство такие встроенные аппаратные средства освещения.

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

    Можно наблюдать изменения в значении этого свойства с помощью наблюдения значения ключа.

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

    Objective C

    @import AVFoundation;

    Swift

    import AVFoundation

    Доступность

    Доступный в OS X v10.7 и позже.

    См. также

    torchMode

  • Возвращает булево значение, указывающее, поддерживает ли устройство указанный режим факела.

    Объявление

    Swift

    func isTorchModeSupported(_ torchMode: AVCaptureTorchMode) -> Bool

    Objective C

    - (BOOL)isTorchModeSupported:(AVCaptureTorchMode)torchMode

    Параметры

    torchMode

    Желаемый режим факела. Для списка возможных значений посмотрите AVCaptureTorchMode.

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

    YEStrue если torchMode поддерживается, иначе NOfalse.

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

    Objective C

    @import AVFoundation;

    Swift

    import AVFoundation

    Доступность

    Доступный в OS X v10.7 и позже.

    См. также

    torchMode

  • torchMode torchMode Свойство

    Текущий режим факела.

    Объявление

    Swift

    var torchMode: AVCaptureTorchMode

    Objective C

    @property(nonatomic) AVCaptureTorchMode torchMode

    Обсуждение

    Установка значения этого свойства также устанавливает уровень факела в свое значение максимального тока.

    Прежде, чем установить значение этого свойства, вызовите isTorchModeSupported: метод для проверки устройства поддерживает желаемый режим. Установка устройства к неподдерживаемому режиму факела приводит к повышению исключения. Для списка возможных значений для этого свойства посмотрите AVCaptureTorchMode.

    Прежде, чем изменить значение этого свойства, необходимо вызвать lockForConfiguration: получать эксклюзивный доступ к свойствам конфигурации устройства. Иначе, установка значения этого свойства повышает исключение. Когда Вы будете сделаны, конфигурируя устройство, вызвать unlockForConfiguration выпустить блокировку и позволить другим устройствам конфигурировать настройки.

    Можно наблюдать изменения в значении этого свойства с помощью наблюдения значения ключа.

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

    Objective C

    @import AVFoundation;

    Swift

    import AVFoundation

    Доступность

    Доступный в OS X v10.7 и позже.

    См. также

    – isTorchModeSupported:

  • В настоящее время активная минимальная продолжительность кадра.

    Объявление

    Swift

    var activeVideoMinFrameDuration: CMTime

    Objective C

    @property(nonatomic) CMTime activeVideoMinFrameDuration

    Обсуждение

    Минимальная продолжительность кадра устройства является обратной величиной своей максимальной частоты кадров. Можно установить значение этого свойства для ограничения максимальной частоты кадров во время сеанса получения. Устройство захвата изображения автоматически выбирает минимальную продолжительность кадра по умолчанию на основе своего активного формата. После изменения значения этого свойства можно возвратиться к минимальной продолжительности кадра по умолчанию путем установки значения этого свойства в kCMTimeInvalid. Выбор новой предварительной установки для сеанса получения также сбрасывает это свойство к своему значению по умолчанию.

    Попытка установить это свойство в значение, не найденное в активном формате videoSupportedFrameRateRanges выстройте повышает исключение (NSInvalidArgumentException).

    Прежде, чем изменить значение этого свойства, необходимо вызвать lockForConfiguration: получать эксклюзивный доступ к свойствам конфигурации устройства. Иначе, установка значения этого свойства повышает исключение. Когда Вы будете сделаны, конфигурируя устройство, вызвать unlockForConfiguration выпустить блокировку и позволить другим устройствам конфигурировать настройки.

    Можно наблюдать изменения в значении этого свойства с помощью наблюдения значения ключа.

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

    Objective C

    @import AVFoundation;

    Swift

    import AVFoundation

    Доступность

    Доступный в OS X v10.7 и позже.

    См. также

    activeFormat

  • В настоящее время активная максимальная продолжительность кадра

    Объявление

    Swift

    var activeVideoMaxFrameDuration: CMTime

    Objective C

    @property(nonatomic) CMTime activeVideoMaxFrameDuration

    Обсуждение

    Максимальная продолжительность кадра устройства является обратной величиной своей минимальной частоты кадров. Можно установить значение этого свойства для ограничения минимальной частоты кадров во время сеанса получения. Устройство захвата изображения автоматически выбирает максимальную продолжительность кадра по умолчанию на основе своего активного формата. После изменения значения этого свойства можно возвратиться к максимальной продолжительности кадра по умолчанию путем установки значения этого свойства в kCMTimeInvalid. Выбор новой предварительной установки для сеанса получения также сбрасывает это свойство к своему значению по умолчанию.

    Попытка установить это свойство в значение, не найденное в активном формате videoSupportedFrameRateRanges выстройте повышает исключение (NSInvalidArgumentException).

    Прежде, чем изменить значение этого свойства, необходимо вызвать lockForConfiguration: получать эксклюзивный доступ к свойствам конфигурации устройства. Иначе, установка значения этого свойства повышает исключение. Когда Вы будете сделаны, конфигурируя устройство, вызвать unlockForConfiguration выпустить блокировку и позволить другим устройствам конфигурировать настройки.

    Можно наблюдать изменения в значении этого свойства с помощью наблюдения значения ключа.

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

    Objective C

    @import AVFoundation;

    Swift

    import AVFoundation

    Доступность

    Доступный в OS X v10.9 и позже.

    См. также

    activeFormat

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

    Объявление

    Swift

    var transportControlsSupported: Bool { get }

    Objective C

    @property(nonatomic, readonly) BOOL transportControlsSupported

    Обсуждение

    Для устройств с управлением передачей, таким как AVC основанные на ленте видеокамеры или про устройства захвата изображения с управлением декой RS422, значение этого свойства YEStrue. Если управление передачей не поддерживается, ни один из связанных методов управления передачей и свойств не доступен на получателе.

    Можно наблюдать изменения в значении этого свойства с помощью наблюдения значения ключа.

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

    Objective C

    @import AVFoundation;

    Swift

    import AVFoundation

    Доступность

    Доступный в OS X v10.7 и позже.

  • Текущий режим воспроизведения. (только для чтения)

    Объявление

    Swift

    var transportControlsPlaybackMode: AVCaptureDeviceTransportControlsPlaybackMode { get }

    Objective C

    @property(nonatomic, readonly) AVCaptureDeviceTransportControlsPlaybackMode transportControlsPlaybackMode

    Обсуждение

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

    Можно наблюдать изменения в значении этого свойства с помощью наблюдения значения ключа.

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

    Objective C

    @import AVFoundation;

    Swift

    import AVFoundation

    Доступность

    Доступный в OS X v10.7 и позже.

    См. также

    transportControlsSupported

  • Текущая скорость воспроизведения. (только для чтения)

    Объявление

    Swift

    var transportControlsSpeed: AVCaptureDeviceTransportControlsSpeed { get }

    Objective C

    @property(nonatomic, readonly) AVCaptureDeviceTransportControlsSpeed transportControlsSpeed

    Обсуждение

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

    Значение

    Значение

    0.0

    Остановленный

    1.0

    Передайте в нормальной скорости.

    - 1.0

    Реверс в нормальной скорости.

    2.0

    Передайте в 2x нормальная скорость.

    Можно наблюдать изменения в значении этого свойства с помощью наблюдения значения ключа.

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

    Objective C

    @import AVFoundation;

    Swift

    import AVFoundation

    Доступность

    Доступный в OS X v10.7 и позже.

    См. также

    transportControlsSupported

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

    Объявление

    Swift

    func setTransportControlsPlaybackMode(_ mode: AVCaptureDeviceTransportControlsPlaybackMode, speed speed: AVCaptureDeviceTransportControlsSpeed)

    Objective C

    - (void)setTransportControlsPlaybackMode:(AVCaptureDeviceTransportControlsPlaybackMode)mode speed:(AVCaptureDeviceTransportControlsSpeed)speed

    Параметры

    mode

    AVCaptureDeviceTransportControlsPlaybackMode постоянное указание, должна ли дека быть помещена в режим воспроизведения.

    speed

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

    Обсуждение

    Прежде, чем изменить значение этого свойства, необходимо вызвать lockForConfiguration: получать эксклюзивный доступ к свойствам конфигурации устройства. Иначе, вызов этого метода повышает исключение. Когда Вы будете сделаны, конфигурируя устройство, вызвать unlockForConfiguration выпустить блокировку и позволить другим устройствам конфигурировать настройки.

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

    Objective C

    @import AVFoundation;

    Swift

    import AVFoundation

    Доступность

    Доступный в OS X v10.7 и позже.

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

    Объявление

    Swift

    var connected: Bool { get }

    Objective C

    @property(nonatomic, readonly, getter=isConnected) BOOL connected

    Обсуждение

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

    Можно наблюдать изменения в значении этого свойства с помощью наблюдения значения ключа.

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

    Objective C

    @import AVFoundation;

    Swift

    import AVFoundation

    Доступность

    Доступный в OS X v10.7 и позже.

  • позиция позиция Свойство

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

    Объявление

    Swift

    var position: AVCaptureDevicePosition { get }

    Objective C

    @property(nonatomic, readonly) AVCaptureDevicePosition position

    Обсуждение

    Можно наблюдать изменения в значении этого свойства с помощью наблюдения значения ключа.

    Посмотрите AVCaptureDevicePosition для возможных значений.

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

    Objective C

    @import AVFoundation;

    Swift

    import AVFoundation

    Доступность

    Доступный в OS X v10.7 и позже.

  • Возвращает булево значение, указывающее, предоставляет ли устройство носителям данный тип.

    Объявление

    Swift

    func hasMediaType(_ mediaType: String!) -> Bool

    Objective C

    - (BOOL)hasMediaType:(NSString *)mediaType

    Параметры

    mediaType

    Тип среды, такой как AVMediaTypeVideo, AVMediaTypeAudio, или AVMediaTypeMuxed. Для полного списка поддерживаемых констант типа среды см. Ссылку Констант Основы AV.

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

    YES, если устройство обеспечивает носители типа mediaType, иначе NOfalse.

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

    Objective C

    @import AVFoundation;

    Swift

    import AVFoundation

    Доступность

    Доступный в OS X v10.7 и позже.

  • ID модели устройства. (только для чтения)

    Объявление

    Swift

    var modelID: String! { get }

    Objective C

    @property(nonatomic, readonly) NSString *modelID

    Обсуждение

    Значение этого свойства является идентификатором, уникальным для всех устройств той же модели. Значение является персистентным через подключения устройства и разъединения, и через различные системы. Например, ID модели камеры, встроенной к двум идентичным моделям iPhone, будет тем же даже при том, что они - различные физические устройства.

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

    Objective C

    @import AVFoundation;

    Swift

    import AVFoundation

    Доступность

    Доступный в OS X v10.7 и позже.

  • localizedName localizedName Свойство

    Локализованное человекочитаемое имя для получателя. (только для чтения)

    Объявление

    Swift

    var localizedName: String! { get }

    Objective C

    @property(nonatomic, readonly) NSString *localizedName

    Обсуждение

    Можно использовать это свойство для отображения имени устройства захвата изображения в пользовательском интерфейсе.

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

    Objective C

    @import AVFoundation;

    Swift

    import AVFoundation

    Доступность

    Доступный в OS X v10.7 и позже.

  • uniqueID uniqueID Свойство

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

    Объявление

    Swift

    var uniqueID: String! { get }

    Objective C

    @property(nonatomic, readonly) NSString *uniqueID

    Обсуждение

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

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

    Objective C

    @import AVFoundation;

    Swift

    import AVFoundation

    Доступность

    Доступный в OS X v10.7 и позже.

    См. также

    hasTorch

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

    Объявление

    Swift

    func supportsAVCaptureSessionPreset(_ preset: String!) -> Bool

    Objective C

    - (BOOL)supportsAVCaptureSessionPreset:(NSString *)preset

    Параметры

    preset

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

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

    YEStrue если получатель может использоваться с preset, иначе NOfalse.

    Обсуждение

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

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

    Objective C

    @import AVFoundation;

    Swift

    import AVFoundation

    Доступность

    Доступный в OS X v10.7 и позже.

Типы данных

  • Константа, использующаяся для указания скорости управления передачей.

    Объявление

    Swift

    typealias AVCaptureDeviceTransportControlsSpeed = Float

    Objective C

    typedef float AVCaptureDeviceTransportControlsSpeed;

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

    Objective C

    @import AVFoundation;

    Swift

    import AVFoundation

    Доступность

    Доступный в OS X v10.7 и позже.

  • Константы для указания позиции устройства захвата изображения.

    Объявление

    Swift

    enum AVCaptureDevicePosition : Int { case Unspecified case Back case Front }

    Objective C

    enum { AVCaptureDevicePositionUnspecified = 0, AVCaptureDevicePositionBack = 1, AVCaptureDevicePositionFront = 2 }; typedef NSInteger AVCaptureDevicePosition;

    Константы

    • Unspecified

      AVCaptureDevicePositionUnspecified

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

      Доступный в OS X v10.7 и позже.

    • Back

      AVCaptureDevicePositionBack

      Устройство захвата изображения в конце модуля.

      Доступный в OS X v10.7 и позже.

    • Front

      AVCaptureDevicePositionFront

      Устройство захвата изображения находится на передней стороне модуля.

      Доступный в OS X v10.7 и позже.

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

    Objective C

    @import AVFoundation;

    Swift

    import AVFoundation

    Доступность

    Доступный в OS X v10.7 и позже.

  • Константы для указания режима флэш-памяти устройства захвата изображения.

    Объявление

    Swift

    enum AVCaptureFlashMode : Int { case Off case On case Auto }

    Objective C

    typedef enum : NSInteger { AVCaptureFlashModeOff = 0, AVCaptureFlashModeOn = 1, AVCaptureFlashModeAuto = 2 } AVCaptureFlashMode;

    Константы

    • Off

      AVCaptureFlashModeOff

      Флэш-память устройства захвата изображения всегда выключена.

      Доступный в OS X v10.7 и позже.

    • On

      AVCaptureFlashModeOn

      Флэш-память устройства захвата изображения всегда включена.

      Доступный в OS X v10.7 и позже.

    • Auto

      AVCaptureFlashModeAuto

      Устройство захвата изображения постоянно контролирует легкие уровни и использует флэш-память при необходимости.

      Доступный в OS X v10.7 и позже.

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

    Objective C

    @import AVFoundation;

    Swift

    import AVFoundation

    Доступность

    Доступный в OS X v10.7 и позже.

  • Константы для указания режима факела устройства захвата изображения.

    Объявление

    Swift

    enum AVCaptureTorchMode : Int { case Off case On case Auto }

    Objective C

    typedef enum : NSInteger { AVCaptureTorchModeOff = 0, AVCaptureTorchModeOn = 1, AVCaptureTorchModeAuto = 2 } AVCaptureTorchMode;

    Константы

    • Off

      AVCaptureTorchModeOff

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

      Доступный в OS X v10.7 и позже.

    • On

      AVCaptureTorchModeOn

      Факел устройства захвата изображения всегда включен.

      Доступный в OS X v10.7 и позже.

    • Auto

      AVCaptureTorchModeAuto

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

      Доступный в OS X v10.7 и позже.

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

    Objective C

    @import AVFoundation;

    Swift

    import AVFoundation

    Доступность

    Доступный в OS X v10.7 и позже.

  • Максимальный уровень факела.

    Объявление

    Swift

    let AVCaptureMaxAvailableTorchLevel: Float

    Objective C

    const float AVCaptureMaxAvailableTorchLevel;

    Константы

    • AVCaptureMaxAvailableTorchLevel

      AVCaptureMaxAvailableTorchLevel

      Эта константа всегда представляет максимальный доступный уровень факела, независимый от фактического максимального значения, в настоящее время поддерживаемого устройством. Таким образом передайте эту константу setTorchModeOnWithLevel:error: в ситуациях, где Вы хотите указать максимальный уровень факела, не имея необходимость волноваться о том, перегревается ли устройство и не могло бы принять значение 1,0 как максимум.

      Доступный в OS X v10.9 и позже.

  • Константы для указания режима фокуса устройства захвата изображения.

    Объявление

    Swift

    enum AVCaptureFocusMode : Int { case Locked case AutoFocus case ContinuousAutoFocus }

    Objective C

    typedef enum : NSInteger { AVCaptureFocusModeLocked = 0, AVCaptureFocusModeAutoFocus = 1, AVCaptureFocusModeContinuousAutoFocus = 2, } AVCaptureFocusMode;

    Константы

    • Locked

      AVCaptureFocusModeLocked

      Фокус заблокирован.

      Доступный в OS X v10.7 и позже.

    • AutoFocus

      AVCaptureFocusModeAutoFocus

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

      Доступный в OS X v10.7 и позже.

    • ContinuousAutoFocus

      AVCaptureFocusModeContinuousAutoFocus

      Устройство захвата изображения постоянно контролирует фокус и автофокус при необходимости.

      Доступный в OS X v10.7 и позже.

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

    Objective C

    @import AVFoundation;

    Swift

    import AVFoundation

    Доступность

    Доступный в OS X v10.7 и позже.

  • Константы для указания режима воздействия устройства захвата изображения.

    Объявление

    Swift

    enum AVCaptureExposureMode : Int { case Locked case AutoExpose case ContinuousAutoExposure }

    Objective C

    typedef enum : NSInteger { AVCaptureExposureModeLocked = 0, AVCaptureExposureModeAutoExpose = 1, AVCaptureExposureModeContinuousAutoExposure = 2, } AVCaptureExposureMode;

    Константы

    • Locked

      AVCaptureExposureModeLocked

      Установка воздействия заблокирована.

      Доступный в OS X v10.7 и позже.

    • AutoExpose

      AVCaptureExposureModeAutoExpose

      Устройство автоматически корректирует воздействие один раз и затем изменяет режим воздействия на AVCaptureExposureModeLocked.

      Доступный в OS X v10.7 и позже.

    • ContinuousAutoExposure

      AVCaptureExposureModeContinuousAutoExposure

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

      Доступный в OS X v10.7 и позже.

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

    Objective C

    @import AVFoundation;

    Swift

    import AVFoundation

    Доступность

    Доступный в OS X v10.7 и позже.

  • Константы для указания режима баланса белого устройства захвата изображения.

    Объявление

    Swift

    enum AVCaptureWhiteBalanceMode : Int { case Locked case AutoWhiteBalance case ContinuousAutoWhiteBalance }

    Objective C

    typedef enum : NSInteger { AVCaptureWhiteBalanceModeLocked = 0, AVCaptureWhiteBalanceModeAutoWhiteBalance = 1, AVCaptureWhiteBalanceModeContinuousAutoWhiteBalance = 2, } AVCaptureWhiteBalanceMode;

    Константы

    • Locked

      AVCaptureWhiteBalanceModeLocked

      Установка баланса белого заблокирована.

      Доступный в OS X v10.7 и позже.

    • AutoWhiteBalance

      AVCaptureWhiteBalanceModeAutoWhiteBalance

      Устройство выполняет автоматическую работу баланса белого теперь.

      Доступный в OS X v10.7 и позже.

    • ContinuousAutoWhiteBalance

      AVCaptureWhiteBalanceModeContinuousAutoWhiteBalance

      Устройство постоянно контролирует баланс белого и корректируется при необходимости.

      Доступный в OS X v10.7 и позже.

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

    Objective C

    @import AVFoundation;

    Swift

    import AVFoundation

    Доступность

    Доступный в OS X v10.7 и позже.

  • Константы, указывающие текущий режим управления передачей воспроизведения, если это имеет тот.

    Объявление

    Swift

    enum AVCaptureDeviceTransportControlsPlaybackMode : Int { case NotPlayingMode case PlayingMode }

    Objective C

    typedef enum : NSInteger { AVCaptureDeviceTransportControlsNotPlayingMode = 0, AVCaptureDeviceTransportControlsPlayingMode = 1 } AVCaptureDeviceTransportControlsPlaybackMode;

    Константы

    • NotPlayingMode

      AVCaptureDeviceTransportControlsNotPlayingMode

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

      Доступный в OS X v10.7 и позже.

    • PlayingMode

      AVCaptureDeviceTransportControlsPlayingMode

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

      Доступный в OS X v10.7 и позже.

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

    Objective C

    @import AVFoundation;

    Swift

    import AVFoundation

    Доступность

    Доступный в OS X v10.7 и позже.

  • Отправленный, когда новое устройство становится доступным.

    Объект уведомления AVCaptureDevice экземпляр, представляющий устройство, ставшее доступным.

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

    Objective C

    @import AVFoundation;

    Swift

    import AVFoundation

    Доступность

    Доступный в OS X v10.7 и позже.

  • Отправленный, когда существующее устройство становится недоступным.

    Объект уведомления AVCaptureDevice экземпляр, представляющий устройство, ставшее недоступным.

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

    Objective C

    @import AVFoundation;

    Swift

    import AVFoundation

    Доступность

    Доступный в OS X v10.7 и позже.