AVAudioFormat

AVAudioFormat класс обертывает Core Audio AudioStreamBasicDescription структура, с инициализаторами удобства и средствами доступа для распространенных форматов, включая стандарт Core Audio устранила чередование 32-разрядного формата с плавающей точкой.

Экземпляры этого класса являются неизменными.

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

NSObject
AVAudioFormat

NSObject
AVAudioFormat

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

AnyObject
CVarArgType
Equatable
Hashable
NSObjectProtocol
Печатаемый
NSObject

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

Swift

import AVFoundation

Objective C

@import AVFoundation;

Доступность

Доступный в OS X v10.10 и позже.

Создание нового представления формата аудио


    
    init (standardFormatWithSampleRate:channelLayout:)
    - initStandardFormatWithSampleRate:channelLayout:

Инициализирует недавно выделенный экземпляр формата аудио как устраненное чередование плавание с указанной частотой дискретизации и расположение канала..

Объявление

Swift

init!(standardFormatWithSampleRate sampleRate: Double, channelLayout layout: AVAudioChannelLayout!)

Objective C

- (instancetype)initStandardFormatWithSampleRate:(double)sampleRate channelLayout:(AVAudioChannelLayout *)layout

Параметры

`sampleRate`	Частота дискретизации, в герц.
`layout`	Расположение канала. Не должен быть `nil`.

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

Инициализированный AVAudioFormat экземпляр.

Обсуждение

Возвращенный AVAudioFormat экземпляр использует AVAudioPCMFormatFloat32 формат.

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

Objective C

@import AVFoundation;

Swift

import AVFoundation

Доступность

Доступный в OS X v10.10 и позже.

См. также

– initStandardFormatWithSampleRate:channelLayout:
sampleRate
channelLayout


    
    init (standardFormatWithSampleRate:channels:)
    - initStandardFormatWithSampleRate:channels:

Инициализирует недавно выделенный экземпляр формата аудио с указанной частотой дискретизации и количеством каналов.

Объявление

Swift

init!(standardFormatWithSampleRate sampleRate: Double, channels channels: AVAudioChannelCount)

Objective C

- (instancetype)initStandardFormatWithSampleRate:(double)sampleRate channels:(AVAudioChannelCount)channels

Параметры

`sampleRate`	Частота дискретизации, в герц.
`channels`	Количество каналов.

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

Инициализированный AVAudioFormat экземпляр.

Обсуждение

Возвращенный AVAudioFormat экземпляр использует AVAudioPCMFormatFloat32 формат.

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

Objective C

@import AVFoundation;

Swift

import AVFoundation

Доступность

Доступный в OS X v10.10 и позже.

См. также

– initStandardFormatWithSampleRate:channelLayout:
sampleRate
channelLayout


    
    init (commonFormat:sampleRate:channels:interleaved:)
    - initWithCommonFormat:sampleRate:channels:interleaved:

Инициализирует недавно выделенный экземпляр формата аудио

Объявление

Swift

init!(commonFormat format: AVAudioCommonFormat, sampleRate sampleRate: Double, channels channels: AVAudioChannelCount, interleaved interleaved: Bool)

Objective C

- (instancetype)initWithCommonFormat:(AVAudioCommonFormat)format sampleRate:(double)sampleRate channels:(AVAudioChannelCount)channels interleaved:(BOOL)interleaved

Параметры

`format`	Формат аудио. Посмотрите `AVAudioCommonFormat` для значений.
`sampleRate`	Частота дискретизации, в герц.
`channels`	Количество каналов.
`interleaved`	`YEStrue` если чередован формат аудио; иначе `NOfalse`.

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

Инициализированный AVAudioFormat экземпляр.

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

Objective C

@import AVFoundation;

Swift

import AVFoundation

Доступность

Доступный в OS X v10.10 и позже.

См. также

– initWithCommonFormat:sampleRate:interleaved:channelLayout:
commonFormat
sampleRate
чередованный


    
    init (commonFormat:sampleRate:interleaved:channelLayout:)
    - initWithCommonFormat:sampleRate:interleaved:channelLayout:

Инициализирует недавно выделенный экземпляр формата аудио с указанным автоматическим форматом, частотой дискретизации, чередованным форматом и расположением канала.

Объявление

Swift

init!(commonFormat format: AVAudioCommonFormat, sampleRate sampleRate: Double, interleaved interleaved: Bool, channelLayout layout: AVAudioChannelLayout!)

Objective C

- (instancetype)initWithCommonFormat:(AVAudioCommonFormat)format sampleRate:(double)sampleRate interleaved:(BOOL)interleaved channelLayout:(AVAudioChannelLayout *)layout

Параметры

