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

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

Разработчик

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

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

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

AVCaptureDevice

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


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


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


Swift

import AVFoundation

Objective C

@import AVFoundation;

Доступность


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

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

    class func devices() -> [AnyObject]!

    Objective C

    + (NSArray *)devices

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

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

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

    Objective C

    @import AVFoundation;

    Swift

    import AVFoundation

    Доступность

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

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

    Объявление

    Swift

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

    Objective C

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

    Параметры

    deviceUniqueID

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

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

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

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

    Objective C

    @import AVFoundation;

    Swift

    import AVFoundation

    Доступность

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

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

    Объявление

    Swift

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

    Objective C

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

    Параметры

    mediaType

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

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

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

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

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

    Objective C

    @import AVFoundation;

    Swift

    import AVFoundation

    Доступность

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

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

    Объявление

    Swift

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

    Objective C

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

    Параметры

    mediaType

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

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

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

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

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

    Objective C

    @import AVFoundation;

    Swift

    import AVFoundation

    Доступность

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

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

    Объявление

    Swift

    class func requestAccessForMediaType(_ mediaType: String!, completionHandler handler: ((Bool) -> Void)!)

    Objective C

    + (void)requestAccessForMediaType:(NSString *)mediaType completionHandler:(void (^)(BOOL granted))handler

    Параметры

    mediaType

    Постоянный тип среды, также AVMediaTypeVideo или AVMediaTypeAudio. Если какой-либо тип среды предоставляется, NSInvalidArgumentException будет брошен.

    handler

    Блок, который вызовут один раз разрешение, предоставляют или отклоняют.

    Обработчик завершения вызывают на произвольной очереди отгрузки. Он ответственность клиента гарантировать, что любые UIKit-связанные обновления вызывают на основной очереди или основном потоке в результате.

    Блок получает следующий параметр:

    granted

    Если пользователь дает разрешение использовать аппаратные средства YEStrue возвращается; иначе NOfalse. Блок сразу возвратится.

    Обсуждение

    Запись аудио всегда требует явного разрешения от пользователя; запись видео также требует полномочий пользователя на устройствах, проданных в определенных областях. В первый раз Вы создаете любого AVCaptureDeviceInput объекты для типа среды, требующего разрешения, система автоматически, выводят на экран предупреждение для запроса разрешения записи. Также банка можно вызвать этот метод для запроса пользователя во время выбора.

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

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

    response параметр является блоком, единственный параметр которого указывает, предоставил ли пользователь или отклонил разрешение записать. Этот метод всегда сразу возвращается. Если пользователь ранее предоставил или отрицал записывать разрешение, оно выполняет блок, когда вызвано; иначе, это выводит на экран предупреждение и выполняет блок только после того, как пользователь реагировал на предупреждение.

    Вызов этого метода с AVMediaTypeAudio эквивалентно вызову AVAudioSession метод requestRecordPermission:.

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

    Objective C

    @import AVFoundation;

    Swift

    import AVFoundation

    Доступность

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

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

    Объявление

    Swift

    class func authorizationStatusForMediaType(_ mediaType: String!) -> AVAuthorizationStatus

    Objective C

    + (AVAuthorizationStatus)authorizationStatusForMediaType:(NSString *)mediaType

    Параметры

    mediaType

    Постоянный тип среды, также AVMediaTypeVideo или AVMediaTypeAudio.

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

    Постоянное состояние авторизации указания.

    Обсуждение

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

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

    Если возвращается этот метод AVAuthorizationStatusNotDetermined, можно вызвать requestAccessForMediaType:completionHandler: предлагать пользователю запись разрешения.

    Вызов этого метода с любым типом среды кроме AVMediaTypeVideo или AVMediaTypeAudio повышает исключение.

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

    Objective C

    @import AVFoundation;

    Swift

    import AVFoundation

    Доступность

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

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

    Объявление

    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

    Доступность

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

    См. также

    – unlockForConfiguration

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

    Объявление

    Swift

    func unlockForConfiguration()

    Objective C

    - (void)unlockForConfiguration

    Обсуждение

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

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

    Objective C

    @import AVFoundation;

    Swift

    import AVFoundation

    Доступность

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

    См. также

    – lockForConfiguration:

  • formats Свойство

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

    Объявление

    Swift

    var formats: [AnyObject]! { get }

    Objective C

    @property(nonatomic, readonly) NSArray *formats

    Обсуждение

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

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

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

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

    Objective C

    @import AVFoundation;

    Swift

    import AVFoundation

    Доступность

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

    См. также

    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

    Доступность

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

  • focusMode Свойство

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

    Объявление

    Swift

    var focusMode: AVCaptureFocusMode

    Objective C

    @property(nonatomic) AVCaptureFocusMode focusMode

    Обсуждение

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

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

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

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

    Objective C

    @import AVFoundation;

    Swift

    import AVFoundation

    Доступность

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

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

    Объявление

    Swift

    func isFocusModeSupported(_ focusMode: AVCaptureFocusMode) -> Bool

    Objective C

    - (BOOL)isFocusModeSupported:(AVCaptureFocusMode)focusMode

    Параметры

    focusMode

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

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

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

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

    Objective C

    @import AVFoundation;

    Swift

    import AVFoundation

    Доступность

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

  • focusPointOfInterest Свойство

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

    Объявление

    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

    Доступность

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

    См. также

    exposurePointOfInterest

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

    Объявление

    Swift

    var focusPointOfInterestSupported: Bool { get }

    Objective C

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

    Обсуждение

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

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

    Objective C

    @import AVFoundation;

    Swift

    import AVFoundation

    Доступность

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

  • adjustingFocus Свойство

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

    Объявление

    Swift

    var adjustingFocus: Bool { get }

    Objective C

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

    Обсуждение

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

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

    Objective C

    @import AVFoundation;

    Swift

    import AVFoundation

    Доступность

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

  • smoothAutoFocusEnabled Свойство

    Булево значение, определяющее, включен ли гладкий автофокус.

    Объявление

    Swift

    var smoothAutoFocusEnabled: Bool

    Objective C

    @property(nonatomic, getter=isSmoothAutoFocusEnabled) BOOL smoothAutoFocusEnabled

    Обсуждение

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

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

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

    Objective C

    @import AVFoundation;

    Swift

    import AVFoundation

    Доступность

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

  • smoothAutoFocusSupported Свойство

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

    Объявление

    Swift

    var smoothAutoFocusSupported: Bool { get }

    Objective C

    @property(nonatomic, readonly, getter=isSmoothAutoFocusSupported) BOOL smoothAutoFocusSupported

    Обсуждение

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

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

    Objective C

    @import AVFoundation;

    Swift

    import AVFoundation

    Доступность

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

  • autoFocusRangeRestriction Свойство

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

    Объявление

    Swift

    var autoFocusRangeRestriction: AVCaptureAutoFocusRangeRestriction

    Objective C

    @property(nonatomic) AVCaptureAutoFocusRangeRestriction autoFocusRangeRestriction

    Обсуждение

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

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

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

    Objective C

    @import AVFoundation;

    Swift

    import AVFoundation

    Доступность

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

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

    Объявление

    Swift

    var autoFocusRangeRestrictionSupported: Bool { get }

    Objective C

    @property(nonatomic, readonly, getter=isAutoFocusRangeRestrictionSupported) BOOL autoFocusRangeRestrictionSupported

    Обсуждение

    Ограничение диапазона фокусировки доступно только на совместимых устройствах. Если значение этого свойства NOfalse, установка значения autoFocusRangeRestriction повышает исключение.

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

    Objective C

    @import AVFoundation;

    Swift

    import AVFoundation

    Доступность

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

  • adjustingExposure Свойство

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

    Объявление

    Swift

    var adjustingExposure: Bool { get }

    Objective C

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

    Обсуждение

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

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

    Objective C

    @import AVFoundation;

    Swift

    import AVFoundation

    Доступность

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

  • exposureMode Свойство

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

    Объявление

    Swift

    var exposureMode: AVCaptureExposureMode

    Objective C

    @property(nonatomic) AVCaptureExposureMode exposureMode

    Обсуждение

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

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

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

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

    Objective C

    @import AVFoundation;

    Swift

    import AVFoundation

    Доступность

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

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

    Объявление

    Swift

    func isExposureModeSupported(_ exposureMode: AVCaptureExposureMode) -> Bool

    Objective C

    - (BOOL)isExposureModeSupported:(AVCaptureExposureMode)exposureMode

    Параметры

    exposureMode

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

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

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

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

    Objective C

    @import AVFoundation;

    Swift

    import AVFoundation

    Доступность

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

  • exposurePointOfInterest Свойство

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

    Объявление

    Swift

    var exposurePointOfInterest: CGPoint

    Objective C

    @property(nonatomic) CGPoint exposurePointOfInterest

    Обсуждение

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

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

    Objective C

    @import AVFoundation;

    Swift

    import AVFoundation

    Доступность

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

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

    Объявление

    Swift

    var exposurePointOfInterestSupported: Bool { get }

    Objective C

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

    Обсуждение

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

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

    Objective C

    @import AVFoundation;

    Swift

    import AVFoundation

    Доступность

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

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

    Объявление

    Swift

    func isWhiteBalanceModeSupported(_ whiteBalanceMode: AVCaptureWhiteBalanceMode) -> Bool

    Objective C

    - (BOOL)isWhiteBalanceModeSupported:(AVCaptureWhiteBalanceMode)whiteBalanceMode

    Параметры

    whiteBalanceMode

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

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

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

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

    Objective C

    @import AVFoundation;

    Swift

    import AVFoundation

    Доступность

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

    См. также

    связанный

  • whiteBalanceMode Свойство

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

    Объявление

    Swift

    var whiteBalanceMode: AVCaptureWhiteBalanceMode

    Objective C

    @property(nonatomic) AVCaptureWhiteBalanceMode whiteBalanceMode

    Обсуждение

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

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

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

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

    Objective C

    @import AVFoundation;

    Swift

    import AVFoundation

    Доступность

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

  • adjustingWhiteBalance Свойство

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

    Объявление

    Swift

    var adjustingWhiteBalance: Bool { get }

    Objective C

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

    Обсуждение

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

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

    Objective C

    @import AVFoundation;

    Swift

    import AVFoundation

    Доступность

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

  • videoZoomFactor Свойство

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

    Объявление

    Swift

    var videoZoomFactor: CGFloat

    Objective C

    @property(nonatomic) CGFloat videoZoomFactor

    Обсуждение

    Это значение является множителем. Например, значение 2.0 удваивает размер предмета изображения (и половины поле зрения). Позволенные значения располагаются от 1.0 (полное поле зрения) к значению активного формата videoMaxZoomFactor свойство. Установка значения этого свойства сразу переходит к новому фактору изменения масштаба. Для плавного перехода используйте rampToVideoZoomFactor:withRate: метод.

    Устройство достигает эффекта изменения масштаба путем обрезки вокруг центра изображения, полученного датчиком. В низких факторах изменения масштаба кадрированные изображения равны или больше, чем выходной размер. В более высоких факторах изменения масштаба устройство должно масштабировать кадрированное изображение до выходного размера, приводящего к потере качества изображения. Активный формат videoZoomFactorUpscaleThreshold свойство указывает факторы, в которых произойдет увелечение масштаба.

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

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

    Objective C

    @import AVFoundation;

    Swift

    import AVFoundation

    Доступность

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

    См. также

    activeFormat

  • Начинает плавный переход от текущего фактора изменения масштаба до другого.

    Объявление

    Swift

    func rampToVideoZoomFactor(_ factor: CGFloat, withRate rate: Float)

    Objective C

    - (void)rampToVideoZoomFactor:(CGFloat)factor withRate:(float)rate

    Параметры

    factor

    Новый фактор увеличения.

    rate

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

    Обсуждение

    Позволенные значения для factor диапазон от 1.0 (полное поле зрения) к videoMaxZoomFactor указанный активным форматом получения.

    Во время ската, изменений фактора изменения масштаба на экспоненциальном уровне, но это приводит к визуально линейному переходу. rate параметр управляет скоростью этого перехода, независимого от направления; например, значение 1.0 причины масштабируют фактор для удвоения каждую секунду при увеличивании масштаб (т.е. если указанное factor больше, чем ток videoZoomFactor) или сокращайтесь наполовину каждую секунду при уменьшении масштаб.

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

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

    Objective C

    @import AVFoundation;

    Swift

    import AVFoundation

    Доступность

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

    См. также

    videoZoomFactor
    activeFormat

  • Гладко заканчивает происходящий переход изменения масштаба.

    Объявление

    Swift

    func cancelVideoZoomRamp()

    Objective C

    - (void)cancelVideoZoomRamp

    Обсуждение

    Вызов этого метода эквивалентен вызову rampToVideoZoomFactor:withRate: с уровнем нуля. Если переход изменения масштаба происходит, переход замедляется к остановке (вместо того, чтобы остановиться резко).

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

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

    Objective C

    @import AVFoundation;

    Swift

    import AVFoundation

    Доступность

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

  • rampingVideoZoom Свойство

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

    Объявление

    Swift

    var rampingVideoZoom: Bool { get }

    Objective C

    @property(nonatomic, readonly, getter=isRampingVideoZoom) BOOL rampingVideoZoom

    Обсуждение

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

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

    Objective C

    @import AVFoundation;

    Swift

    import AVFoundation

    Доступность

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

  • hasFlash Свойство

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

    Объявление

    Swift

    var hasFlash: Bool { get }

    Objective C

    @property(nonatomic, readonly) BOOL hasFlash

    Обсуждение

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

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

    Objective C

    @import AVFoundation;

    Swift

    import AVFoundation

    Доступность

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

  • flashMode Свойство

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

    Объявление

    Swift

    var flashMode: AVCaptureFlashMode

    Objective C

    @property(nonatomic) AVCaptureFlashMode flashMode

    Обсуждение

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

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

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

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

    Objective C

    @import AVFoundation;

    Swift

    import AVFoundation

    Доступность

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

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

    Объявление

    Swift

    func isFlashModeSupported(_ flashMode: AVCaptureFlashMode) -> Bool

    Objective C

    - (BOOL)isFlashModeSupported:(AVCaptureFlashMode)flashMode

    Параметры

    flashMode

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

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

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

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

    Objective C

    @import AVFoundation;

    Swift

    import AVFoundation

    Доступность

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

    См. также

    hasFlash
    flashMode

  • flashActive Свойство

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

    Объявление

    Swift

    var flashActive: Bool { get }

    Objective C

    @property(nonatomic, readonly, getter=isFlashActive) BOOL flashActive

    Обсуждение

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

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

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

    Objective C

    @import AVFoundation;

    Swift

    import AVFoundation

    Доступность

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

    См. также

    hasFlash
    flashAvailable

  • flashAvailable Свойство

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

    Объявление

    Swift

    var flashAvailable: Bool { get }

    Objective C

    @property(nonatomic, readonly, getter=isFlashAvailable) BOOL flashAvailable

    Обсуждение

    Если, например, перегревания устройства и должен остыть, флэш-память может стать недоступной.

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

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

    Objective C

    @import AVFoundation;

    Swift

    import AVFoundation

    Доступность

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

    См. также

    hasFlash
    hasMediaType:

  • hasTorch Свойство

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

    Объявление

    Swift

    var hasTorch: Bool { get }

    Objective C

    @property(nonatomic, readonly) BOOL hasTorch

    Обсуждение

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

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

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

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

    Objective C

    @import AVFoundation;

    Swift

    import AVFoundation

    Доступность

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

  • torchAvailable Свойство

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

    Объявление

    Swift

    var torchAvailable: Bool { get }

    Objective C

    @property(nonatomic, readonly, getter=isTorchAvailable) BOOL torchAvailable

    Обсуждение

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

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

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

    Objective C

    @import AVFoundation;

    Swift

    import AVFoundation

    Доступность

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

    См. также

    isWhiteBalanceModeSupported:

  • torchActive Свойство

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

    Объявление

    Swift

    var torchActive: Bool { get }

    Objective C

    @property(nonatomic, readonly, getter=isTorchActive) BOOL torchActive

    Обсуждение

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

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

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

    Objective C

    @import AVFoundation;

    Swift

    import AVFoundation

    Доступность

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

  • torchLevel Свойство

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

    Объявление

    Swift

    var torchLevel: Float { get }

    Objective C

    @property(nonatomic, readonly) float torchLevel

    Обсуждение

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

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

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

    Objective C

    @import AVFoundation;

    Swift

    import AVFoundation

    Доступность

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

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

    Объявление

    Swift

    func isTorchModeSupported(_ torchMode: AVCaptureTorchMode) -> Bool

    Objective C

    - (BOOL)isTorchModeSupported:(AVCaptureTorchMode)torchMode

    Параметры

    torchMode

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

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

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

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

    Objective C

    @import AVFoundation;

    Swift

    import AVFoundation

    Доступность

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

    См. также

    torchMode

  • torchMode Свойство

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

    Объявление

    Swift

    var torchMode: AVCaptureTorchMode

    Objective C

    @property(nonatomic) AVCaptureTorchMode torchMode

    Обсуждение

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

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

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

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

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

    Objective C

    @import AVFoundation;

    Swift

    import AVFoundation

    Доступность

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

    См. также

    – isTorchModeSupported:

  • Устанавливает уровень освещения когда в режиме факела.

    Объявление

    Swift

    func setTorchModeOnWithLevel(_ torchLevel: Float, error outError: NSErrorPointer) -> Bool

    Objective C

    - (BOOL)setTorchModeOnWithLevel:(float)torchLevel error:(NSError **)outError

    Параметры

    torchLevel

    Новый уровень режима факела. Это значение должно быть числом с плавающей точкой между 0,0 и 1.0. Для установки уровня режима факела в в настоящее время доступный максимум укажите константу AVCaptureMaxAvailableTorchLevel для этого параметра.

    outError

    На вводе, указателе на ошибочный объект. Если ошибка происходит, этот метод присваивает ошибочный объект указателю с информацией о том, что произошло.

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

    YEStrue если уровень режима факела был установлен или NOfalse если это не было.

    Обсуждение

    Этот метод устанавливает режим факела в AVCaptureTorchModeOn и устанавливает уровень в указанное значение. Если устройство не поддерживает AVCaptureTorchModeOn режим факела или если Вы указываете значение для torchLevel это вне принятого диапазона, этот метод повышает исключение. Если значение факела в в принятом диапазоне, но больше, чем в настоящее время поддерживаемый максимум — возможно, потому что устройство перегревается — просто возвращается этот метод NOfalse.

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

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

    Objective C

    @import AVFoundation;

    Swift

    import AVFoundation

    Доступность

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

  • lowLightBoostSupported Свойство

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

    Объявление

    Swift

    var lowLightBoostSupported: Bool { get }

    Objective C

    @property(nonatomic, readonly, getter=isLowLightBoostSupported) BOOL lowLightBoostSupported

    Обсуждение

    AVCaptureDevice объект automaticallyEnablesLowLightBoostWhenAvailable если это свойство, свойство может только быть установлено YEStrue.

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

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

    Objective C

    @import AVFoundation;

    Swift

    import AVFoundation

    Доступность

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

  • lowLightBoostEnabled Свойство

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

    Объявление

    Swift

    var lowLightBoostEnabled: Bool { get }

    Objective C

    @property(nonatomic, readonly, getter=isLowLightBoostEnabled) BOOL lowLightBoostEnabled

    Обсуждение

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

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

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

    Objective C

    @import AVFoundation;

    Swift

    import AVFoundation

    Доступность

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

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

    Объявление

    Swift

    var automaticallyEnablesLowLightBoostWhenAvailable: Bool

    Objective C

    @property(nonatomic) BOOL automaticallyEnablesLowLightBoostWhenAvailable

    Обсуждение

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

    Значение по умолчанию этого свойства NOfalse. Установка этого свойства бросает NSInvalidArgumentException если lowLightBoostSupported NOfalse. AVCaptureDevice объект должен быть заблокирован для использования конфигурации lockForConfiguration: прежде чем клиенты могут установить этот метод, иначе NSGenericException брошен.

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

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

    Objective C

    @import AVFoundation;

    Swift

    import AVFoundation

    Доступность

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

  • activeVideoMinFrameDuration Свойство

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

    Объявление

    Swift

    var activeVideoMinFrameDuration: CMTime

    Objective C

    @property(nonatomic) CMTime activeVideoMinFrameDuration

    Обсуждение

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

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

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

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

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

    Objective C

    @import AVFoundation;

    Swift

    import AVFoundation

    Доступность

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

    См. также

    activeFormat

  • activeVideoMaxFrameDuration Свойство

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

    Объявление

    Swift

    var activeVideoMaxFrameDuration: CMTime

    Objective C

    @property(nonatomic) CMTime activeVideoMaxFrameDuration

    Обсуждение

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

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

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

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

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

    Objective C

    @import AVFoundation;

    Swift

    import AVFoundation

    Доступность

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

    См. также

    activeFormat

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

    Объявление

    Swift

    var subjectAreaChangeMonitoringEnabled: Bool

    Objective C

    @property(nonatomic, getter=isSubjectAreaChangeMonitoringEnabled) BOOL subjectAreaChangeMonitoringEnabled

    Обсуждение

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

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

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

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

    Objective C

    @import AVFoundation;

    Swift

    import AVFoundation

    Доступность

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

    См. также

    – focusMode

  • connected Свойство

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

    Объявление

    Swift

    var connected: Bool { get }

    Objective C

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

    Обсуждение

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

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

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

    Objective C

    @import AVFoundation;

    Swift

    import AVFoundation

    Доступность

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

  • position Свойство

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

    Объявление

    Swift

    var position: AVCaptureDevicePosition { get }

    Objective C

    @property(nonatomic, readonly) AVCaptureDevicePosition position

    Обсуждение

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

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

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

    Objective C

    @import AVFoundation;

    Swift

    import AVFoundation

    Доступность

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

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

    Объявление

    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

    Доступность

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

  • modelID Свойство

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

    Объявление

    Swift

    var modelID: String! { get }

    Objective C

    @property(nonatomic, readonly) NSString *modelID

    Обсуждение

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

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

    Objective C

    @import AVFoundation;

    Swift

    import AVFoundation

    Доступность

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

  • localizedName Свойство

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

    Объявление

    Swift

    var localizedName: String! { get }

    Objective C

    @property(nonatomic, readonly) NSString *localizedName

    Обсуждение

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

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

    Objective C

    @import AVFoundation;

    Swift

    import AVFoundation

    Доступность

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

  • uniqueID Свойство

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

    Объявление

    Swift

    var uniqueID: String! { get }

    Objective C

    @property(nonatomic, readonly) NSString *uniqueID

    Обсуждение

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

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

    Objective C

    @import AVFoundation;

    Swift

    import AVFoundation

    Доступность

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

    См. также

    torchActive
    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

    Доступность

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

  • lensAperture Свойство

    Размер диафрагмы линзы. (только для чтения)

    Объявление

    Swift

    var lensAperture: Float { get }

    Objective C

    @property(nonatomic, readonly) float lensAperture

    Обсуждение

    Значение этого свойства является плаванием, указывающим размер ( f число) диафрагмы линзы.

    Это значение не изменяется.

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

    Objective C

    @import AVFoundation;

    Swift

    import AVFoundation

    Доступность

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

  • lensPosition Свойство

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

    Объявление

    Swift

    var lensPosition: Float { get }

    Objective C

    @property(nonatomic, readonly) float lensPosition

    Обсуждение

    Данное значение позиции линзы не соответствует точному физическому расстоянию, и при этом оно не представляет непротиворечивое расстояние фокуса с устройства на устройство.

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

    Значение может быть считано в любое время, независимо от режима фокуса, но может только быть установлено через setFocusModeLockedWithLensPosition:completionHandler:.

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

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

    Objective C

    @import AVFoundation;

    Swift

    import AVFoundation

    Доступность

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

  • Блокирует позицию линзы в указанном значении.

    Объявление

    Swift

    func setFocusModeLockedWithLensPosition(_ lensPosition: Float, completionHandler handler: ((CMTime) -> Void)!)

    Objective C

    - (void)setFocusModeLockedWithLensPosition:(float)lensPosition completionHandler:(void (^)(CMTime syncTime))handler

    Параметры

    lensPosition

    Позиция линзы. Значение AVCaptureLensPositionCurrent может использоваться, чтобы указать, что вызывающая сторона не хочет указывать значение для lensPosition.

    handler

    Блок, который вызывают когда lensPosition был установлен в указанное значение и focusMode AVCaptureFocusModeLocked. Блок получает метку времени, соответствующую метку времени первого буфера, к которому были применены все настройки.

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

    Клиент может передать nil для параметра обработчика, если не требуется знание завершения работы.

    Обсуждение

    Этот метод является единственными средними значениями установки lensPosition свойство.

    Этот метод бросает NSInvalidArgumentException исключение, если lensPosition установлен в неподдерживаемый уровень. NSGenericException если метод вызывают без первого эксклюзивного доступа получения к использованию получателя, исключение выдается lockForConfiguration:.

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

    Objective C

    @import AVFoundation;

    Swift

    import AVFoundation

    Доступность

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

  • exposureDuration Свойство

    Отрезок времени, за который имеет место воздействие. (только для чтения)

    Объявление

    Swift

    var exposureDuration: CMTime { get }

    Objective C

    @property(nonatomic, readonly) CMTime exposureDuration

    Обсуждение

    Только продолжительность воздействия оценивает между minExposureDuration и maxExposureDuration поддерживаются.

    Продолжительность воздействия может быть считана в любое время, независимо от режима воздействия, но может только быть установлена setExposureModeCustomWithDuration:ISO:completionHandler: метод.

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

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

    Objective C

    @import AVFoundation;

    Swift

    import AVFoundation

    Доступность

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

  • Блокирует продолжительность воздействия и ISO в указанных значениях.

    Объявление

    Swift

    func setExposureModeCustomWithDuration(_ duration: CMTime, ISO ISO: Float, completionHandler handler: ((CMTime) -> Void)!)

    Objective C

    - (void)setExposureModeCustomWithDuration:(CMTime)duration ISO:(float)ISO completionHandler:(void (^)(CMTime syncTime))handler

    Параметры

    duration

    Продолжительность воздействия.

    Значение AVCaptureExposureDurationCurrent может использоваться, чтобы указать, что вызывающая сторона не хочет указывать значение для exposureDuration. Обратите внимание на то, что изменения в этом свойстве могут привести к изменениям в activeVideoMinFrameDuration и/или activeVideoMaxFrameDuration.

    ISO

    Воздействие значение ISO.

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

    handler

    Блок, который вызовут, когда и exposureDuration и ISO были установлены в указанные значения и exposureMode, AVCaptureExposureModeCustom.

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

    Передача nil для параметра обработчика, если не требуется знание завершения работы.

    Обсуждение

    Этот метод является единственным способом установить exposureDuration и ISO.

    Этот метод бросает NSInvalidArgumentException исключение, если также exposureDuration или ISO установлен в неподдерживаемый уровень. NSGenericException если этот метод вызывается без первого эксклюзивного доступа получения к использованию получателя, исключение выдается lockForConfiguration:.

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

    Objective C

    @import AVFoundation;

    Swift

    import AVFoundation

    Доступность

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

  • exposureTargetOffset Свойство

    Измеренное смещение уровня воздействия от целевого значения воздействия, в модулях EV. (только для чтения)

    Объявление

    Swift

    var exposureTargetOffset: Float { get }

    Objective C

    @property(nonatomic, readonly) float exposureTargetOffset

    Обсуждение

    Значение свойства указывает различие между измеренным уровнем воздействия текущей сцены и целевым значением воздействия.

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

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

    Objective C

    @import AVFoundation;

    Swift

    import AVFoundation

    Доступность

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

  • exposureTargetBias Свойство

    Смещение применилось к целевому значению воздействия в модулях EV. (только для чтения)

    Объявление

    Swift

    var exposureTargetBias: Float { get }

    Objective C

    @property(nonatomic, readonly) float exposureTargetBias

    Обсуждение

    Когда exposureMode AVCaptureExposureModeAutoExpose или AVCaptureExposureModeLocked, смещение будет влиять на оба измерения (exposureTargetOffset), и фактический уровень воздействия (exposureDuration и ISO). Когда режим воздействия AVCaptureExposureModeCustom, это будет только влиять на измерение.

    Это свойство может быть считано в любое время, но может только быть установлено с помощью setExposureTargetBias:completionHandler:: метод.

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

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

    Objective C

    @import AVFoundation;

    Swift

    import AVFoundation

    Доступность

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

  • maxExposureTargetBias Свойство

    Максимальное поддерживаемое смещение воздействия, в модулях EV. (только для чтения)

    Объявление

    Swift

    var maxExposureTargetBias: Float { get }

    Objective C

    @property(nonatomic, readonly) float maxExposureTargetBias

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

    Objective C

    @import AVFoundation;

    Swift

    import AVFoundation

    Доступность

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

  • minExposureTargetBias Свойство

    Минимальное поддерживаемое смещение воздействия, в модулях EV. (только для чтения)

    Объявление

    Swift

    var minExposureTargetBias: Float { get }

    Objective C

    @property(nonatomic, readonly) float minExposureTargetBias

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

    Objective C

    @import AVFoundation;

    Swift

    import AVFoundation

    Доступность

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

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

    Объявление

    Swift

    func setExposureTargetBias(_ bias: Float, completionHandler handler: ((CMTime) -> Void)!)

    Objective C

    - (void)setExposureTargetBias:(float)bias completionHandler:(void (^)(CMTime syncTime))handler

    Параметры

    bias

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

    handler

    Блок, который вызовут, когда exposureTargetBias свойство было установлено в указанное значение.

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

    Клиент может передать nil для параметра обработчика, если не требуется знание завершения работы.

    Обсуждение

    Этот метод является единственным способом установить exposureTargetBias свойство.

    Этот метод бросает NSInvalidArgumentException исключение, если exposureTargetBias установлен в неподдерживаемый уровень. NSGenericException если этот метод вызывается без первого эксклюзивного доступа получения к использованию получателя, исключение выдается lockForConfiguration:.

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

    Objective C

    @import AVFoundation;

    Swift

    import AVFoundation

    Доступность

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

    См. также

    exposureTargetBias

  • Преобразовывает специфичные для устройства значения усиления RGB баланса белого в независящие от устройств значения цветности.

    Объявление

    Swift

    func chromaticityValuesForDeviceWhiteBalanceGains(_ whiteBalanceGains: AVCaptureWhiteBalanceGains) -> AVCaptureWhiteBalanceChromaticityValues

    Objective C

    - (AVCaptureWhiteBalanceChromaticityValues)chromaticityValuesForDeviceWhiteBalanceGains:(AVCaptureWhiteBalanceGains)whiteBalanceGains

    Параметры

    whiteBalanceGains

    Значения усиления баланса белого. Значение AVCaptureWhiteBalanceGainsCurrent может не использоваться.

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

    Полностью заполненный AVCaptureWhiteBalanceChromaticityValues структура, содержащая независящие от устройств значения.

    Обсуждение

    Этот метод можно вызвать на получателе для преобразования специфичных для устройства значений усиления RGB баланса белого в независящую от устройств цветность (мало x, мало y) значения.

    Для каждого канала в whiteBalanceGains структура, только значения между 1.0 и maxWhiteBalanceGain поддерживаются. Этот метод бросает NSInvalidArgumentException исключение, если любой из whiteBalanceGains поля установлены в неподдерживаемые значения.

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

    Objective C

    @import AVFoundation;

    Swift

    import AVFoundation

    Доступность

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

  • deviceWhiteBalanceGains Свойство

    Текущий специфичный для устройства баланс белого RGB получает значения. (только для чтения)

    Объявление

    Swift

    var deviceWhiteBalanceGains: AVCaptureWhiteBalanceGains { get }

    Objective C

    @property(nonatomic, readonly) AVCaptureWhiteBalanceGains deviceWhiteBalanceGains

    Обсуждение

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

    Значение может быть считано в любое время, независимо от режима баланса белого, но может только быть установлено с помощью setWhiteBalanceModeLockedWithDeviceWhiteBalanceGains:completionHandler: метод.

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

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

    Objective C

    @import AVFoundation;

    Swift

    import AVFoundation

    Доступность

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

  • maxWhiteBalanceGain Свойство

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

    Объявление

    Swift

    var maxWhiteBalanceGain: Float { get }

    Objective C

    @property(nonatomic, readonly) float maxWhiteBalanceGain

    Обсуждение

    Это свойство не изменяется для жизни объекта.

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

    Objective C

    @import AVFoundation;

    Swift

    import AVFoundation

    Доступность

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

  • Преобразовывает независящие от устройств значения цветности в специфичные для устройства значения усиления RGB баланса белого.

    Объявление

    Swift

    func deviceWhiteBalanceGainsForChromaticityValues(_ chromaticityValues: AVCaptureWhiteBalanceChromaticityValues) -> AVCaptureWhiteBalanceGains

    Objective C

    - (AVCaptureWhiteBalanceGains)deviceWhiteBalanceGainsForChromaticityValues:(AVCaptureWhiteBalanceChromaticityValues)chromaticityValues

    Параметры

    chromaticityValues

    Значения цветности.

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

    Полностью заполненный AVCaptureWhiteBalanceGains структура, содержащая специфичные для устройства значения усиления RGB.

    Обсуждение

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

    Этот метод бросает NSInvalidArgumentException исключение, если любой из chromaticityValues поля установлены вне диапазона [0,1].

    Некоторые chromaticityValues полевые комбинации приводят к устройству из диапазона значения RGB, которые заставят исключение быть брошенным, если передано непосредственно в setWhiteBalanceModeLockedWithDeviceWhiteBalanceGains:completionHandler:. Обязательно проверьте, что красные, зеленые, и синие значения усиления в диапазоне [1.0 - maxWhiteBalanceGain].

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

    Objective C

    @import AVFoundation;

    Swift

    import AVFoundation

    Доступность

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

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

    Объявление

    Swift

    func deviceWhiteBalanceGainsForTemperatureAndTintValues(_ tempAndTintValues: AVCaptureWhiteBalanceTemperatureAndTintValues) -> AVCaptureWhiteBalanceGains

    Objective C

    - (AVCaptureWhiteBalanceGains)deviceWhiteBalanceGainsForTemperatureAndTintValues:(AVCaptureWhiteBalanceTemperatureAndTintValues)tempAndTintValues

    Параметры

    tempAndTintValues

    AVCaptureWhiteBalanceTemperatureAndTintValues структура, содержащая температуру и значения оттенка.

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

    Полностью заполненный AVCaptureWhiteBalanceGains структура, содержащая специфичные для устройства значения усиления RGB.

    Обсуждение

    Этот метод вызывается для преобразования независящей от устройств температуры, и оттенок оценивает специфичным для устройства значениям усиления баланса белого RGB.

    Можно передать любую температуру и окрасить значения, и будут произведены соответствующие усиления баланса белого. Отметьте, хотя та некоторая температура и окрашивает устройство дохода комбинаций из диапазона значения RGB, которые заставят исключение быть брошенным, если передано непосредственно в setWhiteBalanceModeLockedWithDeviceWhiteBalanceGains:completionHandler:. Обязательно проверьте, что красные, зеленые, и синие значения усиления в диапазоне [1.0 - maxWhiteBalanceGain].

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

    Objective C

    @import AVFoundation;

    Swift

    import AVFoundation

    Доступность

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

  • Текущий специфичный для устройства серый мировой баланс белого RGB получает значения. (только для чтения)

    Объявление

    Swift

    var grayWorldDeviceWhiteBalanceGains: AVCaptureWhiteBalanceGains { get }

    Objective C

    @property(nonatomic, readonly) AVCaptureWhiteBalanceGains grayWorldDeviceWhiteBalanceGains

    Обсуждение

    Это свойство указывает текущие красные, зеленые, и синие значения усиления, полученные на текущую сцену для поставки нейтрального (или мир Грэя) белая точка для баланса белого.

    Серые мировые значения предполагают, что нейтральный предмет (например, серая карта) был помещен посреди предметной области и заполняет центр 50% кадра. Клиенты могут считать эти значения и применить их к использованию устройства setWhiteBalanceModeLockedWithDeviceWhiteBalanceGains:completionHandler:.

    Для каждого канала, только значения между 1.0 и maxWhiteBalanceGain поддерживаются. Значение может быть считано в любое время, независимо от режима баланса белого.

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

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

    Objective C

    @import AVFoundation;

    Swift

    import AVFoundation

    Доступность

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

  • Баланс белого наборов к режиму захвата с указанными значениями deviceWhiteBalanceGains.

    Объявление

    Swift

    func setWhiteBalanceModeLockedWithDeviceWhiteBalanceGains(_ whiteBalanceGains: AVCaptureWhiteBalanceGains, completionHandler handler: ((CMTime) -> Void)!)

    Objective C

    - (void)setWhiteBalanceModeLockedWithDeviceWhiteBalanceGains:(AVCaptureWhiteBalanceGains)whiteBalanceGains completionHandler:(void (^)(CMTime syncTime))handler

    Параметры

    whiteBalanceGains

    Усиления баланса белого.

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

    handler

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

    Этот параметр может быть nil если не требуется синхронизация.

    Обсуждение

    Для каждого канала в whiteBalanceGains структуре, только значения между 1,0 и maxWhiteBalanceGain поддерживаются. Значения усиления нормализованы к минимальному значению канала для предотвращения изменений яркости (например, R:2 G:2 B:4 будет нормализован к R:1 G:1 B:2).

    Этот метод бросает NSInvalidArgumentException если любой из whiteBalanceGains поля установлены в неподдерживаемый уровень. NSGenericException, если вызвано без первого эксклюзивного доступа получения к использованию получателя lockForConfiguration:.

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

    Objective C

    @import AVFoundation;

    Swift

    import AVFoundation

    Доступность

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

  • Преобразовывает специфичные для устройства значения усиления RGB баланса белого в независящую от устройств температуру и значения оттенка.

    Объявление

    Swift

    func temperatureAndTintValuesForDeviceWhiteBalanceGains(_ whiteBalanceGains: AVCaptureWhiteBalanceGains) -> AVCaptureWhiteBalanceTemperatureAndTintValues

    Objective C

    - (AVCaptureWhiteBalanceTemperatureAndTintValues)temperatureAndTintValuesForDeviceWhiteBalanceGains:(AVCaptureWhiteBalanceGains)whiteBalanceGains

    Параметры

    whiteBalanceGains

    Значения усиления баланса белого.

    Значение AVCaptureWhiteBalanceGainsCurrent может не использоваться.

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

    Полностью заполненный AVCaptureWhiteBalanceTemperatureAndTintValues структура, содержащая независящие от устройств значения.

    Обсуждение

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

    Для каждого канала в whiteBalanceGains структура, только значения между 1.0 и maxWhiteBalanceGain поддерживаются.

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

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

    Objective C

    @import AVFoundation;

    Swift

    import AVFoundation

    Доступность

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

  • ISO Свойство

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

    Объявление

    Swift

    var ISO: Float { get }

    Objective C

    @property(nonatomic, readonly) float ISO

    Обсуждение

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

    Только продолжительность воздействия оценивает между minISO и maxISO поддерживаются. Более высокие значения приведут к более шумным изображениям.

    Значение свойства может быть считано в любое время, независимо от режима воздействия, но может только быть установлено с помощью setExposureModeCustomWithDuration:ISO:completionHandler: метод.

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

    Objective C

    @import AVFoundation;

    Swift

    import AVFoundation

    Доступность

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

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

    Объявление

    Swift

    var automaticallyAdjustsVideoHDREnabled: Bool

    Objective C

    @property(nonatomic) BOOL automaticallyAdjustsVideoHDREnabled

    Обсуждение

    Значение по умолчанию YEStrue. По умолчанию, AVCaptureDevice всегда наборы videoHDREnabled к NOfalse когда клиент устанавливает новый формат с помощью activeFormat свойство.

    Когда клиент использует AVCaptureSession свойство sessionPreset вместо этого, AVCaptureDevice включает видео HDR автоматически, если это - подходящий вариант для предварительной установки. NSGenericException если это свойство установлено без первого эксклюзивного доступа получения к использованию получателя, исключение выдается lockForConfiguration:. Клиенты могут использовать наблюдение значения ключа videoHDREnabled свойство для знания, когда получатель автоматически изменил значение.

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

    Objective C

    @import AVFoundation;

    Swift

    import AVFoundation

    Доступность

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

  • videoHDREnabled Свойство

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

    Объявление

    Swift

    var videoHDREnabled: Bool

    Objective C

    @property(nonatomic, getter=isVideoHDREnabled) BOOL videoHDREnabled

    Обсуждение

    Значение по умолчанию YEStrue. По умолчанию, AVCaptureDevice всегда наборы videoHDREnabled к NOfalse когда клиент устанавливает новый формат с помощью activeFormat свойство.

    Когда клиент использует AVCaptureSession свойство sessionPreset вместо этого, AVCaptureDevice включает видео HDR автоматически, если это - подходящий вариант для предварительной установки. NSGenericException если это свойство установлено без первого эксклюзивного доступа получения к использованию получателя, исключение выдается lockForConfiguration:. Клиенты могут использовать наблюдение значения ключа videoHDREnabled свойство для знания, когда получатель автоматически изменил значение.

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

    Objective C

    @import AVFoundation;

    Swift

    import AVFoundation

    Доступность

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

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

    Объявление

    Swift

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

    Objective C

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

    Константы

    • Unspecified

      AVCaptureDevicePositionUnspecified

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

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

    • Back

      AVCaptureDevicePositionBack

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

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

    • Front

      AVCaptureDevicePositionFront

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

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

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

    Objective C

    @import AVFoundation;

    Swift

    import AVFoundation

    Доступность

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

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

    Объявление

    Swift

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

    Objective C

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

    Константы

    • Off

      AVCaptureFlashModeOff

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

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

    • On

      AVCaptureFlashModeOn

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

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

    • Auto

      AVCaptureFlashModeAuto

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

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

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

    Objective C

    @import AVFoundation;

    Swift

    import AVFoundation

    Доступность

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

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

    Объявление

    Swift

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

    Objective C

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

    Константы

    • Off

      AVCaptureTorchModeOff

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

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

    • On

      AVCaptureTorchModeOn

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

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

    • Auto

      AVCaptureTorchModeAuto

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

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

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

    Objective C

    @import AVFoundation;

    Swift

    import AVFoundation

    Доступность

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

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

    Объявление

    Swift

    let AVCaptureMaxAvailableTorchLevel: Float

    Objective C

    const float AVCaptureMaxAvailableTorchLevel;

    Константы

    • AVCaptureMaxAvailableTorchLevel

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

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

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

    Объявление

    Swift

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

    Objective C

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

    Константы

    • Locked

      AVCaptureFocusModeLocked

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

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

    • AutoFocus

      AVCaptureFocusModeAutoFocus

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

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

    • ContinuousAutoFocus

      AVCaptureFocusModeContinuousAutoFocus

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

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

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

    Objective C

    @import AVFoundation;

    Swift

    import AVFoundation

    Доступность

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

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

    Объявление

    Swift

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

    Objective C

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

    Константы

    • Locked

      AVCaptureExposureModeLocked

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

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

    • AutoExpose

      AVCaptureExposureModeAutoExpose

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

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

    • ContinuousAutoExposure

      AVCaptureExposureModeContinuousAutoExposure

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

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

    • Custom

      AVCaptureExposureModeCustom

      Устройство должно только корректироваться, воздействие согласно пользователю обеспечило ISO и exposureDuration значения свойств.

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

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

    Objective C

    @import AVFoundation;

    Swift

    import AVFoundation

    Доступность

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

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

    Объявление

    Swift

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

    Objective C

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

    Константы

    • Locked

      AVCaptureWhiteBalanceModeLocked

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

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

    • AutoWhiteBalance

      AVCaptureWhiteBalanceModeAutoWhiteBalance

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

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

    • ContinuousAutoWhiteBalance

      AVCaptureWhiteBalanceModeContinuousAutoWhiteBalance

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

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

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

    Objective C

    @import AVFoundation;

    Swift

    import AVFoundation

    Доступность

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

  • Константы, предоставляющие информацию относительно разрешения использовать устройства захвата изображения носителей.

    Объявление

    Swift

    enum AVAuthorizationStatus : Int { case NotDetermined case Restricted case Denied case Authorized }

    Objective C

    typedef enum : NSInteger { AVAuthorizationStatusNotDetermined = 0, AVAuthorizationStatusRestricted, AVAuthorizationStatusDenied, AVAuthorizationStatusAuthorized } AVAuthorizationStatus;

    Константы

    • NotDetermined

      AVAuthorizationStatusNotDetermined

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

      Вызвать requestAccessForMediaType:completionHandler: предложить пользователю разрешение или создать AVCaptureDeviceInput поскольку автоматически предложат типу среды и пользователю.

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

    • Restricted

      AVAuthorizationStatusRestricted

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

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

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

    • Denied

      AVAuthorizationStatusDenied

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

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

    • Authorized

      AVAuthorizationStatusAuthorized

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

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

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

    Objective C

    @import AVFoundation;

    Swift

    import AVFoundation

    Доступность

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

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

    Объявление

    Swift

    enum AVCaptureAutoFocusRangeRestriction : Int { case None case Near case Far }

    Objective C

    enum { AVCaptureAutoFocusRangeRestrictionNone = 0, AVCaptureAutoFocusRangeRestrictionNear = 1, AVCaptureAutoFocusRangeRestrictionFar = 2, }; typedef NSInteger AVCaptureAutoFocusRangeRestriction;

    Константы

    • None

      AVCaptureAutoFocusRangeRestrictionNone

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

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

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

    • Near

      AVCaptureAutoFocusRangeRestrictionNear

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

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

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

    • Far

      AVCaptureAutoFocusRangeRestrictionFar

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

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

    Обсуждение

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

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

    Objective C

    @import AVFoundation;

    Swift

    import AVFoundation

    Доступность

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

  • Указывает, что никакое значение не должно быть указано для deviceWhiteBalanceGains параметр setWhiteBalanceModeLockedWithDeviceWhiteBalanceGains:completionHandler:.

    Объявление

    Swift

    let AVCaptureWhiteBalanceGainsCurrent: AVCaptureWhiteBalanceGains

    Objective C

    const AVCaptureWhiteBalanceGains AVCaptureWhiteBalanceGainsCurrent;

    Константы

    • AVCaptureWhiteBalanceGainsCurrent

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

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

  • Указывает, что никакое значение не должно быть указано для lensPosition параметр setFocusModeLockedWithLensPosition:completionHandler:.

    Объявление

    Swift

    let AVCaptureLensPositionCurrent: Float

    Objective C

    const float AVCaptureLensPositionCurrent;

    Константы

    • AVCaptureLensPositionCurrent

      Это значение может быть передано как lensPosition параметр setFocusModeLockedWithLensPosition:completionHandler: указать, что никакое значение не должно быть установлено для lensPosition свойство, и что это должно вместо этого быть установлено в его текущую стоимость.

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

    Обсуждение

    Обратите внимание на то, что устройство может корректироваться lensPosition во время вызова setFocusModeLockedWithLensPosition:completionHandler:, когда то, значение, в который lensPosition заблокирован может отличаться от значения, полученного путем запросов lensPosition свойство.

  • Указывает, что никакое значение не должно быть указано для ISO параметр setExposureModeCustomWithDuration:ISO:completionHandler:.

    Объявление

    Swift

    let AVCaptureISOCurrent: Float

    Objective C

    const float AVCaptureISOCurrent;

    Константы

    • AVCaptureISOCurrent

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

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

    Обсуждение

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

  • Указывает, что никакое значение не должно быть указано для exposureTargetBias параметр setExposureTargetBias:completionHandler:.

    Объявление

    Swift

    let AVCaptureExposureTargetBiasCurrent: Float

    Objective C

    const float AVCaptureExposureTargetBiasCurrent;

    Константы

    • AVCaptureExposureTargetBiasCurrent

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

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

  • Указывает, что никакое значение не должно быть указано для параметра продолжительности setExposureModeCustomWithDuration:ISO:completionHandler:.

    Объявление

    Swift

    let AVCaptureExposureDurationCurrent: CMTime

    Objective C

    const CMTime AVCaptureExposureDurationCurrent;

    Константы

    • AVCaptureExposureDurationCurrent

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

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

    Обсуждение

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

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

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

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

    Objective C

    @import AVFoundation;

    Swift

    import AVFoundation

    Доступность

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

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

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

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

    Objective C

    @import AVFoundation;

    Swift

    import AVFoundation

    Доступность

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

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

    Клиенты могут наблюдать AVCaptureDeviceSubjectAreaDidChangeNotification знать когда экземпляр AVCaptureDevice обнаружил существенные изменения к видео предметной области.

    Это уведомление отправляется только если subjectAreaChangeMonitoringEnabled YEStrue.

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

    Objective C

    @import AVFoundation;

    Swift

    import AVFoundation

    Доступность

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