QTCaptureConnection
Этот класс представляет соединение, по которому единый поток данных носителей отправляется от a QTCaptureInput
к a QTCaptureSession
и от a QTCaptureSession
к a QTCaptureOutput
.
Экземпляры QTCaptureConnection
оберните отдельные мультимедийные потоки, которыми можно быть предоставлены QTCaptureInput
объекты и полученный QTCaptureOutput
объекты. Соединения могут иметь тип среды QuickTime, такой как QTMediaTypeVideo
и QTMediaTypeSound
, и описание формата, описывающее носители, отправленные или полученные через соединение. Конкретные соединения, принадлежащие вводу, могут быть включены или отключены для ограничения, какие носители вводит сеанс получения, в то время как соединения, принадлежащие выводу, могут быть включены или отключены для ограничения, какие носители вводит вывод от сеанса получения. Кроме того, если a QTCaptureConnection
обертывает поток аудио носителей, он обеспечивает много атрибутов для управления объемом, соединением и включенными каналами аудио, проходящего через него.
QTCaptureConnection
объекты могли расширить атрибуты, что приложения могут считать использование attributeForKey:
и connectionAttributes
методы. Некоторые атрибуты те, для который attributeIsReadOnly:
возвраты метода NO
false
, может быть отредактирован с помощью setAttribute:forKey:
и setConnectionAttributes:
методы. В дополнение к этим явным методам приложения могут использовать кодирование значения ключа, чтобы получить и установить расширенные атрибуты. Для объекта, поддерживающего данный атрибут, valueForKey:
будет функционально идентично attributeForKey:
, и setValue:forKey:
будет идентично setAttribute:forKey:
. Приложения, желающие наблюдать изменения для данного атрибута, могут добавить наблюдателя значения ключа, где ключевой путь является ключом атрибута.
Оператор импорта
Swift
import QTKit
Objective C
@import QTKit;
Доступность
Доступный в QuickTime 7.2.1 и позже; QuickTime 7.2.1.
-
attributeForKey: - attributeForKey:
(OS X v10.9)Возвращает текущую стоимость атрибута соединения для ключа.
Объявление
Objective C
- (id)attributeForKey:(NSString *)
attributeKey
Обсуждение
Используйте этот метод для получения атрибутов соединения. Ключи, которые могут использоваться с этим методом, описаны в разделе Constants. Приложения с помощью кодирования значения ключа могут также получить атрибут для данного ключа путем передачи того ключа
NSObject valueForKey:
метод.Оператор импорта
Objective C
@import QTKit;
Доступность
OS X v10.5 и позже; QuickTime 7.2.1.
Осуждаемый в OS X v10.9.
-
attributeIsReadOnly: - attributeIsReadOnly:
(OS X v10.9)Возвращает булево значение, указывающее, не может ли быть изменен данный атрибут для соединения.
Объявление
Objective C
- (BOOL)attributeIsReadOnly:(NSString *)
attributeKey
Возвращаемое значение
Возвраты
YES
true
если не может быть изменен атрибут; иначе,NO
false
.Оператор импорта
Objective C
@import QTKit;
Доступность
OS X v10.5 и позже; QuickTime 7.2.1.
Осуждаемый в OS X v10.9.
-
connectionAttributes - connectionAttributes
(OS X v10.9)Возвращает словарь всего набора атрибутов для получателя.
Объявление
Objective C
- (NSDictionary *)connectionAttributes
Обсуждение
Приложения могут использовать этот метод для определения то, что приписывает определенное соединение поддержки.
Оператор импорта
Objective C
@import QTKit;
Доступность
OS X v10.5 и позже; QuickTime 7.2.1.
Осуждаемый в OS X v10.9.
-
formatDescription - formatDescription
(OS X v10.9)Возвращает описание формата получателя.
Объявление
Objective C
- (QTFormatDescription *)formatDescription
Обсуждение
Этот метод возвращает описание формата соединения, позволяя приложениям контролировать различные атрибуты носителей, отправляемых или полученных соединением (размер дисплея видео носителей, например). Приложения могут быть уведомлены относительно изменений в формате соединения путем регистрации для получения
QTCaptureConnectionFormatDescriptionWillChangeNotification
иQTCaptureConnectionFormatDescriptionDidChangeNotification
уведомления или путем добавления наблюдателя значения ключа к соединению для ключа@"formatDescription"
.Оператор импорта
Objective C
@import QTKit;
Доступность
OS X v10.5 и позже; QuickTime 7.2.1.
Осуждаемый в OS X v10.9.
-
isEnabled - isEnabled
(OS X v10.9)Возвращает булево значение, указывающее, включен ли получатель.
Объявление
Objective C
- (BOOL)isEnabled
Обсуждение
Этот метод возвращает булевскую переменную, указывающую, позволяют ли получателю отправить или получить данные носителей. Конкретные соединения могут быть включены или отключили использование
setEnabled:
метод.Оператор импорта
Objective C
@import QTKit;
Доступность
OS X v10.5 и позже; QuickTime 7.2.1.
Осуждаемый в OS X v10.9.
-
mediaType - mediaType
(OS X v10.9)Возвращает тип среды QuickTime получателя.
Объявление
Objective C
- (NSString *)mediaType
Возвращаемое значение
Тип среды QuickTime, как определено в
QTMedia.h
.Обсуждение
Этот метод возвращает тип среды QuickTime, такой как
QTMediaTypeVideo
иQTMediaTypeSound
, из получателя.Оператор импорта
Objective C
@import QTKit;
Доступность
OS X v10.5 и позже; QuickTime 7.2.1.
Осуждаемый в OS X v10.9.
-
владелец - владелец
(OS X v10.9)Возвраты
QTCaptureInput
илиQTCaptureOutput
объект, которому принадлежит получатель.Объявление
Objective C
- (id)owner
Возвращаемое значение
A
QTCaptureInput
илиQTCaptureOutput
возразите, что использует получатель в качестве соединения носителей.Обсуждение
Этот метод возвращает ввод или вывод, которому принадлежит получатель. Возвращенный ввод или вывод использует получатель в качестве соединения для отправки или получения мультимедийного потока.
Оператор импорта
Objective C
@import QTKit;
Доступность
OS X v10.5 и позже; QuickTime 7.2.1.
Осуждаемый в OS X v10.9.
-
setAttribute:forKey: - setAttribute:forKey:
(OS X v10.9)Устанавливает атрибут соединения для данного ключа.
Объявление
Objective C
- (void)setAttribute:(id)
attribute
forKey:(NSString *)key
Обсуждение
Используйте этот метод для установки атрибутов соединения получения. Ключи, которые могут использоваться с этим методом, описаны в разделе Constants. Если атрибут только для чтения или не поддерживаемый получателем, этот метод повышает NSInvalidArgumentException. Приложения с помощью кодирования значения ключа могут также установить атрибут для данного ключа путем передачи того ключа
NSObject setValue:forKey:
метод.Оператор импорта
Objective C
@import QTKit;
Доступность
OS X v10.5 и позже; QuickTime 7.2.1.
Осуждаемый в OS X v10.9.
-
setConnectionAttributes: - setConnectionAttributes:
(OS X v10.9)Устанавливает атрибуты соединения от пар ключ/значение, указанных в данном словаре.
Объявление
Objective C
- (void)setConnectionAttributes:(NSDictionary *)
connectionAttributes
Обсуждение
Этот метод позволяет приложению устанавливать многократные атрибуты на соединении сразу. Если какой-либо из атрибутов в словаре только для чтения или не поддерживаемый получателем, этот метод повышает NSInvalidArgumentException. Приложения с помощью кодирования значения ключа могут также установить многократные атрибуты с помощью
NSObject setValuesForKeysWithDictionary:
метод с помощью ключей атрибута в качестве ключей в словаре.Оператор импорта
Objective C
@import QTKit;
Доступность
OS X v10.5 и позже; QuickTime 7.2.1.
Осуждаемый в OS X v10.9.
-
setEnabled: - setEnabled:
(OS X v10.9)Наборы, включен ли получатель.
Объявление
Objective C
- (void)setEnabled:(BOOL)
enabled
Обсуждение
Этот метод устанавливает, позволяют ли получателю отправить или получить данные носителей.
Оператор импорта
Objective C
@import QTKit;
Доступность
OS X v10.5 и позже; QuickTime 7.2.1.
Осуждаемый в OS X v10.9.
-
Приложения могут использовать следующие константы, чтобы вывести на экран метры уровня звука для определенных соединений и указать объемы звуковых каналов. Эти строковые значения могут использоваться по ключевым путям для кодирования значения ключа, наблюдения значения ключа и привязки.
Объявление
Objective C
NSString * const QTCaptureConnectionAudioAveragePowerLevelsAttribute; NSString * const QTCaptureConnectionAudioPeakHoldLevelsAttribute; NSString * const QTCaptureConnectionAudioMasterVolumeAttribute; NSString * const QTCaptureConnectionAudioVolumesAttribute; NSString * const QTCaptureConnectionEnabledAudioChannelsAttribute;
Константы
-
QTCaptureConnectionAudioAveragePowerLevelsAttribute
QTCaptureConnectionAudioAveragePowerLevelsAttribute
NSArray
изNSNumbers
это соответствует средней мощности, в децибелах, каждого аудиопотока, отправленного через соединение.Приложения, хотящие вывести на экран метры уровня звука для определенного соединения, могут периодически проверять значение этого атрибута. Уровни средней мощности изменяются быстро и кажутся нервными на индикаторе уровня. Это строковое значение может использоваться по ключевым путям для кодирования значения ключа, наблюдения значения ключа и привязки.
Доступный в OS X v10.5 и позже.
Осуждаемый в OS X v10.9.
-
QTCaptureConnectionAudioPeakHoldLevelsAttribute
QTCaptureConnectionAudioPeakHoldLevelsAttribute
NSArray
изNSNumbers
это соответствует пиковому уровню хранения, в децибелах, каждого звукового канала, отправленного через соединение.Приложения, хотящие вывести на экран метры уровня звука для определенного соединения, могут периодически проверять значение этого атрибута. Пиковые уровни хранения остаются в максимальной громкости в течение приблизительно секунды, и часто полезны для отображения аудио отсечения. Это строковое значение может использоваться по ключевым путям для кодирования значения ключа, наблюдения значения ключа и привязки.
Доступный в OS X v10.5 и позже.
Осуждаемый в OS X v10.9.
-
QTCaptureConnectionAudioMasterVolumeAttribute
QTCaptureConnectionAudioMasterVolumeAttribute
NSNumber
это указывает общую громкость всех звуковых каналов, отправленных через соединение.Значения между 0,0 и 1.0 для нормальной громкости, или больше, чем 1,0 для повышения усиления звуковых частот. Этот атрибут определяет общую громкость всех звуковых каналов, отправленных через соединение. Приложения, которые должны регулировать громкость отдельных каналов, могут установить
QTCaptureConnectionAudioVolumesAttribute
атрибут. Это строковое значение может использоваться по ключевым путям для кодирования значения ключа, наблюдения значения ключа и привязки.Доступный в OS X v10.5 и позже.
Осуждаемый в OS X v10.9.
-
QTCaptureConnectionAudioVolumesAttribute
QTCaptureConnectionAudioVolumesAttribute
NSArray
изNSNumbers
это указывает объемы звуковых каналов, отправленных через соединение.Значения между 0,0 и 1.0 для нормальной громкости, или больше, чем 1,0 для повышения усиления звуковых частот. Этот атрибут определяет отдельные объемы звуковых каналов, отправленных через соединение. Приложения, которые должны регулировать общую громкость всех каналов, могут установить
QTCaptureConnectionAudioMasterVolumeAttribute
атрибут. Это строковое значение может использоваться по ключевым путям для кодирования значения ключа, наблюдения значения ключа и привязки.Доступный в OS X v10.5 и позже.
Осуждаемый в OS X v10.9.
-
QTCaptureConnectionEnabledAudioChannelsAttribute
QTCaptureConnectionEnabledAudioChannelsAttribute
NSIndexSet
это указывает, какие звуковые каналы должны быть отправлены через соединение. Индексы в наборе должны быть между 0 и число объемов вQTCaptureConnectionAudioVolumesAttribute
. Этот атрибут позволяет приложениям выборочно отключать определенные звуковые каналы от того, чтобы быть отправленным через соединение. Значение этого атрибута должно бытьNSIndexSet
это содержит только каналы, которые должны использоваться. По умолчанию все звуковые каналы отправляются хотя соединение. Это строковое значение может использоваться по ключевым путям для кодирования значения ключа, наблюдения значения ключа и привязки.Доступный в OS X v10.5 и позже.
Осуждаемый в OS X v10.9.
-
-
Отправленный, когда изменился один из атрибутов соединения.
Пользовательский информационный словарь уведомления будет содержать ключ атрибута измененного атрибута для ключа
QTCaptureConnectionChangedAttributeKey
.Оператор импорта
Objective C
@import QTKit;
Доступность
Доступный в OS X v10.5 и позже.
Осуждаемый в OS X v10.9.
-
QTCaptureConnectionAttributeWillChangeNotification QTCaptureConnectionAttributeWillChangeNotification
Отправленный, когда один из атрибутов соединения собирается измениться.
Пользовательский информационный словарь уведомления будет содержать ключ атрибута измененного атрибута для ключа
QTCaptureConnectionChangedAttributeKey
.Оператор импорта
Objective C
@import QTKit;
Доступность
Доступный в OS X v10.5 и позже.
Осуждаемый в OS X v10.9.
-
Используемый в качестве ключа в пользовательском информационном словаре передал
QTCaptureConnectionAttributeWillChangeNotification
, иQTCaptureConnectionAttributeDidChangeNotification
указать ключ того изменившегося атрибута.Оператор импорта
Objective C
@import QTKit;
Доступность
Доступный в OS X v10.5 и позже.
Осуждаемый в OS X v10.9.
-
QTCaptureConnectionFormatDescriptionDidChangeNotification QTCaptureConnectionFormatDescriptionDidChangeNotification
Отправленный, когда изменилось описание формата соединения.
Приложения могут быть уведомлены относительно изменений в формате соединения путем регистрации для получения этого уведомления.
Оператор импорта
Objective C
@import QTKit;
Доступность
Доступный в OS X v10.5 и позже.
Осуждаемый в OS X v10.9.
-
QTCaptureConnectionFormatDescriptionWillChangeNotification QTCaptureConnectionFormatDescriptionWillChangeNotification
Отправленный, когда описание формата соединения собирается измениться.
Приложения могут быть уведомлены относительно изменений в формате соединения путем регистрации для получения этого уведомления.
Оператор импорта
Objective C
@import QTKit;
Доступность
Доступный в OS X v10.5 и позже.
Осуждаемый в OS X v10.9.