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

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

Разработчик

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

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

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

AVAudioSessionDataSourceDescription

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

  • NSObject
  • AVAudioSessionDataSourceDescription
  • NSObject
  • AVAudioSessionDataSourceDescription

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

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

Swift

import AVFoundation

Objective C

@import AVFoundation;

Доступность

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

AVAudioSessionDataSourceDescription класс определяет источник данных для аудиовхода или вывода, предоставляя информацию, такую как имя источника, расположение и ориентация.

Вы получаете описания источника данных из совместно используемого AVAudioSession возразите или AVAudioSessionPortDescription объекты, соответствующие его портам ввода и вывода. Только встроенные порты микрофона на определенных устройствах поддерживают расположение, ориентацию и свойства диаграммы направленности; если порт не поддерживает эти функции, значение dataSources свойство nil.

Этот класс особенно полезен для дифференциации между конфигурациями микрофона на устройствах, имеющих больше чем один встроенный микрофон. Такие устройства могут также поддерживать функции обработки сигналов для пространственной фильтрации или формирования луча, в котором устройство сделано более чувствительным к звуковым сигналам от определенного направления. (См. “Data Source Polar Patterns”.)

Получение информации об источнике данных
  • dataSourceID Свойство

    Присвоенный системе идентификатор для источника данных. (только для чтения)

    Объявление

    Swift

    var dataSourceID: NSNumber! { get }

    Objective C

    @property(readonly) NSNumber *dataSourceID

    Обсуждение

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

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

    Objective C

    @import AVFoundation;

    Swift

    import AVFoundation

    Доступность

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

  • dataSourceName Свойство

    Человекочитаемое имя для источника данных. (только для чтения)

    Объявление

    Swift

    var dataSourceName: String! { get }

    Objective C

    @property(readonly) NSString *dataSourceName

    Обсуждение

    Это имя может быть выведено на экран пользователю.

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

    Objective C

    @import AVFoundation;

    Swift

    import AVFoundation

    Доступность

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

  • location Свойство

    Расположение источника данных на устройстве. (только для чтения)

    Объявление

    Swift

    var location: String! { get }

    Objective C

    @property(readonly) NSString *location

    Обсуждение

    Если nil, расположение источника данных не известно.

    Посмотрите “Data Source Locations” для возможных значений.

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

    Objective C

    @import AVFoundation;

    Swift

    import AVFoundation

    Доступность

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

  • orientation Свойство

    Ориентация источника данных относительно естественной ориентации устройства. (только для чтения)

    Объявление

    Swift

    var orientation: String! { get }

    Objective C

    @property(readonly) NSString *orientation

    Обсуждение

    Если nil, ориентация источника данных не известна.

    Посмотрите “Data Source Orientations” для возможных значений.

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

    Objective C

    @import AVFoundation;

    Swift

    import AVFoundation

    Доступность

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

