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];}}}
-
Возвращает массив доступных устройств захвата изображения в системе.
Возвращаемое значение
Массив, содержащий доступные устройства захвата изображения в системе
Оператор импорта
Objective C
@import AVFoundation;Swift
import AVFoundationДоступность
Доступный в iOS 4.0 и позже.
-
Возвращает устройство с данным ID.
Объявление
Swift
init!(uniqueIDdeviceUniqueID: String!) -> AVCaptureDeviceObjective C
+ (AVCaptureDevice *)deviceWithUniqueID:(NSString *)deviceUniqueIDПараметры
deviceUniqueIDID устройства захвата изображения.
Возвращаемое значение
Устройство с 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]!Параметры
mediaTypeИдентификатор типа среды.
Для возможных значений см. Ссылку Констант Основы AV.
Возвращаемое значение
Массив, содержащий устройства, которые в состоянии получать данные типа, обозначенного
mediaType.Оператор импорта
Objective C
@import AVFoundation;Swift
import AVFoundationДоступность
Доступный в iOS 4.0 и позже.
-
Запрашивает разрешение пользователя, в случае необходимости, для записи указанного типа среды.
Объявление
Swift
class func requestAccessForMediaType(_mediaType: String!, completionHandlerhandler: ((Bool) -> Void)!)Objective C
+ (void)requestAccessForMediaType:(NSString *)mediaTypecompletionHandler:(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!) -> AVAuthorizationStatusObjective 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) -> BoolObjective C
- (BOOL)lockForConfiguration:(NSError **)outErrorПараметры
outErrorНа вводе укажите указатель на ошибочный объект. Если блокировка не может быть получена, этот указатель содержит
NSErrorобъект, описывающий проблему. Можно указатьnilдля этого свойства.Возвращаемое значение
YEStrueесли блокировка была получена илиNOfalseесли это не было.Обсуждение
Необходимо вызвать этот метод прежде, чем попытаться сконфигурировать связанные с аппаратными средствами свойства устройства. Этот метод возвраты
YEStrueкогда это успешно блокирует устройство для конфигурации Вашим кодом. После конфигурирования свойств устройства вызватьunlockForConfigurationвыпустить блокировку конфигурации и позволить другим приложениям вносить изменения.Можно содержать на блокировку (вместо того, чтобы выпустить его), если Вы требуете, чтобы свойства устройства остались неизменными. Однако содержание блокировки устройства излишне может ухудшить качество получения в других приложениях, совместно использующих устройство.
Оператор импорта
Objective C
@import AVFoundation;Swift
import AVFoundationДоступность
Доступный в iOS 4.0 и позже.
См. также
-
Оставляет монопольное управление конфигурацией устройства.
Объявление
Swift
func unlockForConfiguration()Objective C
- (void)unlockForConfigurationОбсуждение
Вызовите этот метод для выпуска полученного использования блокировки
lockForConfiguration:метод, когда Вы сделаны, конфигурируя устройство.Оператор импорта
Objective C
@import AVFoundation;Swift
import AVFoundationДоступность
Доступный в iOS 4.0 и позже.
См. также
-
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СвойствоВ настоящее время активный формат получателя.
Объявление
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: AVCaptureFocusModeObjective C
@property(nonatomic) AVCaptureFocusMode focusModeОбсуждение
Прежде, чем изменить значение этого свойства, необходимо вызвать
lockForConfiguration:получать эксклюзивный доступ к свойствам конфигурации устройства. Иначе, установка значения этого свойства повышает исключение. Когда Вы будете сделаны, конфигурируя устройство, вызватьunlockForConfigurationвыпустить блокировку и позволить другим устройствам конфигурировать настройки.Можно наблюдать изменения в значении этого свойства с помощью наблюдения Значения ключа.
Посмотрите AVCaptureFocusMode для возможных значений.
Оператор импорта
Objective C
@import AVFoundation;Swift
import AVFoundationДоступность
Доступный в iOS 4.0 и позже.
-
Возвращает булево значение, указывающее, поддерживается ли данный режим фокуса.
Объявление
Swift
func isFocusModeSupported(_focusMode: AVCaptureFocusMode) -> BoolObjective C
- (BOOL)isFocusModeSupported:(AVCaptureFocusMode)focusModeПараметры
focusModeРежим фокуса. Посмотрите AVCaptureFocusMode для возможных значений.
Возвращаемое значение
YEStrueеслиfocusModeподдерживается, иначеNOfalse.Оператор импорта
Objective C
@import AVFoundation;Swift
import AVFoundationДоступность
Доступный в iOS 4.0 и позже.
-
focusPointOfInterestСвойствоИнтересное место для фокусировки.
Объявление
Swift
var focusPointOfInterest: CGPointObjective C
@property(nonatomic) CGPoint focusPointOfInterestОбсуждение
Это свойство представляет a
CGPointгде{0,0}соответствует верхней левой из области изображения, и{1,1}соответствует нижнему правому в альбомном режиме с кнопкой «Домой» справа — это применяется, даже если устройство находится в режиме портрета.Прежде, чем изменить значение этого свойства, необходимо вызвать
lockForConfiguration:получать эксклюзивный доступ к свойствам конфигурации устройства. Иначе, установка значения этого свойства повышает исключение. Когда Вы будете сделаны, конфигурируя устройство, вызватьunlockForConfigurationвыпустить блокировку и позволить другим устройствам конфигурировать настройки.Оператор импорта
Objective C
@import AVFoundation;Swift
import AVFoundationДоступность
Доступный в iOS 4.0 и позже.
См. также
-
focusPointOfInterestSupportedСвойствоУказывает, поддерживает ли устройство интересное место для фокуса. (только для чтения)
Объявление
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: BoolObjective 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: AVCaptureAutoFocusRangeRestrictionObjective C
@property(nonatomic) AVCaptureAutoFocusRangeRestriction autoFocusRangeRestrictionОбсуждение
По умолчанию устройство, способное к аппаратной фокусировке, пытается фокусироваться на объектах на любом расстоянии. Если Вы ожидаете фокусироваться прежде всего на близких или далеких объектах, установите ограничение диапазона, чтобы увеличить скорость и сократить потребляемую мощность автоматической фокусировки и сократить шанс фокусирующихся случаев неоднозначности.
Прежде, чем изменить значение этого свойства, необходимо вызвать
lockForConfiguration:получать эксклюзивный доступ к свойствам конфигурации устройства. Иначе, установка значения этого свойства повышает исключение. Когда Вы будете сделаны, конфигурируя устройство, вызватьunlockForConfigurationвыпустить блокировку и позволить другим устройствам конфигурировать настройки.Оператор импорта
Objective C
@import AVFoundation;Swift
import AVFoundationДоступность
Доступный в iOS 7.0 и позже.
-
autoFocusRangeRestrictionSupportedСвойствоБулево значение, указывающее, поддерживает ли устройство ограничения диапазона фокусировки. (только для чтения)
Объявление
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: AVCaptureExposureModeObjective C
@property(nonatomic) AVCaptureExposureMode exposureModeОбсуждение
Прежде, чем изменить значение этого свойства, необходимо вызвать
lockForConfiguration:получать эксклюзивный доступ к свойствам конфигурации устройства. Иначе, установка значения этого свойства повышает исключение. Когда Вы будете сделаны, конфигурируя устройство, вызватьunlockForConfigurationвыпустить блокировку и позволить другим устройствам конфигурировать настройки.Можно наблюдать изменения в значении этого свойства с помощью наблюдения Значения ключа.
Посмотрите AVCaptureExposureMode для возможных значений.
Оператор импорта
Objective C
@import AVFoundation;Swift
import AVFoundationДоступность
Доступный в iOS 4.0 и позже.
-
Возвращает булево значение, указывающее, поддерживается ли данный режим воздействия.
Объявление
Swift
func isExposureModeSupported(_exposureMode: AVCaptureExposureMode) -> BoolObjective C
- (BOOL)isExposureModeSupported:(AVCaptureExposureMode)exposureModeПараметры
exposureModeРежим воздействия. Посмотрите AVCaptureExposureMode для возможных значений.
Возвращаемое значение
YEStrueеслиexposureModeподдерживается, иначеNOfalse.Оператор импорта
Objective C
@import AVFoundation;Swift
import AVFoundationДоступность
Доступный в iOS 4.0 и позже.
См. также
-
exposurePointOfInterestСвойствоИнтересное место для воздействия.
Объявление
Swift
var exposurePointOfInterest: CGPointObjective C
@property(nonatomic) CGPoint exposurePointOfInterestОбсуждение
Прежде, чем изменить значение этого свойства, необходимо вызвать
lockForConfiguration:получать эксклюзивный доступ к свойствам конфигурации устройства. Иначе, установка значения этого свойства повышает исключение. Когда Вы будете сделаны, конфигурируя устройство, вызватьunlockForConfigurationвыпустить блокировку и позволить другим устройствам конфигурировать настройки.Оператор импорта
Objective C
@import AVFoundation;Swift
import AVFoundationДоступность
Доступный в iOS 4.0 и позже.
-
exposurePointOfInterestSupportedСвойствоУказывает, поддерживает ли устройство интересное место для воздействия. (только для чтения)
Объявление
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) -> BoolObjective C
- (BOOL)isWhiteBalanceModeSupported:(AVCaptureWhiteBalanceMode)whiteBalanceModeПараметры
whiteBalanceModeРежим фокуса. Посмотрите AVCaptureWhiteBalanceMode для возможных значений.
Возвращаемое значение
YEStrueеслиwhiteBalanceModeподдерживается, иначеNOfalse.Оператор импорта
Objective C
@import AVFoundation;Swift
import AVFoundationДоступность
Доступный в iOS 4.0 и позже.
См. также
-
whiteBalanceModeСвойствоТекущий режим баланса белого.
Объявление
Swift
var whiteBalanceMode: AVCaptureWhiteBalanceModeObjective 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: CGFloatObjective 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 и позже.
См. также
-
Начинает плавный переход от текущего фактора изменения масштаба до другого.
Объявление
Swift
func rampToVideoZoomFactor(_factor: CGFloat, withRaterate: Float)Objective C
- (void)rampToVideoZoomFactor:(CGFloat)factorwithRate:(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 и позже.
См. также
-
Гладко заканчивает происходящий переход изменения масштаба.
Объявление
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: AVCaptureFlashModeObjective C
@property(nonatomic) AVCaptureFlashMode flashModeОбсуждение
Прежде, чем изменить значение этого свойства, необходимо вызвать
lockForConfiguration:получать эксклюзивный доступ к свойствам конфигурации устройства. Иначе, установка значения этого свойства повышает исключение. Когда Вы будете сделаны, конфигурируя устройство, вызватьunlockForConfigurationвыпустить блокировку и позволить другим устройствам конфигурировать настройки.Можно наблюдать изменения в значении этого свойства с помощью наблюдения значения ключа.
Посмотрите AVCaptureFlashMode для возможных значений.
Оператор импорта
Objective C
@import AVFoundation;Swift
import AVFoundationДоступность
Доступный в iOS 4.0 и позже.
-
Возвращает булево значение, указывающее, поддерживается ли данный режим флэш-памяти.
Объявление
Swift
func isFlashModeSupported(_flashMode: AVCaptureFlashMode) -> BoolObjective C
- (BOOL)isFlashModeSupported:(AVCaptureFlashMode)flashModeПараметры
flashModeРежим флэш-памяти. Посмотрите AVCaptureFlashMode для возможных значений.
Возвращаемое значение
YEStrueеслиflashModeподдерживается, иначеNOfalse.Оператор импорта
Objective C
@import AVFoundation;Swift
import AVFoundationДоступность
Доступный в iOS 4.0 и позже.
-
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 и позже.
См. также
-
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 и позже.
См. также
-
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 и позже.
См. также
-
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) -> BoolObjective C
- (BOOL)isTorchModeSupported:(AVCaptureTorchMode)torchModeПараметры
torchModeЖелаемый режим факела. Для списка возможных значений посмотрите AVCaptureTorchMode.
Возвращаемое значение
YEStrueеслиtorchModeподдерживается, иначеNOfalse.Оператор импорта
Objective C
@import AVFoundation;Swift
import AVFoundationДоступность
Доступный в iOS 4.0 и позже.
См. также
-
torchModeСвойствоТекущий режим факела.
Объявление
Swift
var torchMode: AVCaptureTorchModeObjective C
@property(nonatomic) AVCaptureTorchMode torchModeОбсуждение
Установка значения этого свойства также устанавливает уровень факела в свое значение максимального тока.
Прежде, чем установить значение этого свойства, вызовите
isTorchModeSupported:метод для проверки устройства поддерживает желаемый режим. Установка устройства к неподдерживаемому режиму факела приводит к повышению исключения. Для списка возможных значений для этого свойства посмотрите AVCaptureTorchMode.Прежде, чем изменить значение этого свойства, необходимо вызвать
lockForConfiguration:получать эксклюзивный доступ к свойствам конфигурации устройства. Иначе, установка значения этого свойства повышает исключение. Когда Вы будете сделаны, конфигурируя устройство, вызватьunlockForConfigurationвыпустить блокировку и позволить другим устройствам конфигурировать настройки.Можно наблюдать изменения в значении этого свойства с помощью наблюдения значения ключа.
Оператор импорта
Objective C
@import AVFoundation;Swift
import AVFoundationДоступность
Доступный в iOS 4.0 и позже.
См. также
-
Устанавливает уровень освещения когда в режиме факела.
Объявление
Swift
func setTorchModeOnWithLevel(_torchLevel: Float, erroroutError: NSErrorPointer) -> BoolObjective C
- (BOOL)setTorchModeOnWithLevel:(float)torchLevelerror:(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: BoolObjective C
@property(nonatomic) BOOL automaticallyEnablesLowLightBoostWhenAvailableОбсуждение
На
AVCaptureDeviceобъект, гдеlowLightBoostSupportedYEStrue, специальный режим повышения недостаточной освещенности может быть занят для улучшения качества изображения. КогдаautomaticallyEnablesLowLightBoostWhenAvailableсвойство установлено вYEStrue, устройство захвата изображения переключается по его усмотрению на специальный режим повышения под недостаточной освещенностью. Когда сцена становится достаточно освещенной, переключатели устройства назад к нормальному функционированию.AVCaptureDeviceэто поддерживает эту функцию, может только затронуть режим повышения для определенных исходных форматов или разрешений.Значение по умолчанию этого свойства
NOfalse. Установка этого свойства бросаетNSInvalidArgumentExceptionеслиlowLightBoostSupportedNOfalse.AVCaptureDeviceобъект должен быть заблокирован для использования конфигурацииlockForConfiguration:прежде чем клиенты могут установить этот метод, иначеNSGenericExceptionброшен.Клиенты могут наблюдать изменения в
lowLightBoostEnabledсвойство с помощью наблюдения значения ключа для знания, когда привлекается режим повышения. Переключатель между нормальным функционированием и режимом повышения недостаточной освещенности может отбросить один или несколько видеокадров.Оператор импорта
Objective C
@import AVFoundation;Swift
import AVFoundationДоступность
Доступный в iOS 6.0 и позже.
-
activeVideoMinFrameDurationСвойствоВ настоящее время активная минимальная продолжительность кадра.
Объявление
Swift
var activeVideoMinFrameDuration: CMTimeObjective C
@property(nonatomic) CMTime activeVideoMinFrameDurationОбсуждение
Минимальная продолжительность кадра устройства является обратной величиной своей максимальной частоты кадров. Можно установить значение этого свойства для ограничения максимальной частоты кадров во время сеанса получения. Устройство захвата изображения автоматически выбирает минимальную продолжительность кадра по умолчанию на основе своего активного формата. После изменения значения этого свойства можно возвратиться к минимальной продолжительности кадра по умолчанию путем установки значения этого свойства в
kCMTimeInvalid. Выбор новой предварительной установки для сеанса получения также сбрасывает это свойство к своему значению по умолчанию.Попытка установить это свойство в значение, не найденное в активном формате
videoSupportedFrameRateRangesвыстройте повышает исключение (NSInvalidArgumentException).Прежде, чем изменить значение этого свойства, необходимо вызвать
lockForConfiguration:получать эксклюзивный доступ к свойствам конфигурации устройства. Иначе, установка значения этого свойства повышает исключение. Когда Вы будете сделаны, конфигурируя устройство, вызватьunlockForConfigurationвыпустить блокировку и позволить другим устройствам конфигурировать настройки.Можно наблюдать изменения в значении этого свойства с помощью наблюдения значения ключа.
Оператор импорта
Objective C
@import AVFoundation;Swift
import AVFoundationДоступность
Доступный в iOS 7.0 и позже.
См. также
-
activeVideoMaxFrameDurationСвойствоВ настоящее время активная максимальная продолжительность кадра
Объявление
Swift
var activeVideoMaxFrameDuration: CMTimeObjective C
@property(nonatomic) CMTime activeVideoMaxFrameDurationОбсуждение
Максимальная продолжительность кадра устройства является обратной величиной своей минимальной частоты кадров. Можно установить значение этого свойства для ограничения минимальной частоты кадров во время сеанса получения. Устройство захвата изображения автоматически выбирает максимальную продолжительность кадра по умолчанию на основе своего активного формата. После изменения значения этого свойства можно возвратиться к максимальной продолжительности кадра по умолчанию путем установки значения этого свойства в
kCMTimeInvalid. Выбор новой предварительной установки для сеанса получения также сбрасывает это свойство к своему значению по умолчанию.Попытка установить это свойство в значение, не найденное в активном формате
videoSupportedFrameRateRangesвыстройте повышает исключение (NSInvalidArgumentException).Прежде, чем изменить значение этого свойства, необходимо вызвать
lockForConfiguration:получать эксклюзивный доступ к свойствам конфигурации устройства. Иначе, установка значения этого свойства повышает исключение. Когда Вы будете сделаны, конфигурируя устройство, вызватьunlockForConfigurationвыпустить блокировку и позволить другим устройствам конфигурировать настройки.Можно наблюдать изменения в значении этого свойства с помощью наблюдения значения ключа.
Оператор импорта
Objective C
@import AVFoundation;Swift
import AVFoundationДоступность
Доступный в iOS 7.0 и позже.
См. также
-
subjectAreaChangeMonitoringEnabledСвойствоУказывает, должно ли устройство контролировать предметную область для изменений.
Объявление
Swift
var subjectAreaChangeMonitoringEnabled: BoolObjective C
@property(nonatomic, getter=isSubjectAreaChangeMonitoringEnabled) BOOL subjectAreaChangeMonitoringEnabledОбсуждение
Значение этого свойства указывает, должен ли получатель контролировать видео предметную область для изменений, таких как освещение изменений, существенного перемещения, и т.д. Если контроль изменения предметной области включен, объект устройства захвата изображения отправляет
AVCaptureDeviceSubjectAreaDidChangeNotificationкаждый раз, когда это обнаруживает изменение в предметной области, в котором времени заинтересованный клиент может хотеть перефокусировать, скорректировать воздействие, баланс белого, и т.д.Прежде, чем изменить значение этого свойства, необходимо вызвать
lockForConfiguration:получать эксклюзивный доступ к свойствам конфигурации устройства. Иначе, установка значения этого свойства повышает исключение. Когда Вы будете сделаны, конфигурируя устройство, вызватьunlockForConfigurationвыпустить блокировку и позволить другим устройствам конфигурировать настройки.Можно наблюдать изменения в значении этого свойства с помощью наблюдения значения ключа.
Оператор импорта
Objective C
@import AVFoundation;Swift
import AVFoundationДоступность
Доступный в iOS 5.0 и позже.
См. также
-
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!) -> BoolObjective 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 и позже.
См. также
-
Возвращает булево значение, указывающее, может ли получатель использоваться в сеансе получения, сконфигурированном с данной предварительной установкой.
Объявление
Swift
func supportsAVCaptureSessionPreset(_preset: String!) -> BoolObjective 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 и позже.
-
setFocusModeLockedWithLensPosition (_: completionHandler:) - setFocusModeLockedWithLensPosition:completionHandler:Блокирует позицию линзы в указанном значении.
Объявление
Swift
func setFocusModeLockedWithLensPosition(_lensPosition: Float, completionHandlerhandler: ((CMTime) -> Void)!)Objective C
- (void)setFocusModeLockedWithLensPosition:(float)lensPositioncompletionHandler:(void (^)(CMTime syncTime))handlerПараметры
lensPositionПозиция линзы. Значение
AVCaptureLensPositionCurrentможет использоваться, чтобы указать, что вызывающая сторона не хочет указывать значение для lensPosition.handlerБлок, который вызывают когда
lensPositionбыл установлен в указанное значение иfocusModeAVCaptureFocusModeLocked. Блок получает метку времени, соответствующую метку времени первого буфера, к которому были применены все настройки.Обратите внимание на то, что метка времени синхронизируется с часами устройства, и таким образом должна быть преобразована в основной тактовый генератор до сравнения с метками времени буферов, поставленных экземпляром 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 и позже.
-
setExposureModeCustomWithDuration (_: ISO:completionHandler:) - setExposureModeCustomWithDuration:ISO:completionHandler:Блокирует продолжительность воздействия и ISO в указанных значениях.
Объявление
Параметры
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Обсуждение
Когда
exposureModeAVCaptureExposureModeAutoExposeили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, completionHandlerhandler: ((CMTime) -> Void)!)Objective C
- (void)setExposureTargetBias:(float)biascompletionHandler:(void (^)(CMTime syncTime))handlerПараметры
biasСмещение, которое будет применено к целевому значению воздействия.
handlerБлок, который вызовут, когда
exposureTargetBiasсвойство было установлено в указанное значение.Блок получает метку времени, соответствующую метку времени первого буфера, к которому была применена установка. Метка времени синхронизируется с часами устройства, и таким образом должна быть преобразована в основной тактовый генератор до сравнения с метками времени буферов, поставленных через
AVCaptureVideoDataOutputэкземпляр.Клиент может передать
nilдля параметра обработчика, если не требуется знание завершения работы.Обсуждение
Этот метод является единственным способом установить
exposureTargetBiasсвойство.Этот метод бросает
NSInvalidArgumentExceptionисключение, еслиexposureTargetBiasустановлен в неподдерживаемый уровень.NSGenericExceptionесли этот метод вызывается без первого эксклюзивного доступа получения к использованию получателя, исключение выдаетсяlockForConfiguration:.Оператор импорта
Objective C
@import AVFoundation;Swift
import AVFoundationДоступность
Доступный в iOS 8.0 и позже.
См. также
-
Преобразовывает специфичные для устройства значения усиления RGB баланса белого в независящие от устройств значения цветности.
Объявление
Swift
func chromaticityValuesForDeviceWhiteBalanceGains(_whiteBalanceGains: AVCaptureWhiteBalanceGains) -> AVCaptureWhiteBalanceChromaticityValuesObjective 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) -> AVCaptureWhiteBalanceGainsObjective 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 и позже.
-
deviceWhiteBalanceGainsForTemperatureAndTintValues (_:) - deviceWhiteBalanceGainsForTemperatureAndTintValues:Преобразовывает независящую от устройств температуру, и оттенок оценивает специфичным для устройства значениям усиления RGB баланса белого.
Объявление
Swift
func deviceWhiteBalanceGainsForTemperatureAndTintValues(_tempAndTintValues: AVCaptureWhiteBalanceTemperatureAndTintValues) -> AVCaptureWhiteBalanceGainsObjective C
- (AVCaptureWhiteBalanceGains)deviceWhiteBalanceGainsForTemperatureAndTintValues:(AVCaptureWhiteBalanceTemperatureAndTintValues)tempAndTintValuesПараметры
tempAndTintValuesAVCaptureWhiteBalanceTemperatureAndTintValuesструктура, содержащая температуру и значения оттенка.Возвращаемое значение
Полностью заполненный
AVCaptureWhiteBalanceGainsструктура, содержащая специфичные для устройства значения усиления RGB.Обсуждение
Этот метод вызывается для преобразования независящей от устройств температуры, и оттенок оценивает специфичным для устройства значениям усиления баланса белого RGB.
Можно передать любую температуру и окрасить значения, и будут произведены соответствующие усиления баланса белого. Отметьте, хотя та некоторая температура и окрашивает устройство дохода комбинаций из диапазона значения RGB, которые заставят исключение быть брошенным, если передано непосредственно в
setWhiteBalanceModeLockedWithDeviceWhiteBalanceGains:completionHandler:. Обязательно проверьте, что красные, зеленые, и синие значения усиления в диапазоне [1.0-maxWhiteBalanceGain].Оператор импорта
Objective C
@import AVFoundation;Swift
import AVFoundationДоступность
Доступный в iOS 8.0 и позже.
-
grayWorldDeviceWhiteBalanceGainsСвойствоТекущий специфичный для устройства серый мировой баланс белого 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 и позже.
-
setWhiteBalanceModeLockedWithDeviceWhiteBalanceGains (_: completionHandler:) - setWhiteBalanceModeLockedWithDeviceWhiteBalanceGains:completionHandler:Баланс белого наборов к режиму захвата с указанными значениями deviceWhiteBalanceGains.
Объявление
Swift
func setWhiteBalanceModeLockedWithDeviceWhiteBalanceGains(_whiteBalanceGains: AVCaptureWhiteBalanceGains, completionHandlerhandler: ((CMTime) -> Void)!)Objective C
- (void)setWhiteBalanceModeLockedWithDeviceWhiteBalanceGains:(AVCaptureWhiteBalanceGains)whiteBalanceGainscompletionHandler:(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 и позже.
-
temperatureAndTintValuesForDeviceWhiteBalanceGains (_:) - temperatureAndTintValuesForDeviceWhiteBalanceGains:Преобразовывает специфичные для устройства значения усиления RGB баланса белого в независящую от устройств температуру и значения оттенка.
Объявление
Swift
func temperatureAndTintValuesForDeviceWhiteBalanceGains(_whiteBalanceGains: AVCaptureWhiteBalanceGains) -> AVCaptureWhiteBalanceTemperatureAndTintValuesObjective 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 и позже.
-
automaticallyAdjustsVideoHDREnabledСвойствоБулево значение, указывающее, позволяют ли устройству захвата изображения включить или выключить потоковую передачу расширенного динамического диапазона.
Объявление
Swift
var automaticallyAdjustsVideoHDREnabled: BoolObjective 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: BoolObjective 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;Константы
-
UnspecifiedAVCaptureDevicePositionUnspecifiedПозиция устройства захвата изображения относительно оборудования системы является неуказанной.
Доступный в iOS 4.0 и позже.
-
BackAVCaptureDevicePositionBackУстройство захвата изображения в конце модуля.
Доступный в iOS 4.0 и позже.
-
FrontAVCaptureDevicePositionFrontУстройство захвата изображения находится на передней стороне модуля.
Доступный в 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;Константы
-
OffAVCaptureFlashModeOffФлэш-память устройства захвата изображения всегда выключена.
Доступный в iOS 4.0 и позже.
-
OnAVCaptureFlashModeOnФлэш-память устройства захвата изображения всегда включена.
Доступный в iOS 4.0 и позже.
-
AutoAVCaptureFlashModeAutoУстройство захвата изображения постоянно контролирует легкие уровни и использует флэш-память при необходимости.
Доступный в 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;Константы
-
OffAVCaptureTorchModeOffФакел устройства захвата изображения всегда выключен.
Доступный в iOS 4.0 и позже.
-
OnAVCaptureTorchModeOnФакел устройства захвата изображения всегда включен.
Доступный в iOS 4.0 и позже.
-
AutoAVCaptureTorchModeAutoУстройство захвата изображения постоянно контролирует легкие уровни и использует факел при необходимости.
Доступный в iOS 4.0 и позже.
Оператор импорта
Objective C
@import AVFoundation;Swift
import AVFoundationДоступность
Доступный в iOS 4.0 и позже.
-
-
Максимальный уровень факела.
Объявление
Swift
let AVCaptureMaxAvailableTorchLevel: FloatObjective 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;Константы
-
LockedAVCaptureFocusModeLockedФокус заблокирован.
Доступный в iOS 4.0 и позже.
-
AutoFocusAVCaptureFocusModeAutoFocusУстройство захвата изображения выполняет работу автофокуса теперь.
Доступный в iOS 4.0 и позже.
-
ContinuousAutoFocusAVCaptureFocusModeContinuousAutoFocusУстройство захвата изображения постоянно контролирует фокус и автофокус при необходимости.
Доступный в 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;Константы
-
LockedAVCaptureExposureModeLockedУстановка воздействия заблокирована.
Доступный в iOS 4.0 и позже.
-
AutoExposeAVCaptureExposureModeAutoExposeУстройство автоматически корректирует воздействие один раз и затем изменяет режим воздействия на
AVCaptureExposureModeLocked.Доступный в iOS 4.0 и позже.
-
ContinuousAutoExposureAVCaptureExposureModeContinuousAutoExposureУстройство постоянно контролирует уровни воздействия, и автоматический представляет при необходимости.
Доступный в iOS 4.0 и позже.
-
CustomAVCaptureExposureModeCustomУстройство должно только корректироваться, воздействие согласно пользователю обеспечило
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;Константы
-
LockedAVCaptureWhiteBalanceModeLockedУстановка баланса белого заблокирована.
Доступный в iOS 4.0 и позже.
-
AutoWhiteBalanceAVCaptureWhiteBalanceModeAutoWhiteBalanceУстройство выполняет автоматическую работу баланса белого теперь.
Доступный в iOS 4.0 и позже.
-
ContinuousAutoWhiteBalanceAVCaptureWhiteBalanceModeContinuousAutoWhiteBalanceУстройство постоянно контролирует баланс белого и корректируется при необходимости.
Доступный в 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;Константы
-
NotDeterminedAVAuthorizationStatusNotDeterminedЯвные полномочия пользователя требуются для получения носителей, но пользователь еще не предоставил или отклонил такое разрешение.
Вызвать
requestAccessForMediaType:completionHandler:предложить пользователю разрешение или создатьAVCaptureDeviceInputпоскольку автоматически предложат типу среды и пользователю.Доступный в iOS 7.0 и позже.
-
RestrictedAVAuthorizationStatusRestrictedПользователю не разрешают получить доступ к устройствам захвата изображения носителей.
Это состояние обычно не видимо —
AVCaptureDeviceметоды класса для обнаружения устройств не возвращают устройства, пользователь ограничивается в доступе.Доступный в iOS 7.0 и позже.
-
DeniedAVAuthorizationStatusDeniedПользователь явно отклонил разрешение для получения носителей.
Доступный в iOS 7.0 и позже.
-
AuthorizedAVAuthorizationStatusAuthorizedПользователь явно дал разрешение для получения носителей, или явные полномочия пользователя не необходимы для рассматриваемого типа среды.
Доступный в 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;Константы
-
NoneAVCaptureAutoFocusRangeRestrictionNoneУстройство пытается фокусироваться на объектах в любом диапазоне.
Это значение является значением по умолчанию и единственным значением, позволенным на устройствах, не поддерживающих ограничение диапазона фокусировки.
Доступный в iOS 7.0 и позже.
-
NearAVCaptureAutoFocusRangeRestrictionNearУстройство прежде всего пытается фокусироваться на предметах около камеры.
Это значение рекомендуется для приложений то использование
AVCaptureMetadataOutputраспознать машиночитаемые коды.Доступный в iOS 7.0 и позже.
-
FarAVCaptureAutoFocusRangeRestrictionFarУстройство прежде всего пытается фокусироваться на предметах далеко от камеры.
Доступный в iOS 7.0 и позже.
Обсуждение
Если Вы ожидаете фокусироваться прежде всего на близких или далеких объектах, можно использовать
autoFocusRangeRestrictionсвойство для обеспечения подсказки для фокусирующейся системы. Этот подход делает автофокус быстрее, больше питания эффективный, и менее подверженный ошибкам. Если устройство не находит фокуса в том диапазоне, ограничение приоритезирует фокусировку на расстояниях в указанном диапазоне, но не предотвращает фокусировку в другом месте.Оператор импорта
Objective C
@import AVFoundation;Swift
import AVFoundationДоступность
Доступный в iOS 7.0 и позже.
-
-
Указывает, что никакое значение не должно быть указано для
deviceWhiteBalanceGainsпараметрsetWhiteBalanceModeLockedWithDeviceWhiteBalanceGains:completionHandler:.Объявление
Swift
let AVCaptureWhiteBalanceGainsCurrent: AVCaptureWhiteBalanceGainsObjective C
const AVCaptureWhiteBalanceGains AVCaptureWhiteBalanceGainsCurrent;Константы
-
AVCaptureWhiteBalanceGainsCurrentЭто значение может быть передано как
deviceWhiteBalanceGainsпараметрsetWhiteBalanceModeLockedWithDeviceWhiteBalanceGains:completionHandler:указать, что вызывающая сторона не хочет указывать значение дляdeviceWhiteBalanceGains, и это получает, должен вместо этого быть заблокирован в их значении в данный момент, что заблокирован баланс белого.Доступный в iOS 8.0 и позже.
-
-
Указывает, что никакое значение не должно быть указано для
lensPositionпараметрsetFocusModeLockedWithLensPosition:completionHandler:.Объявление
Swift
let AVCaptureLensPositionCurrent: FloatObjective C
const float AVCaptureLensPositionCurrent;Константы
-
AVCaptureLensPositionCurrentЭто значение может быть передано как
lensPositionпараметрsetFocusModeLockedWithLensPosition:completionHandler:указать, что никакое значение не должно быть установлено дляlensPositionсвойство, и что это должно вместо этого быть установлено в его текущую стоимость.Доступный в iOS 8.0 и позже.
Обсуждение
Обратите внимание на то, что устройство может корректироваться
lensPositionво время вызоваsetFocusModeLockedWithLensPosition:completionHandler:, когда то, значение, в которыйlensPositionзаблокирован может отличаться от значения, полученного путем запросовlensPositionсвойство. -
-
Указывает, что никакое значение не должно быть указано для
ISOпараметрsetExposureModeCustomWithDuration:ISO:completionHandler:.Объявление
Swift
let AVCaptureISOCurrent: FloatObjective C
const float AVCaptureISOCurrent;Константы
-
AVCaptureISOCurrentЭто значение указывает, что вызывающая сторона не хочет указывать значение для
ISOсвойство, и что это должно вместо этого быть установлено в его текущую стоимость.Доступный в iOS 8.0 и позже.
-
-
Указывает, что никакое значение не должно быть указано для
exposureTargetBiasпараметрsetExposureTargetBias:completionHandler:.Объявление
Swift
let AVCaptureExposureTargetBiasCurrent: FloatObjective C
const float AVCaptureExposureTargetBiasCurrent;Константы
-
AVCaptureExposureTargetBiasCurrentЭто значение указывает, что вызывающая сторона не хочет указывать значение для
exposureTargetBiasсвойство, и что это должно вместо этого быть установлено в его текущую стоимость.Доступный в iOS 8.0 и позже.
-
-
Указывает, что никакое значение не должно быть указано для параметра продолжительности
setExposureModeCustomWithDuration:ISO:completionHandler:.Объявление
Swift
let AVCaptureExposureDurationCurrent: CMTimeObjective 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обнаружил существенные изменения к видео предметной области.Это уведомление отправляется только если
subjectAreaChangeMonitoringEnabledYEStrue.Оператор импорта
Objective C
@import AVFoundation;Swift
import AVFoundationДоступность
Доступный в iOS 5.0 и позже.