`format`	Формат аудио. Посмотрите `AVAudioCommonFormat` для значений.
`sampleRate`	Частота дискретизации, в герц.
`interleaved`	`YEStrue` если чередован формат аудио; иначе `NOfalse`.
`layout`	Расположение канала. Не должен быть `nil`.

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

Инициализированный AVAudioFormat экземпляр.

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

Objective C

@import AVFoundation;

Swift

import AVFoundation

Доступность

Доступный в OS X v10.10 и позже.

См. также

– initWithCommonFormat:sampleRate:channels:interleaved:
commonFormat
sampleRate
чередованный
channelLayout


    
    init (настройки:)
    - initWithSettings:

Инициализирует недавно выделенный экземпляр формата аудио с помощью словаря настроек.

Объявление

Swift

init!(settings settings: [NSObject : AnyObject]!)

Objective C

- (instancetype)initWithSettings:(NSDictionary *)settings

Параметры


      settings

Словарь настроек. См. Константы Параметров звука Основы AV для поддерживаемых пар ключ/значение.

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

Инициализированный AVAudioFormat экземпляр.

Обсуждение

Много элементов словаря настроек принадлежат настройкам кодера, не основному формату, и будут проигнорированы.

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

Objective C

@import AVFoundation;

Swift

import AVFoundation

Доступность

Доступный в OS X v10.10 и позже.

init (streamDescription:) - initWithStreamDescription:

Инициализирует недавно выделенный экземпляр формата аудио из потокового описания.

Объявление

Swift

init!(streamDescription asbd: UnsafePointer<AudioStreamBasicDescription>)

Objective C

- (instancetype)initWithStreamDescription:(const AudioStreamBasicDescription *)asbd

Параметры

asbd

AudioStreamBasicDescription структура.

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

Инициализированный AVAudioFormat экземпляр, или nil если инициализация перестала работать.

Обсуждение

Если AudioStreamBasicDescription указывает больше чем 2 канала, этот метод сбои и возвраты nil. Вместо этого необходимо использовать initWithStreamDescription:channelLayout: метод.

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

Objective C

@import AVFoundation;

Swift

import AVFoundation

Доступность

Доступный в OS X v10.10 и позже.


    
    init (streamDescription:channelLayout:)
    - initWithStreamDescription:channelLayout:

Инициализирует недавно выделенный экземпляр формата аудио из потокового описания и расположения канала.

Объявление

Swift

init!(streamDescription asbd: UnsafePointer<AudioStreamBasicDescription>, channelLayout layout: AVAudioChannelLayout!)

Objective C

- (instancetype)initWithStreamDescription:(const AudioStreamBasicDescription *)asbd channelLayout:(AVAudioChannelLayout *)layout

Параметры

`asbd`	`AudioStreamBasicDescription` структура.
`layout`	Расположение канала. Если `nil`, и asbd указывает 1 или 2 канала, моно или расположение стерео принято, соответственно.

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

Инициализированный AVAudioFormat экземпляр, или nil если инициализация перестала работать.

Обсуждение

Если AudioStreamBasicDescription указывает больше чем 2 канала и layout nil, этот метод сбои и возвраты nil.

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

Objective C

@import AVFoundation;

Swift

import AVFoundation

Доступность

Доступный в OS X v10.10 и позже.

Получение описания аудиопотока

streamDescription streamDescription Свойство

Описание аудиопотока. (только для чтения)

Объявление

Swift

var streamDescription: UnsafePointer<AudioStreamBasicDescription> { get }

Objective C

@property(nonatomic, readonly) const AudioStreamBasicDescription *streamDescription

Обсуждение

Возвраты AudioStreamBasicDescription структура, для использования с аудио APIs низшего уровня.

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

Objective C

@import AVFoundation;

Swift

import AVFoundation

Доступность

Доступный в OS X v10.10 и позже.

Сравнение экземпляров

isEqual (_:) - isEqual:

Возвращает булево значение, указывающее, имеют ли экземпляр формата audo и данный объект идентичные параметры формата.

Объявление

Swift

func isEqual(_ object: AnyObject!) -> Bool

Objective C

- (BOOL)isEqual:(id)object

Параметры

object

Объект, который будет сравнен.

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

YEStrue если получатель и object равны, иначе NOfalse.

Обсуждение

Этот метод определяет то, что это означает для экземпляров быть равным. Два объекта считают равными, если и только если они возвращают идентичные значения для всех настроек.

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

Objective C

@import AVFoundation;

Swift

import AVFoundation

Доступность

Доступный в OS X v10.10 и позже.

Получение значений формата аудио

channelCount channelCount Свойство

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

Объявление

Swift

var channelCount: AVAudioChannelCount { get }