Конфигурирование направленности микрофона
  • selectedPolarPattern Свойство

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

    Объявление

    Swift

    var selectedPolarPattern: String! { get }

    Objective C

    @property(readonly) NSString *selectedPolarPattern

    Обсуждение

    Если nil, источник данных не поддерживает конфигурацию направленности.

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

    Objective C

    @import AVFoundation;

    Swift

    import AVFoundation

    Доступность

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

  • supportedPolarPatterns Свойство

    Набор конфигураций направленности поддерживал по условию источник. (только для чтения)

    Объявление

    Swift

    var supportedPolarPatterns: [AnyObject]! { get }

    Objective C

    @property(readonly) NSArray *supportedPolarPatterns

    Обсуждение

    Один или больше констант в “Data Source Polar Patterns”, или nil если источник данных не поддерживает конфигурацию направленности. Эта функция доступна только на встроенном порту микрофона для определенных устройств.

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

    Objective C

    @import AVFoundation;

    Swift

    import AVFoundation

    Доступность

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

  • preferredPolarPattern Свойство

    Предпочтительная конфигурация направленности для источника данных. (только для чтения)

    Объявление

    Swift

    var preferredPolarPattern: String! { get }

    Objective C

    @property(readonly) NSString *preferredPolarPattern

    Обсуждение

    Если nil, источник данных не поддерживает конфигурацию направленности, или никакая предпочтительная диаграмма направленности не была выбрана.

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

    Objective C

    @import AVFoundation;

    Swift

    import AVFoundation

    Доступность

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

  • setPreferredPolarPattern (_: ошибка:) - setPreferredPolarPattern:error:

    Выбирает предпочтительную конфигурацию направленности для источника данных.

    Объявление

    Swift

    func setPreferredPolarPattern(_ pattern: String!, error outError: NSErrorPointer) -> Bool

    Objective C

    - (BOOL)setPreferredPolarPattern:(NSString *)pattern error:(NSError **)outError

    Параметры

    pattern

    Конфигурация направленности, которая будет использоваться.

    outError

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

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

    YEStrue если запрос был успешно выполнен, или NOfalse иначе.

    Обсуждение

    Запрашивает изменение в выбранной диаграмме направленности; чтобы определить, вступает ли изменение в силу, используйте selectedPolarPattern свойство. (См. “Конфигурирование Аудио Сеанса” в AVAudioSession ссылка класса для подробных данных.)

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

    Установите предпочтительную диаграмму направленности только после установки категории и режима аудио сеанса и активации сеанса.

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

    Objective C

    @import AVFoundation;

    Swift

    import AVFoundation

    Доступность

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

Константы
  • Расположения источника данных

    Расположение источника данных на устройстве, относительно естественной ориентации устройства.

    Объявление

    Swift

    let AVAudioSessionLocationUpper: String let AVAudioSessionLocationLower: String

    Objective C

    NSString *const AVAudioSessionLocationUpper; NSString *const AVAudioSessionLocationLower;

    Константы

    • AVAudioSessionLocationUpper

      Источник данных расположен около верхнего края устройства.

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

    • AVAudioSessionLocationLower

      Источник данных расположен около заднего конца устройства.

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

  • Ориентации источника данных

    Направление, в котором источник данных указывает относительно естественной ориентации устройства.

    Объявление

    Swift

    let AVAudioSessionOrientationTop: String let AVAudioSessionOrientationBottom: String let AVAudioSessionOrientationFront: String let AVAudioSessionOrientationBack: String

    Objective C

    NSString *const AVAudioSessionOrientationTop; NSString *const AVAudioSessionOrientationBottom; NSString *const AVAudioSessionOrientationFront; NSString *const AVAudioSessionOrientationBack;

    Константы

    • AVAudioSessionOrientationTop

      Источник данных указывает вверх.

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

    • AVAudioSessionOrientationBottom

      Источник данных указывает вниз.

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

    • AVAudioSessionOrientationFront

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

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

    • AVAudioSessionOrientationBack

      Точки источника данных, исходящие от задней части устройства, далеко от пользователя.

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

  • Диаграммы направленности источника данных

    Константы, описывающие опции для направленности микрофона.

    Объявление

    Swift

    let AVAudioSessionPolarPatternOmnidirectional: String let AVAudioSessionPolarPatternCardioid: String let AVAudioSessionPolarPatternSubcardioid: String

    Objective C

    NSString *const AVAudioSessionPolarPatternOmnidirectional; NSString *const AVAudioSessionPolarPatternCardioid; NSString *const AVAudioSessionPolarPatternSubcardioid;

    Константы

    • AVAudioSessionPolarPatternOmnidirectional

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

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

    • AVAudioSessionPolarPatternCardioid

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

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

    • AVAudioSessionPolarPatternSubcardioid

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

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

    Обсуждение

    Обратите внимание на то, что направление диаграммы направленности относительно ориентации источника данных. Например, можно использовать кардиоидный образец с обращенным к задней стороне источником данных, чтобы более ясно записать звук из-за устройства, или с обращенным к передней стороне источником данных, чтобы более ясно записать звук от перед устройством (таким как речь пользователя).