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!(uniqueID
deviceUniqueID
: String!) -> AVCaptureDeviceObjective 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]!Параметры
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 *)
mediaType
completionHandler:(void (^)(BOOL granted))handler
Параметры
mediaType
Постоянный тип среды, также
AVMediaTypeVideo
илиAVMediaTypeAudio
. Если какой-либо тип среды предоставляется,NSInvalidArgumentException
будет брошен.handler
Блок, который вызовут один раз разрешение, предоставляют или отклоняют.
Обработчик завершения вызывают на произвольной очереди отгрузки. Он ответственность клиента гарантировать, что любые UIKit-связанные обновления вызывают на основной очереди или основном потоке в результате.
Блок получает следующий параметр:
granted
Если пользователь дает разрешение использовать аппаратные средства
YES
true
возвращается; иначеNO
false
. Блок сразу возвратится.Обсуждение
Запись аудио всегда требует явного разрешения от пользователя; запись видео также требует полномочий пользователя на устройствах, проданных в определенных областях. В первый раз Вы создаете любого
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
для этого свойства.Возвращаемое значение
YES
true
если блокировка была получена илиNO
false
если это не было.Обсуждение
Необходимо вызвать этот метод прежде, чем попытаться сконфигурировать связанные с аппаратными средствами свойства устройства. Этот метод возвраты
YES
true
когда это успешно блокирует устройство для конфигурации Вашим кодом. После конфигурирования свойств устройства вызвать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: 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) -> BoolObjective C
- (BOOL)isFocusModeSupported:(AVCaptureFocusMode)
focusMode
Параметры
focusMode
Режим фокуса. Посмотрите AVCaptureFocusMode для возможных значений.
Возвращаемое значение
YES
true
еслиfocusMode
поддерживается, иначеNO
false
.Оператор импорта
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 и позже.
См. также
-
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: 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
Обсуждение
Гладкий режим фокусировки доступен только на совместимых устройствах. Если значение этого свойства
NO
false
, установка значенияsmoothAutoFocusEnabled
кYES
true
повышает исключение.Оператор импорта
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 и позже.
-
autoFocusRangeRestrictionSupported
СвойствоБулево значение, указывающее, поддерживает ли устройство ограничения диапазона фокусировки. (только для чтения)
Объявление
Swift
var autoFocusRangeRestrictionSupported: Bool { get }
Objective C
@property(nonatomic, readonly, getter=isAutoFocusRangeRestrictionSupported) BOOL autoFocusRangeRestrictionSupported
Обсуждение
Ограничение диапазона фокусировки доступно только на совместимых устройствах. Если значение этого свойства
NO
false
, установка значения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) -> BoolObjective C
- (BOOL)isExposureModeSupported:(AVCaptureExposureMode)
exposureMode
Параметры
exposureMode
Режим воздействия. Посмотрите AVCaptureExposureMode для возможных значений.
Возвращаемое значение
YES
true
еслиexposureMode
поддерживается, иначеNO
false
.Оператор импорта
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 и позже.
-
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 для возможных значений.
Возвращаемое значение
YES
true
еслиwhiteBalanceMode
поддерживается, иначеNO
false
.Оператор импорта
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 и позже.
См. также
-
Начинает плавный переход от текущего фактора изменения масштаба до другого.
Объявление
Swift
func rampToVideoZoomFactor(_
factor
: CGFloat, withRaterate
: 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 и позже.
См. также
-
Гладко заканчивает происходящий переход изменения масштаба.
Объявление
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) -> BoolObjective C
- (BOOL)isFlashModeSupported:(AVCaptureFlashMode)
flashMode
Параметры
flashMode
Режим флэш-памяти. Посмотрите AVCaptureFlashMode для возможных значений.
Возвращаемое значение
YES
true
еслиflashMode
поддерживается, иначеNO
false
.Оператор импорта
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.
Возвращаемое значение
YES
true
еслиtorchMode
поддерживается, иначеNO
false
.Оператор импорта
Objective C
@import AVFoundation;
Swift
import AVFoundation
Доступность
Доступный в iOS 4.0 и позже.
См. также
-
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 и позже.
См. также
-
Устанавливает уровень освещения когда в режиме факела.
Объявление
Swift
func setTorchModeOnWithLevel(_
torchLevel
: Float, erroroutError
: NSErrorPointer) -> BoolObjective C
- (BOOL)setTorchModeOnWithLevel:(float)
torchLevel
error:(NSError **)outError
Параметры
torchLevel
Новый уровень режима факела. Это значение должно быть числом с плавающей точкой между 0,0 и 1.0. Для установки уровня режима факела в в настоящее время доступный максимум укажите константу
AVCaptureMaxAvailableTorchLevel
для этого параметра.outError
На вводе, указателе на ошибочный объект. Если ошибка происходит, этот метод присваивает ошибочный объект указателю с информацией о том, что произошло.
Возвращаемое значение
YES
true
если уровень режима факела был установлен илиNO
false
если это не было.Обсуждение
Этот метод устанавливает режим факела в
AVCaptureTorchModeOn
и устанавливает уровень в указанное значение. Если устройство не поддерживаетAVCaptureTorchModeOn
режим факела или если Вы указываете значение дляtorchLevel
это вне принятого диапазона, этот метод повышает исключение. Если значение факела в в принятом диапазоне, но больше, чем в настоящее время поддерживаемый максимум — возможно, потому что устройство перегревается — просто возвращается этот методNO
false
.Прежде, чем изменить значение этого свойства, необходимо вызвать
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
если это свойство, свойство может только быть установленоYES
true
.Можно наблюдать изменения в значении этого свойства с помощью наблюдения значения ключа.
Оператор импорта
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
объект в настоящее время улучшает изображения для повышения качества вследствие слабого освещения. Когда это свойствоYES
true
, устройство захвата изображения переключилось в специальный режим, в котором более легкий может быть воспринят в изображениях.Можно наблюдать изменения в значении этого свойства с помощью наблюдения значения ключа.
Оператор импорта
Objective C
@import AVFoundation;
Swift
import AVFoundation
Доступность
Доступный в iOS 6.0 и позже.
-
Булево значение, указывающее, должно ли устройство захвата изображения автоматически переключиться на режим повышения недостаточной освещенности при необходимости.
Объявление
Swift
var automaticallyEnablesLowLightBoostWhenAvailable: Bool
Objective C
@property(nonatomic) BOOL automaticallyEnablesLowLightBoostWhenAvailable
Обсуждение
На
AVCaptureDevice
объект, гдеlowLightBoostSupported
YES
true
, специальный режим повышения недостаточной освещенности может быть занят для улучшения качества изображения. КогдаautomaticallyEnablesLowLightBoostWhenAvailable
свойство установлено вYES
true
, устройство захвата изображения переключается по его усмотрению на специальный режим повышения под недостаточной освещенностью. Когда сцена становится достаточно освещенной, переключатели устройства назад к нормальному функционированию.AVCaptureDevice
это поддерживает эту функцию, может только затронуть режим повышения для определенных исходных форматов или разрешений.Значение по умолчанию этого свойства
NO
false
. Установка этого свойства бросаетNSInvalidArgumentException
еслиlowLightBoostSupported
NO
false
.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 и позже.
См. также
-
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 и позже.
См. также
-
subjectAreaChangeMonitoringEnabled
СвойствоУказывает, должно ли устройство контролировать предметную область для изменений.
Объявление
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 и позже.
См. также
-
connected
СвойствоУказывает, подключается ли в настоящее время устройство. (только для чтения)
Объявление
Swift
var connected: Bool { get }
Objective C
@property(nonatomic, readonly, getter=isConnected) BOOL connected
Обсуждение
Значение этого свойства указывает, подключается ли устройство, представленное получателем, и доступно для использования в качестве устройства захвата изображения. Когда значение этого свойства становится
NO
false
для приведенного примера, однако, это не станетYES
true
снова. Если то же физическое устройство снова станет доступным системе, то оно будет представлено с помощью нового экземпляра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
, иначеNO
false
.Оператор импорта
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
Сеанс получения задается.
Возвращаемое значение
YES
true
если получатель может использоваться сpreset
, иначеNO
false
.Обсуждение
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)
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 и позже.
-
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
Обсуждение
Когда
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, completionHandlerhandler
: ((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 и позже.
См. также
-
Преобразовывает специфичные для устройства значения усиления 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
Параметры
tempAndTintValues
AVCaptureWhiteBalanceTemperatureAndTintValues
структура, содержащая температуру и значения оттенка.Возвращаемое значение
Полностью заполненный
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)
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 и позже.
-
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: Bool
Objective C
@property(nonatomic) BOOL automaticallyAdjustsVideoHDREnabled
Обсуждение
Значение по умолчанию
YES
true
. По умолчанию,AVCaptureDevice
всегда наборыvideoHDREnabled
кNO
false
когда клиент устанавливает новый формат с помощью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
Обсуждение
Значение по умолчанию
YES
true
. По умолчанию,AVCaptureDevice
всегда наборыvideoHDREnabled
кNO
false
когда клиент устанавливает новый формат с помощью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 и позже.
-
-
Указывает, что никакое значение не должно быть указано для
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
YES
true
.Оператор импорта
Objective C
@import AVFoundation;
Swift
import AVFoundation
Доступность
Доступный в iOS 5.0 и позже.