Objective C

@property(nonatomic, readonly) AVAudioChannelCount channelCount

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

Objective C

@import AVFoundation;

Swift

import AVFoundation

Доступность

Доступный в OS X v10.10 и позже.

См. также

channelLayout
channelLayout channelLayout Свойство

Базовое расположение звукового канала. (только для чтения)

Объявление

Swift

var channelLayout: AVAudioChannelLayout! { get }

Objective C

@property(nonatomic, readonly) const AVAudioChannelLayout *channelLayout

Обсуждение

Значение является базовым экземпляром AVAudioChannelLayout.

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

Objective C

@import AVFoundation;

Swift

import AVFoundation

Доступность

Доступный в OS X v10.10 и позже.

См. также

channelCount
sampleRate sampleRate Свойство

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

Объявление

Swift

var sampleRate: Double { get }

Objective C

@property(nonatomic, readonly) double sampleRate

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

Objective C

@import AVFoundation;

Swift

import AVFoundation

Доступность

Доступный в OS X v10.10 и позже.

Определение формата аудио

стандарт стандарт Свойство

Описывает, является ли формат устраненным чередование плаванием собственного порядка байтов. (только для чтения)

Объявление

Swift

var standard: Bool { get }

Objective C

@property(nonatomic, readonly, getter=isStandard) BOOL standard

Обсуждение

YEStrue если формат является устраненным чередование плаванием собственного порядка байтов (AVAudioPCMFormatFloat32), иначе NOfalse.

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

Objective C

@import AVFoundation;

Swift

import AVFoundation

Доступность

Доступный в OS X v10.10 и позже.
чередованный чередованный Свойство

Описывает, чередованы ли выборки. (только для чтения)

Объявление

Swift

var interleaved: Bool { get }

Objective C

@property(nonatomic, readonly, getter=isInterleaved) BOOL interleaved

Обсуждение

Для форматов non-PCM это значение не определено.

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

Objective C

@import AVFoundation;

Swift

import AVFoundation

Доступность

Доступный в OS X v10.10 и позже.
commonFormat commonFormat Свойство

Возвращает идентификатор распространенного формата (только для чтения)

Объявление

Swift

var commonFormat: AVAudioCommonFormat { get }

Objective C

@property(nonatomic, readonly) AVAudioCommonFormat commonFormat

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

Objective C

@import AVFoundation;

Swift

import AVFoundation

Доступность

Доступный в OS X v10.10 и позже.
настройки настройки Свойство

Формат, представленный как словарь с ключами от AVAudioSettings (только для чтения)

Объявление

Swift

var settings: [NSObject : AnyObject]! { get }

Objective C

@property(nonatomic, readonly) NSDictionary *settings

Обсуждение

Не все форматы, представимые AudioStreamBasicDescription структура (конкретная реализация) может быть представлена в словаре настроек; в этом случае, nil возвращается.

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

Objective C

@import AVFoundation;

Swift

import AVFoundation

Доступность

Доступный в OS X v10.10 и позже.

Константы

AVAudioCommonFormat
Эти константы описывают общие форматы аудио.

Объявление

Swift

enum AVAudioCommonFormat : UInt { case OtherFormat case PCMFormatFloat32 case PCMFormatFloat64 case PCMFormatInt16 case PCMFormatInt32 }

Objective C

enum { AVAudioOtherFormat = 0, AVAudioPCMFormatFloat32 = 1, AVAudioPCMFormatFloat64 = 2, AVAudioPCMFormatInt16 = 3, AVAudioPCMFormatInt32 = 4 }; typedef NSUInteger AVAudioCommonFormat;

Константы
- OtherFormat
  
  AVAudioOtherFormat
  
  Формат кроме одного указанного перечислением.
  
  Доступный в OS X v10.10 и позже.
- PCMFormatFloat32
  
  AVAudioPCMFormatFloat32
  
  Плавания собственного порядка байтов. Это - стандартный формат.
  
  Доступный в OS X v10.10 и позже.
- PCMFormatFloat64
  
  AVAudioPCMFormatFloat64
  
  Собственный порядок байтов удваивается.
  
  Доступный в OS X v10.10 и позже.
- PCMFormatInt16
  
  AVAudioPCMFormatInt16
  
  16-разрядные целые числа собственного порядка байтов со знаком.
  
  Доступный в OS X v10.10 и позже.
- PCMFormatInt32
  
  AVAudioPCMFormatInt32
  
  32-разрядные целые числа собственного порядка байтов со знаком.
  
  Доступный в OS X v10.10 и позже.
Оператор импорта

Objective C

@import AVFoundation;

Swift

import AVFoundation

Доступность

Доступный в OS X v10.10 и позже.