AVCaptureDevice
AVCaptureDevice
объект представляет физическое устройство захвата изображения и свойства, связанные с тем устройством. Вы используете устройство захвата изображения для конфигурирования свойств используемого оборудования. Устройство захвата изображения также предоставляет входные данные (такие как аудио или видео) к AVCaptureSession
объект.
Вы используете методы AVCaptureDevice
класс для перечисления доступных устройств запросите их возможности и будьте сообщены о том, когда устройства придут и уйдут. Прежде чем Вы попытаетесь установить свойства устройства захвата изображения (его режим фокуса, режим воздействия, и т.д.), необходимо сначала получить блокировку на устройстве с помощью lockForConfiguration:
метод. Можно тогда установить свойства и выпустить блокировку с помощью unlockForConfiguration
метод. Можно содержать блокировку, если Вы хотите, чтобы все устанавливаемые свойства устройства остались неизменными. Однако содержание блокировки устройства излишне может ухудшить качество получения в других приложениях, совместно использующих устройство, и не рекомендуется.
Наиболее распространенные конфигурации настроек получения доступны через AVCaptureSession
возразите и его доступные предварительные установки; однако, некоторые специализированные опции (такие как высокая частота кадров) требуют непосредственно установки формата получения на AVCaptureDevice
экземпляр. Следующий пример кода иллюстрирует, как выбрать максимально возможную частоту кадров устройства:
- (void)configureCameraForHighestFrameRate:(AVCaptureDevice *)device
{
AVCaptureDeviceFormat *bestFormat = nil;
AVFrameRateRange *bestFrameRateRange = nil;
for ( AVCaptureDeviceFormat *format in [device formats] ) {
for ( AVFrameRateRange *range in format.videoSupportedFrameRateRanges ) {
if ( range.maxFrameRate > bestFrameRateRange.maxFrameRate ) {
bestFormat = format;
bestFrameRateRange = range;
}
}
}
if ( bestFormat ) {
if ( [device lockForConfiguration:NULL] == YES ) {
device.activeFormat = bestFormat;
device.activeVideoMinFrameDuration = bestFrameRateRange.minFrameDuration;
device.activeVideoMaxFrameDuration = bestFrameRateRange.minFrameDuration;
[device unlockForConfiguration];
}
}
}
Оператор импорта
Swift
import AVFoundation
Objective C
@import AVFoundation;
Доступность
Доступный в OS X v10.7 и позже.
-
Возвращает массив доступных устройств захвата изображения в системе.
Возвращаемое значение
Массив, содержащий доступные устройства захвата изображения в системе
Оператор импорта
Objective C
@import AVFoundation;
Swift
import AVFoundation
Доступность
Доступный в OS X v10.7 и позже.
-
Возвращает устройство с данным ID.
Объявление
Swift
init!(uniqueID
deviceUniqueID
: String!) -> AVCaptureDeviceObjective C
+ (AVCaptureDevice *)deviceWithUniqueID:(NSString *)
deviceUniqueID
Параметры
deviceUniqueID
ID устройства захвата изображения.
Возвращаемое значение
Устройство с ID
deviceUniqueID
.Оператор импорта
Objective C
@import AVFoundation;
Swift
import AVFoundation
Доступность
Доступный в OS X v10.7 и позже.
См. также
-
Возвращается устройство по умолчанию раньше получало данные данного типа среды.
Объявление
Swift
class func defaultDeviceWithMediaType(_
mediaType
: String!) -> AVCaptureDevice!Objective C
+ (AVCaptureDevice *)defaultDeviceWithMediaType:(NSString *)
mediaType
Параметры
mediaType
Идентификатор типа среды.
Для возможных значений см. Ссылку Констант Основы AV.
Возвращаемое значение
Устройство по умолчанию раньше получало данные типа, обозначенного
mediaType
.Оператор импорта
Objective C
@import AVFoundation;
Swift
import AVFoundation
Доступность
Доступный в OS X v10.7 и позже.
-
Возвращает массив устройств, которые в состоянии получать данные данного типа среды.
Объявление
Swift
class func devicesWithMediaType(_
mediaType
: String!) -> [AnyObject]!Параметры
mediaType
Идентификатор типа среды.
Для возможных значений см. Ссылку Констант Основы AV.
Возвращаемое значение
Массив, содержащий устройства, которые в состоянии получать данные типа, обозначенного
mediaType
.Оператор импорта
Objective C
@import AVFoundation;
Swift
import AVFoundation
Доступность
Доступный в OS X v10.7 и позже.
-
Запрашивает эксклюзивный доступ к аппаратным свойствам устройства.
Объявление
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
Доступность
Доступный в OS X v10.7 и позже.
См. также
-
Оставляет монопольное управление конфигурацией устройства.
Объявление
Swift
func unlockForConfiguration()
Objective C
- (void)unlockForConfiguration
Обсуждение
Вызовите этот метод для выпуска полученного использования блокировки
lockForConfiguration:
метод, когда Вы сделаны, конфигурируя устройство.Оператор импорта
Objective C
@import AVFoundation;
Swift
import AVFoundation
Доступность
Доступный в OS X v10.7 и позже.
См. также
-
приостановленный приостановленный
СвойствоУказывает, приостановлено ли устройство. (только для чтения)
Объявление
Swift
var suspended: Bool { get }
Objective C
@property(nonatomic, readonly, getter=isSuspended) BOOL suspended
Обсуждение
Некоторые устройства запрещают сбор данных вследствие функции на устройстве.
Например,
isSuspended
возвратыYES
true
для внешней iSight камеры, когда ее ирисовая диафрагма конфиденциальности закрывается, или для внутренней iSight камеры на ноутбуке, когда закрывается дисплей ноутбука.Можно наблюдать изменения в значении этого свойства с помощью наблюдения Значения ключа.
Оператор импорта
Objective C
@import AVFoundation;
Swift
import AVFoundation
Доступность
Доступный в OS X v10.7 и позже.
-
Указывает, используется ли устройство другим приложением. (только для чтения)
Объявление
Swift
var inUseByAnotherApplication: Bool { get }
Objective C
@property(nonatomic, readonly, getter=isInUseByAnotherApplication) BOOL inUseByAnotherApplication
Обсуждение
Можно наблюдать изменения в значении этого свойства с помощью наблюдения Значения ключа.
Оператор импорта
Objective C
@import AVFoundation;
Swift
import AVFoundation
Доступность
Доступный в OS X v10.7 и позже.
-
inputSources inputSources
СвойствоМассив
AVCaptureDeviceInputSource
объекты, представляющие входные источники, поддерживаются устройством. (только для чтения)Объявление
Swift
var inputSources: [AnyObject]! { get }
Objective C
@property(nonatomic, readonly) NSArray *inputSources
Обсуждение
Некоторые устройства могут получить данные от одного из многократных источников данных (различные входные разъемы на том же аудиоустройстве, например). Для устройств с многократными возможными источниками данных можно использовать это свойство для перечисления возможного выбора.
Можно наблюдать изменения в значении этого свойства с помощью наблюдения Значения ключа.
Оператор импорта
Objective C
@import AVFoundation;
Swift
import AVFoundation
Доступность
Доступный в OS X v10.7 и позже.
-
activeInputSource activeInputSource
СвойствоВ настоящее время активный входной источник.
Объявление
Swift
var activeInputSource: AVCaptureDeviceInputSource!
Objective C
@property(nonatomic, retain) AVCaptureDeviceInputSource *activeInputSource
Обсуждение
Вы используете это свойство, чтобы получить или установить в настоящее время активный входной источник.
Для установки формата необходимо сначала получить эксклюзивный доступ к использованию получателя
lockForConfiguration:
. Если Вы не получаете эксклюзивный доступ,setActiveInputSource:
броскиNSGenericException
.Метод установки,
setActiveInputSource:
, броскиNSInvalidArgumentException
если Вы передаете формат, не существующий вformats
массив.Можно наблюдать изменения в значении этого свойства с помощью наблюдения Значения ключа.
Оператор импорта
Objective C
@import AVFoundation;
Swift
import AVFoundation
Доступность
Доступный в OS X v10.7 и позже.
См. также
-
linkedDevices linkedDevices
СвойствоМассив
AVCaptureDevice
объекты, представляющие устройства, физически соединенные с получателем. (только для чтения)Объявление
Swift
var linkedDevices: [AnyObject]! { get }
Objective C
@property(nonatomic, readonly) NSArray *linkedDevices
Обсуждение
Значение этого свойства является массивом
AVCaptureDevice
объекты, которые являются частью того же физического устройства как получатель. Например, для внешней iSight камеры, массив содержитAVCaptureDevice
экземпляр, представляющий внешний iSight микрофон.Оператор импорта
Objective C
@import AVFoundation;
Swift
import AVFoundation
Доступность
Доступный в OS X v10.7 и позже.
-
transportType transportType
СвойствоТип передачи получателя. (только для чтения)
Объявление
Swift
var transportType: Int32 { get }
Objective C
@property(nonatomic, readonly) int32_t transportType
Обсуждение
Значение этого свойства представляет тип передачи устройства (USB, PCI, и т.д.). Типы передачи определяются в
<IOKit/audio/IOAudioTypes.h>
какkIOAudioDeviceTransportType*
.Оператор импорта
Objective C
@import AVFoundation;
Swift
import AVFoundation
Доступность
Доступный в OS X v10.7 и позже.
-
Массив
AVCaptureDeviceFormat
объекты, представляющие форматы, поддерживаемые устройством (только для чтения)Объявление
Swift
var formats: [AnyObject]! { get }
Objective C
@property(nonatomic, readonly) NSArray *formats
Обсуждение
Можно использовать это свойство для перечисления форматов, исходно поддерживаемых получателем.
Можно установить
activeFormat
к любому из форматов в этом массиве.Можно наблюдать изменения в значении этого свойства с помощью наблюдения Значения ключа.
Оператор импорта
Objective C
@import AVFoundation;
Swift
import AVFoundation
Доступность
Доступный в OS X v10.7 и позже.
См. также
-
activeFormat activeFormat
СвойствоВ настоящее время активный формат получателя.
Объявление
Swift
var activeFormat: AVCaptureDeviceFormat!
Objective C
@property(nonatomic, retain) AVCaptureDeviceFormat *activeFormat
Обсуждение
Вы используете это свойство, чтобы получить или установить формат в настоящее время активного устройства.
На iOS необходимо обычно устанавливать предварительную установку сеанса на
AVCaptureSession
объект сконфигурировать захват изображения или видеосъемку и использовать совместно используемоеAVAudioSession
объект сконфигурировать аудио получение. При использовании предварительной установки сеанса сеанс автоматически управляет активным форматом устройства захвата изображения. Однако некоторые специализированные опции получения (такие как высокая частота кадров) не доступны в предварительных установках сеанса. Для этих опций можно установить активный формат устройства захвата изображения вместо этого. Выполнение так изменяет связанную предварительную установку сеанса получения наAVCaptureSessionPresetInputPriority
.Попытка установить активный формат в один не существующий в
formats
выстройте бросаетNSInvalidArgumentException
.Прежде, чем изменить значение этого свойства, необходимо вызвать
lockForConfiguration:
получать эксклюзивный доступ к свойствам конфигурации устройства. Иначе, установка значения этого свойства повышает исключение. Когда Вы будете сделаны, конфигурируя устройство, вызватьunlockForConfiguration
выпустить блокировку и позволить другим устройствам конфигурировать настройки. Необходимо также вызватьlockForConfiguration:
прежде, чем вызватьAVCaptureSession
методstartRunning
, или предварительная установка сеанса переопределит выбранный активный формат на устройстве захвата изображения.Можно наблюдать изменения в значении этого свойства с помощью наблюдения значения ключа.
Оператор импорта
Objective C
@import AVFoundation;
Swift
import AVFoundation
Доступность
Доступный в OS X v10.7 и позже.
См. также
-
Режим фокуса устройства.
Объявление
Swift
var focusMode: AVCaptureFocusMode
Objective C
@property(nonatomic) AVCaptureFocusMode focusMode
Обсуждение
Прежде, чем изменить значение этого свойства, необходимо вызвать
lockForConfiguration:
получать эксклюзивный доступ к свойствам конфигурации устройства. Иначе, установка значения этого свойства повышает исключение. Когда Вы будете сделаны, конфигурируя устройство, вызватьunlockForConfiguration
выпустить блокировку и позволить другим устройствам конфигурировать настройки.Можно наблюдать изменения в значении этого свойства с помощью наблюдения Значения ключа.
Посмотрите AVCaptureFocusMode для возможных значений.
Оператор импорта
Objective C
@import AVFoundation;
Swift
import AVFoundation
Доступность
Доступный в OS X v10.7 и позже.
-
Возвращает булево значение, указывающее, поддерживается ли данный режим фокуса.
Объявление
Swift
func isFocusModeSupported(_
focusMode
: AVCaptureFocusMode) -> BoolObjective C
- (BOOL)isFocusModeSupported:(AVCaptureFocusMode)
focusMode
Параметры
focusMode
Режим фокуса. Посмотрите AVCaptureFocusMode для возможных значений.
Возвращаемое значение
YES
true
еслиfocusMode
поддерживается, иначеNO
false
.Оператор импорта
Objective C
@import AVFoundation;
Swift
import AVFoundation
Доступность
Доступный в OS X v10.7 и позже.
-
focusPointOfInterest 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
Доступность
Доступный в OS X v10.7 и позже.
См. также
-
Указывает, поддерживает ли устройство интересное место для фокуса. (только для чтения)
Объявление
Swift
var focusPointOfInterestSupported: Bool { get }
Objective C
@property(nonatomic, readonly, getter=isFocusPointOfInterestSupported) BOOL focusPointOfInterestSupported
Обсуждение
Можно наблюдать изменения в значении этого свойства с помощью наблюдения значения ключа.
Оператор импорта
Objective C
@import AVFoundation;
Swift
import AVFoundation
Доступность
Доступный в OS X v10.7 и позже.
-
adjustingFocus adjustingFocus
СвойствоУказывает, корректирует ли устройство в настоящее время свою установку фокуса. (только для чтения)
Объявление
Swift
var adjustingFocus: Bool { get }
Objective C
@property(nonatomic, readonly, getter=isAdjustingFocus) BOOL adjustingFocus
Обсуждение
Можно наблюдать изменения в значении этого свойства с помощью наблюдения значения ключа.
Оператор импорта
Objective C
@import AVFoundation;
Swift
import AVFoundation
Доступность
Доступный в OS X v10.7 и позже.
-
adjustingExposure adjustingExposure
СвойствоУказывает, корректирует ли устройство в настоящее время свою установку воздействия. (только для чтения)
Объявление
Swift
var adjustingExposure: Bool { get }
Objective C
@property(nonatomic, readonly, getter=isAdjustingExposure) BOOL adjustingExposure
Обсуждение
Можно наблюдать изменения в значении этого свойства с помощью наблюдения значения ключа.
Оператор импорта
Objective C
@import AVFoundation;
Swift
import AVFoundation
Доступность
Доступный в OS X v10.7 и позже.
-
exposureMode exposureMode
СвойствоРежим воздействия для устройства.
Объявление
Swift
var exposureMode: AVCaptureExposureMode
Objective C
@property(nonatomic) AVCaptureExposureMode exposureMode
Обсуждение
Прежде, чем изменить значение этого свойства, необходимо вызвать
lockForConfiguration:
получать эксклюзивный доступ к свойствам конфигурации устройства. Иначе, установка значения этого свойства повышает исключение. Когда Вы будете сделаны, конфигурируя устройство, вызватьunlockForConfiguration
выпустить блокировку и позволить другим устройствам конфигурировать настройки.Можно наблюдать изменения в значении этого свойства с помощью наблюдения Значения ключа.
Посмотрите AVCaptureExposureMode для возможных значений.
Оператор импорта
Objective C
@import AVFoundation;
Swift
import AVFoundation
Доступность
Доступный в OS X v10.7 и позже.
-
Возвращает булево значение, указывающее, поддерживается ли данный режим воздействия.
Объявление
Swift
func isExposureModeSupported(_
exposureMode
: AVCaptureExposureMode) -> BoolObjective C
- (BOOL)isExposureModeSupported:(AVCaptureExposureMode)
exposureMode
Параметры
exposureMode
Режим воздействия. Посмотрите AVCaptureExposureMode для возможных значений.
Возвращаемое значение
YES
true
еслиexposureMode
поддерживается, иначеNO
false
.Оператор импорта
Objective C
@import AVFoundation;
Swift
import AVFoundation
Доступность
Доступный в OS X v10.7 и позже.
См. также
-
Интересное место для воздействия.
Объявление
Swift
var exposurePointOfInterest: CGPoint
Objective C
@property(nonatomic) CGPoint exposurePointOfInterest
Обсуждение
Прежде, чем изменить значение этого свойства, необходимо вызвать
lockForConfiguration:
получать эксклюзивный доступ к свойствам конфигурации устройства. Иначе, установка значения этого свойства повышает исключение. Когда Вы будете сделаны, конфигурируя устройство, вызватьunlockForConfiguration
выпустить блокировку и позволить другим устройствам конфигурировать настройки.Оператор импорта
Objective C
@import AVFoundation;
Swift
import AVFoundation
Доступность
Доступный в OS X v10.7 и позже.
-
Указывает, поддерживает ли устройство интересное место для воздействия. (только для чтения)
Объявление
Swift
var exposurePointOfInterestSupported: Bool { get }
Objective C
@property(nonatomic, readonly, getter=isExposurePointOfInterestSupported) BOOL exposurePointOfInterestSupported
Обсуждение
Можно наблюдать изменения в значении этого свойства с помощью наблюдения значения ключа.
Оператор импорта
Objective C
@import AVFoundation;
Swift
import AVFoundation
Доступность
Доступный в OS X v10.7 и позже.
-
Возвращает булево значение, указывающее, поддерживается ли данный режим баланса белого.
Объявление
Swift
func isWhiteBalanceModeSupported(_
whiteBalanceMode
: AVCaptureWhiteBalanceMode) -> BoolObjective C
- (BOOL)isWhiteBalanceModeSupported:(AVCaptureWhiteBalanceMode)
whiteBalanceMode
Параметры
whiteBalanceMode
Режим фокуса. Посмотрите AVCaptureWhiteBalanceMode для возможных значений.
Возвращаемое значение
YES
true
еслиwhiteBalanceMode
поддерживается, иначеNO
false
.Оператор импорта
Objective C
@import AVFoundation;
Swift
import AVFoundation
Доступность
Доступный в OS X v10.7 и позже.
См. также
-
whiteBalanceMode whiteBalanceMode
СвойствоТекущий режим баланса белого.
Объявление
Swift
var whiteBalanceMode: AVCaptureWhiteBalanceMode
Objective C
@property(nonatomic) AVCaptureWhiteBalanceMode whiteBalanceMode
Обсуждение
Прежде, чем изменить значение этого свойства, необходимо вызвать
lockForConfiguration:
получать эксклюзивный доступ к свойствам конфигурации устройства. Иначе, установка значения этого свойства повышает исключение. Когда Вы будете сделаны, конфигурируя устройство, вызватьunlockForConfiguration
выпустить блокировку и позволить другим устройствам конфигурировать настройки.Можно наблюдать изменения в значении этого свойства с помощью наблюдения значения ключа.
Посмотрите AVCaptureWhiteBalanceMode для возможных значений.
Оператор импорта
Objective C
@import AVFoundation;
Swift
import AVFoundation
Доступность
Доступный в OS X v10.7 и позже.
-
Указывает, корректирует ли завещанное имущество в настоящее время баланс белого. (только для чтения)
Объявление
Swift
var adjustingWhiteBalance: Bool { get }
Objective C
@property(nonatomic, readonly, getter=isAdjustingWhiteBalance) BOOL adjustingWhiteBalance
Обсуждение
Можно наблюдать изменения в значении этого свойства с помощью наблюдения значения ключа.
Оператор импорта
Objective C
@import AVFoundation;
Swift
import AVFoundation
Доступность
Доступный в OS X v10.7 и позже.
См. также
-
Указывает, имеет ли устройство захвата изображения флэш-память. (только для чтения)
Объявление
Swift
var hasFlash: Bool { get }
Objective C
@property(nonatomic, readonly) BOOL hasFlash
Обсуждение
Можно наблюдать изменения в значении этого свойства с помощью наблюдения значения ключа.
Оператор импорта
Objective C
@import AVFoundation;
Swift
import AVFoundation
Доступность
Доступный в OS X v10.7 и позже.
-
Текущий режим флэш-памяти.
Объявление
Swift
var flashMode: AVCaptureFlashMode
Objective C
@property(nonatomic) AVCaptureFlashMode flashMode
Обсуждение
Прежде, чем изменить значение этого свойства, необходимо вызвать
lockForConfiguration:
получать эксклюзивный доступ к свойствам конфигурации устройства. Иначе, установка значения этого свойства повышает исключение. Когда Вы будете сделаны, конфигурируя устройство, вызватьunlockForConfiguration
выпустить блокировку и позволить другим устройствам конфигурировать настройки.Можно наблюдать изменения в значении этого свойства с помощью наблюдения значения ключа.
Посмотрите AVCaptureFlashMode для возможных значений.
Оператор импорта
Objective C
@import AVFoundation;
Swift
import AVFoundation
Доступность
Доступный в OS X v10.7 и позже.
-
Возвращает булево значение, указывающее, поддерживается ли данный режим флэш-памяти.
Объявление
Swift
func isFlashModeSupported(_
flashMode
: AVCaptureFlashMode) -> BoolObjective C
- (BOOL)isFlashModeSupported:(AVCaptureFlashMode)
flashMode
Параметры
flashMode
Режим флэш-памяти. Посмотрите AVCaptureFlashMode для возможных значений.
Возвращаемое значение
YES
true
еслиflashMode
поддерживается, иначеNO
false
.Оператор импорта
Objective C
@import AVFoundation;
Swift
import AVFoundation
Доступность
Доступный в OS X v10.7 и позже.
-
Булево значение, указывающее, имеет ли устройство захвата изображения факел. (только для чтения)
Объявление
Swift
var hasTorch: Bool { get }
Objective C
@property(nonatomic, readonly) BOOL hasTorch
Обсуждение
Факел является источником света, таким как флэш-память LED, которая доступна на устройстве и используемая для освещения полученного содержания или обеспечения общего освещения. Это свойство отражается, имеет ли текущее устройство такие встроенные аппаратные средства освещения.
Даже если устройство имеет факел, тот факел не мог бы быть доступен для использования. Таким образом необходимо также проверить значение
torchAvailable
свойство перед использованием его.Можно наблюдать изменения в значении этого свойства с помощью наблюдения значения ключа.
Оператор импорта
Objective C
@import AVFoundation;
Swift
import AVFoundation
Доступность
Доступный в OS X v10.7 и позже.
См. также
-
Возвращает булево значение, указывающее, поддерживает ли устройство указанный режим факела.
Объявление
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
Доступность
Доступный в OS X v10.7 и позже.
См. также
-
Текущий режим факела.
Объявление
Swift
var torchMode: AVCaptureTorchMode
Objective C
@property(nonatomic) AVCaptureTorchMode torchMode
Обсуждение
Установка значения этого свойства также устанавливает уровень факела в свое значение максимального тока.
Прежде, чем установить значение этого свойства, вызовите
isTorchModeSupported:
метод для проверки устройства поддерживает желаемый режим. Установка устройства к неподдерживаемому режиму факела приводит к повышению исключения. Для списка возможных значений для этого свойства посмотрите AVCaptureTorchMode.Прежде, чем изменить значение этого свойства, необходимо вызвать
lockForConfiguration:
получать эксклюзивный доступ к свойствам конфигурации устройства. Иначе, установка значения этого свойства повышает исключение. Когда Вы будете сделаны, конфигурируя устройство, вызватьunlockForConfiguration
выпустить блокировку и позволить другим устройствам конфигурировать настройки.Можно наблюдать изменения в значении этого свойства с помощью наблюдения значения ключа.
Оператор импорта
Objective C
@import AVFoundation;
Swift
import AVFoundation
Доступность
Доступный в OS X v10.7 и позже.
См. также
-
В настоящее время активная минимальная продолжительность кадра.
Объявление
Swift
var activeVideoMinFrameDuration: CMTime
Objective C
@property(nonatomic) CMTime activeVideoMinFrameDuration
Обсуждение
Минимальная продолжительность кадра устройства является обратной величиной своей максимальной частоты кадров. Можно установить значение этого свойства для ограничения максимальной частоты кадров во время сеанса получения. Устройство захвата изображения автоматически выбирает минимальную продолжительность кадра по умолчанию на основе своего активного формата. После изменения значения этого свойства можно возвратиться к минимальной продолжительности кадра по умолчанию путем установки значения этого свойства в
kCMTimeInvalid
. Выбор новой предварительной установки для сеанса получения также сбрасывает это свойство к своему значению по умолчанию.Попытка установить это свойство в значение, не найденное в активном формате
videoSupportedFrameRateRanges
выстройте повышает исключение (NSInvalidArgumentException
).Прежде, чем изменить значение этого свойства, необходимо вызвать
lockForConfiguration:
получать эксклюзивный доступ к свойствам конфигурации устройства. Иначе, установка значения этого свойства повышает исключение. Когда Вы будете сделаны, конфигурируя устройство, вызватьunlockForConfiguration
выпустить блокировку и позволить другим устройствам конфигурировать настройки.Можно наблюдать изменения в значении этого свойства с помощью наблюдения значения ключа.
Оператор импорта
Objective C
@import AVFoundation;
Swift
import AVFoundation
Доступность
Доступный в OS X v10.7 и позже.
См. также
-
В настоящее время активная максимальная продолжительность кадра
Объявление
Swift
var activeVideoMaxFrameDuration: CMTime
Objective C
@property(nonatomic) CMTime activeVideoMaxFrameDuration
Обсуждение
Максимальная продолжительность кадра устройства является обратной величиной своей минимальной частоты кадров. Можно установить значение этого свойства для ограничения минимальной частоты кадров во время сеанса получения. Устройство захвата изображения автоматически выбирает максимальную продолжительность кадра по умолчанию на основе своего активного формата. После изменения значения этого свойства можно возвратиться к максимальной продолжительности кадра по умолчанию путем установки значения этого свойства в
kCMTimeInvalid
. Выбор новой предварительной установки для сеанса получения также сбрасывает это свойство к своему значению по умолчанию.Попытка установить это свойство в значение, не найденное в активном формате
videoSupportedFrameRateRanges
выстройте повышает исключение (NSInvalidArgumentException
).Прежде, чем изменить значение этого свойства, необходимо вызвать
lockForConfiguration:
получать эксклюзивный доступ к свойствам конфигурации устройства. Иначе, установка значения этого свойства повышает исключение. Когда Вы будете сделаны, конфигурируя устройство, вызватьunlockForConfiguration
выпустить блокировку и позволить другим устройствам конфигурировать настройки.Можно наблюдать изменения в значении этого свойства с помощью наблюдения значения ключа.
Оператор импорта
Objective C
@import AVFoundation;
Swift
import AVFoundation
Доступность
Доступный в OS X v10.9 и позже.
См. также
-
Указывает, поддерживает ли устройство команды управления передачей. (только для чтения)
Объявление
Swift
var transportControlsSupported: Bool { get }
Objective C
@property(nonatomic, readonly) BOOL transportControlsSupported
Обсуждение
Для устройств с управлением передачей, таким как AVC основанные на ленте видеокамеры или про устройства захвата изображения с управлением декой RS422, значение этого свойства
YES
true
. Если управление передачей не поддерживается, ни один из связанных методов управления передачей и свойств не доступен на получателе.Можно наблюдать изменения в значении этого свойства с помощью наблюдения значения ключа.
Оператор импорта
Objective C
@import AVFoundation;
Swift
import AVFoundation
Доступность
Доступный в OS X v10.7 и позже.
-
Текущий режим воспроизведения. (только для чтения)
Объявление
Swift
var transportControlsPlaybackMode: AVCaptureDeviceTransportControlsPlaybackMode { get }
Objective C
@property(nonatomic, readonly) AVCaptureDeviceTransportControlsPlaybackMode transportControlsPlaybackMode
Обсуждение
Это свойство только допустимо для устройств то управление передачей поддержки.
Можно наблюдать изменения в значении этого свойства с помощью наблюдения значения ключа.
Оператор импорта
Objective C
@import AVFoundation;
Swift
import AVFoundation
Доступность
Доступный в OS X v10.7 и позже.
См. также
-
Текущая скорость воспроизведения. (только для чтения)
Объявление
Swift
var transportControlsSpeed: AVCaptureDeviceTransportControlsSpeed { get }
Objective C
@property(nonatomic, readonly) AVCaptureDeviceTransportControlsSpeed transportControlsSpeed
Обсуждение
Для устройств, поддерживающих управление передачей, значение этого свойства указывает текущую скорость воспроизведения деки. Следующая таблица дает примеры значения значений:
Значение
Значение
0.0
Остановленный
1.0
Передайте в нормальной скорости.
- 1.0
Реверс в нормальной скорости.
2.0
Передайте в 2x нормальная скорость.
Можно наблюдать изменения в значении этого свойства с помощью наблюдения значения ключа.
Оператор импорта
Objective C
@import AVFoundation;
Swift
import AVFoundation
Доступность
Доступный в OS X v10.7 и позже.
См. также
-
Устанавливает режим воспроизведения и скорость управления передачей.
Объявление
Swift
func setTransportControlsPlaybackMode(_
mode
: AVCaptureDeviceTransportControlsPlaybackMode, speedspeed
: AVCaptureDeviceTransportControlsSpeed)Objective C
- (void)setTransportControlsPlaybackMode:(AVCaptureDeviceTransportControlsPlaybackMode)
mode
speed:(AVCaptureDeviceTransportControlsSpeed)speed
Параметры
mode
AVCaptureDeviceTransportControlsPlaybackMode
постоянное указание, должна ли дека быть помещена в режим воспроизведения.speed
AVCaptureDeviceTransportControlsSpeed
значение, указывающее скорость, на которой можно проветрить или играть ленту.Обсуждение
Прежде, чем изменить значение этого свойства, необходимо вызвать
lockForConfiguration:
получать эксклюзивный доступ к свойствам конфигурации устройства. Иначе, вызов этого метода повышает исключение. Когда Вы будете сделаны, конфигурируя устройство, вызватьunlockForConfiguration
выпустить блокировку и позволить другим устройствам конфигурировать настройки.Оператор импорта
Objective C
@import AVFoundation;
Swift
import AVFoundation
Доступность
Доступный в OS X v10.7 и позже.
См. также
-
Указывает, подключается ли в настоящее время устройство. (только для чтения)
Объявление
Swift
var connected: Bool { get }
Objective C
@property(nonatomic, readonly, getter=isConnected) BOOL connected
Обсуждение
Значение этого свойства указывает, подключается ли устройство, представленное получателем, и доступно для использования в качестве устройства захвата изображения. Когда значение этого свойства становится
NO
false
для приведенного примера, однако, это не станетYES
true
снова. Если то же физическое устройство снова станет доступным системе, то оно будет представлено с помощью нового экземпляраAVCaptureDevice
.Можно наблюдать изменения в значении этого свойства с помощью наблюдения значения ключа.
Оператор импорта
Objective C
@import AVFoundation;
Swift
import AVFoundation
Доступность
Доступный в OS X v10.7 и позже.
-
Указывает физическую позицию оборудования устройства в системе. (только для чтения)
Объявление
Swift
var position: AVCaptureDevicePosition { get }
Objective C
@property(nonatomic, readonly) AVCaptureDevicePosition position
Обсуждение
Можно наблюдать изменения в значении этого свойства с помощью наблюдения значения ключа.
Посмотрите AVCaptureDevicePosition для возможных значений.
Оператор импорта
Objective C
@import AVFoundation;
Swift
import AVFoundation
Доступность
Доступный в OS X v10.7 и позже.
-
Возвращает булево значение, указывающее, предоставляет ли устройство носителям данный тип.
Объявление
Swift
func hasMediaType(_
mediaType
: String!) -> BoolObjective C
- (BOOL)hasMediaType:(NSString *)
mediaType
Параметры
mediaType
Тип среды, такой как
AVMediaTypeVideo
,AVMediaTypeAudio
, илиAVMediaTypeMuxed
. Для полного списка поддерживаемых констант типа среды см. Ссылку Констант Основы AV.Возвращаемое значение
YES, если устройство обеспечивает носители типа
mediaType
, иначеNO
false
.Оператор импорта
Objective C
@import AVFoundation;
Swift
import AVFoundation
Доступность
Доступный в OS X v10.7 и позже.
-
смоделированный смоделированный
СвойствоID модели устройства. (только для чтения)
Объявление
Swift
var modelID: String! { get }
Objective C
@property(nonatomic, readonly) NSString *modelID
Обсуждение
Значение этого свойства является идентификатором, уникальным для всех устройств той же модели. Значение является персистентным через подключения устройства и разъединения, и через различные системы. Например, ID модели камеры, встроенной к двум идентичным моделям iPhone, будет тем же даже при том, что они - различные физические устройства.
Оператор импорта
Objective C
@import AVFoundation;
Swift
import AVFoundation
Доступность
Доступный в OS X v10.7 и позже.
-
localizedName localizedName
СвойствоЛокализованное человекочитаемое имя для получателя. (только для чтения)
Объявление
Swift
var localizedName: String! { get }
Objective C
@property(nonatomic, readonly) NSString *localizedName
Обсуждение
Можно использовать это свойство для отображения имени устройства захвата изображения в пользовательском интерфейсе.
Оператор импорта
Objective C
@import AVFoundation;
Swift
import AVFoundation
Доступность
Доступный в OS X v10.7 и позже.
См. также
-
ID, уникальный для модели устройства, соответствующего получателю. (только для чтения)
Объявление
Swift
var uniqueID: String! { get }
Objective C
@property(nonatomic, readonly) NSString *uniqueID
Обсуждение
Каждое доступное устройство захвата изображения имеет уникальный идентификатор, сохраняющийся в одной системе через подключения устройства и разъединения, перезапуски приложения и перезагрузки самой системы. Можно сохранить значение, возвращенное этим свойством, чтобы вспомнить или отследить состояние определенного устройства в будущем.
Оператор импорта
Objective C
@import AVFoundation;
Swift
import AVFoundation
Доступность
Доступный в OS X v10.7 и позже.
См. также
-
Возвращает булево значение, указывающее, может ли получатель использоваться в сеансе получения, сконфигурированном с данной предварительной установкой.
Объявление
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
Доступность
Доступный в OS X v10.7 и позже.
Типы данных
-
Константа, использующаяся для указания скорости управления передачей.
Объявление
Swift
typealias AVCaptureDeviceTransportControlsSpeed = Float
Objective C
typedef float AVCaptureDeviceTransportControlsSpeed;
Оператор импорта
Objective C
@import AVFoundation;
Swift
import AVFoundation
Доступность
Доступный в OS X v10.7 и позже.
-
Константы для указания позиции устройства захвата изображения.
Объявление
Swift
enum AVCaptureDevicePosition : Int { case Unspecified case Back case Front }
Objective C
enum { AVCaptureDevicePositionUnspecified = 0, AVCaptureDevicePositionBack = 1, AVCaptureDevicePositionFront = 2 }; typedef NSInteger AVCaptureDevicePosition;
Константы
-
Unspecified
AVCaptureDevicePositionUnspecified
Позиция устройства захвата изображения относительно оборудования системы является неуказанной.
Доступный в OS X v10.7 и позже.
-
Back
AVCaptureDevicePositionBack
Устройство захвата изображения в конце модуля.
Доступный в OS X v10.7 и позже.
-
Front
AVCaptureDevicePositionFront
Устройство захвата изображения находится на передней стороне модуля.
Доступный в OS X v10.7 и позже.
Оператор импорта
Objective C
@import AVFoundation;
Swift
import AVFoundation
Доступность
Доступный в OS X v10.7 и позже.
-
-
Константы для указания режима флэш-памяти устройства захвата изображения.
Объявление
Swift
enum AVCaptureFlashMode : Int { case Off case On case Auto }
Objective C
typedef enum : NSInteger { AVCaptureFlashModeOff = 0, AVCaptureFlashModeOn = 1, AVCaptureFlashModeAuto = 2 } AVCaptureFlashMode;
Константы
-
Off
AVCaptureFlashModeOff
Флэш-память устройства захвата изображения всегда выключена.
Доступный в OS X v10.7 и позже.
-
On
AVCaptureFlashModeOn
Флэш-память устройства захвата изображения всегда включена.
Доступный в OS X v10.7 и позже.
-
Auto
AVCaptureFlashModeAuto
Устройство захвата изображения постоянно контролирует легкие уровни и использует флэш-память при необходимости.
Доступный в OS X v10.7 и позже.
Оператор импорта
Objective C
@import AVFoundation;
Swift
import AVFoundation
Доступность
Доступный в OS X v10.7 и позже.
-
-
Константы для указания режима факела устройства захвата изображения.
Объявление
Swift
enum AVCaptureTorchMode : Int { case Off case On case Auto }
Objective C
typedef enum : NSInteger { AVCaptureTorchModeOff = 0, AVCaptureTorchModeOn = 1, AVCaptureTorchModeAuto = 2 } AVCaptureTorchMode;
Константы
-
Off
AVCaptureTorchModeOff
Факел устройства захвата изображения всегда выключен.
Доступный в OS X v10.7 и позже.
-
On
AVCaptureTorchModeOn
Факел устройства захвата изображения всегда включен.
Доступный в OS X v10.7 и позже.
-
Auto
AVCaptureTorchModeAuto
Устройство захвата изображения постоянно контролирует легкие уровни и использует факел при необходимости.
Доступный в OS X v10.7 и позже.
Оператор импорта
Objective C
@import AVFoundation;
Swift
import AVFoundation
Доступность
Доступный в OS X v10.7 и позже.
-
-
Максимальный уровень факела.
Объявление
Swift
let AVCaptureMaxAvailableTorchLevel: Float
Objective C
const float AVCaptureMaxAvailableTorchLevel;
Константы
-
AVCaptureMaxAvailableTorchLevel
AVCaptureMaxAvailableTorchLevel
Эта константа всегда представляет максимальный доступный уровень факела, независимый от фактического максимального значения, в настоящее время поддерживаемого устройством. Таким образом передайте эту константу
setTorchModeOnWithLevel:error:
в ситуациях, где Вы хотите указать максимальный уровень факела, не имея необходимость волноваться о том, перегревается ли устройство и не могло бы принять значение 1,0 как максимум.Доступный в OS X v10.9 и позже.
-
-
Константы для указания режима фокуса устройства захвата изображения.
Объявление
Swift
enum AVCaptureFocusMode : Int { case Locked case AutoFocus case ContinuousAutoFocus }
Objective C
typedef enum : NSInteger { AVCaptureFocusModeLocked = 0, AVCaptureFocusModeAutoFocus = 1, AVCaptureFocusModeContinuousAutoFocus = 2, } AVCaptureFocusMode;
Константы
-
Locked
AVCaptureFocusModeLocked
Фокус заблокирован.
Доступный в OS X v10.7 и позже.
-
AutoFocus
AVCaptureFocusModeAutoFocus
Устройство захвата изображения выполняет работу автофокуса теперь.
Доступный в OS X v10.7 и позже.
-
ContinuousAutoFocus
AVCaptureFocusModeContinuousAutoFocus
Устройство захвата изображения постоянно контролирует фокус и автофокус при необходимости.
Доступный в OS X v10.7 и позже.
Оператор импорта
Objective C
@import AVFoundation;
Swift
import AVFoundation
Доступность
Доступный в OS X v10.7 и позже.
-
-
Константы для указания режима воздействия устройства захвата изображения.
Объявление
Swift
enum AVCaptureExposureMode : Int { case Locked case AutoExpose case ContinuousAutoExposure }
Objective C
typedef enum : NSInteger { AVCaptureExposureModeLocked = 0, AVCaptureExposureModeAutoExpose = 1, AVCaptureExposureModeContinuousAutoExposure = 2, } AVCaptureExposureMode;
Константы
-
Locked
AVCaptureExposureModeLocked
Установка воздействия заблокирована.
Доступный в OS X v10.7 и позже.
-
AutoExpose
AVCaptureExposureModeAutoExpose
Устройство автоматически корректирует воздействие один раз и затем изменяет режим воздействия на
AVCaptureExposureModeLocked
.Доступный в OS X v10.7 и позже.
-
ContinuousAutoExposure
AVCaptureExposureModeContinuousAutoExposure
Устройство постоянно контролирует уровни воздействия, и автоматический представляет при необходимости.
Доступный в OS X v10.7 и позже.
Оператор импорта
Objective C
@import AVFoundation;
Swift
import AVFoundation
Доступность
Доступный в OS X v10.7 и позже.
-
-
Константы для указания режима баланса белого устройства захвата изображения.
Объявление
Swift
enum AVCaptureWhiteBalanceMode : Int { case Locked case AutoWhiteBalance case ContinuousAutoWhiteBalance }
Objective C
typedef enum : NSInteger { AVCaptureWhiteBalanceModeLocked = 0, AVCaptureWhiteBalanceModeAutoWhiteBalance = 1, AVCaptureWhiteBalanceModeContinuousAutoWhiteBalance = 2, } AVCaptureWhiteBalanceMode;
Константы
-
Locked
AVCaptureWhiteBalanceModeLocked
Установка баланса белого заблокирована.
Доступный в OS X v10.7 и позже.
-
AutoWhiteBalance
AVCaptureWhiteBalanceModeAutoWhiteBalance
Устройство выполняет автоматическую работу баланса белого теперь.
Доступный в OS X v10.7 и позже.
-
ContinuousAutoWhiteBalance
AVCaptureWhiteBalanceModeContinuousAutoWhiteBalance
Устройство постоянно контролирует баланс белого и корректируется при необходимости.
Доступный в OS X v10.7 и позже.
Оператор импорта
Objective C
@import AVFoundation;
Swift
import AVFoundation
Доступность
Доступный в OS X v10.7 и позже.
-
-
Константы, указывающие текущий режим управления передачей воспроизведения, если это имеет тот.
Объявление
Swift
enum AVCaptureDeviceTransportControlsPlaybackMode : Int { case NotPlayingMode case PlayingMode }
Objective C
typedef enum : NSInteger { AVCaptureDeviceTransportControlsNotPlayingMode = 0, AVCaptureDeviceTransportControlsPlayingMode = 1 } AVCaptureDeviceTransportControlsPlaybackMode;
Константы
-
NotPlayingMode
AVCaptureDeviceTransportControlsNotPlayingMode
Указывает, что лентопротяжный механизм не является поточным через голову игры.
Доступный в OS X v10.7 и позже.
-
PlayingMode
AVCaptureDeviceTransportControlsPlayingMode
Указывает, что лентопротяжный механизм является поточным через голову игры.
Доступный в OS X v10.7 и позже.
Оператор импорта
Objective C
@import AVFoundation;
Swift
import AVFoundation
Доступность
Доступный в OS X v10.7 и позже.
-
-
Отправленный, когда новое устройство становится доступным.
Объект уведомления
AVCaptureDevice
экземпляр, представляющий устройство, ставшее доступным.Оператор импорта
Objective C
@import AVFoundation;
Swift
import AVFoundation
Доступность
Доступный в OS X v10.7 и позже.
-
Отправленный, когда существующее устройство становится недоступным.
Объект уведомления
AVCaptureDevice
экземпляр, представляющий устройство, ставшее недоступным.Оператор импорта
Objective C
@import AVFoundation;
Swift
import AVFoundation
Доступность
Доступный в OS X v10.7 и позже.