AudioGraph Класс

Определение

Пространство имен:

Windows.Media.Audio

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

public ref class AudioGraph sealed : IClosable

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class AudioGraph final : IClosable

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public sealed class AudioGraph : System.IDisposable

Public NotInheritable Class AudioGraph
Implements IDisposable

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

Object Platform::Object IInspectable AudioGraph

Атрибуты

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Реализации

IClosable IDisposable

Требования к Windows

Семейство устройств	Windows 10 (появилось в 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (появилось в v1.0)
Возможности приложения	backgroundMediaRecording

Комментарии

Звуковой граф состоит из входных, выходных и субмикшных узлов. Входные узлы включают звуковые файлы, звуковые устройства и код, который создает звуковые данные. Выходные узлы также включают звуковые файлы, звуковые устройства и код, обрабатывающий звуковые данные. При запуске графа звуковые данные передаются через граф от входных узлов через любые узлы подмикса к выходным узлам. Каждый узел может иметь ноль или более звуковых эффектов, которые применяются к звуковым данным перед их передачей в следующий узел. Этот класс и связанные API позволяют быстрее и проще разрабатывать звуковые приложения, чем низкоуровневые API-интерфейсы COM XAudio2. Инструкции по использованию звуковых графов см. в разделе Звуковые графы.

Получите экземпляр этого класса, вызвав AudioGraph.CreateAsync.

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

Примечание

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

Невозможно создать экземпляр AudioGraph в выпусках N и KN Windows 8 и Windows 10, если не установлен дополнительный пакет дополнительных компонентов мультимедиа. Дополнительные сведения см. в разделе Пакет дополнительных компонентов мультимедиа для выпусков Windows N.

Журнал версий

Версия Windows	Версия пакета SDK	Добавленная стоимость
1607	14393	CreateBatchUpdater
1607	14393	CreateDeviceInputNodeAsync(MediaCategory,AudioEncodingProperties,DeviceInformation,AudioNodeEmitter)
1607	14393	CreateFileInputNodeAsync(IStorageFile,AudioNodeEmitter)
1607	14393	CreateFrameInputNode(AudioEncodingProperties,AudioNodeEmitter)
1607	14393	CreateSubmixNode(AudioEncodingProperties,AudioNodeEmitter)
1803	17134	CreateMediaSourceAudioInputNodeAsync(MediaSource)
1803	17134	CreateMediaSourceAudioInputNodeAsync(MediaSource,AudioNodeEmitter)

Свойства

CompletedQuantumCount	Возвращает завершенное квантовое число для звукового графа.
EncodingProperties	Возвращает свойства кодирования для звукового графа.
LatencyInSamples	Возвращает задержку в примерах, поддерживаемых звуковым графом.
PrimaryRenderDevice	Возвращает основное устройство отрисовки для звукового графа.
RenderDeviceAudioProcessing	Возвращает значение, указывающее режим обработки звука для звукового графа.
SamplesPerQuantum	Возвращает количество выборок на квант, с которым в данный момент работает звуковой граф.

Методы

Close()	Закрывает звуковой граф и удаляет связанные с ним ресурсы.
CreateAsync(AudioGraphSettings)	Создает звуковой граф с определенными параметрами.
CreateBatchUpdater()	Создает новый объект AudioGraphBatchUpdater для AudioGraph , который приводит к накоплению всех последующих изменений всех узлов звукового графа, а затем фиксации после закрытия или удаления объекта пакетного модуля обновления приложения.
CreateDeviceInputNodeAsync(MediaCategory)	Создает audioDeviceInputNode, который вводит звуковые данные в граф звука с устройства ввода звука по умолчанию, например с микрофона или звукового карта.
CreateDeviceInputNodeAsync(MediaCategory, AudioEncodingProperties)	Создает audioDeviceInputNode, который вводит звуковые данные в звуковой граф с устройства ввода звука по умолчанию, такого как микрофон или звуковой карта.
CreateDeviceInputNodeAsync(MediaCategory, AudioEncodingProperties, DeviceInformation)	Создает audioDeviceInputNode, который вводит звуковые данные в звуковой граф с указанного устройства ввода звука, такого как микрофон или звуковой карта.
CreateDeviceInputNodeAsync(MediaCategory, AudioEncodingProperties, DeviceInformation, AudioNodeEmitter)	Создает пространственный звуковой объект AudioDeviceInputNode, который вводит звуковые данные в звуковой граф с указанного аудиоустройства, например микрофона или звукового карта.
CreateDeviceOutputNodeAsync()	Создает новый audioDeviceOutputNode , который выводит звуковые данные из звукового графа на устройство вывода системы по умолчанию, например динамики или наушники.
CreateFileInputNodeAsync(IStorageFile)	Создает audioFileInputNode , который вводит звуковые данные в звуковой граф из файла хранилища.
CreateFileInputNodeAsync(IStorageFile, AudioNodeEmitter)	Создает пространственный звуковой объект AudioFileInputNode , который вводит звуковые данные в звуковой граф из файла хранилища.
CreateFileOutputNodeAsync(IStorageFile)	Создает новый объект AudioFileOutputNode , который выводит звуковые данные из звукового графа в указанный файл хранилища.
CreateFileOutputNodeAsync(IStorageFile, MediaEncodingProfile)	Создает новый объект AudioFileOutuputNode , который выводит звуковые данные из звукового графа в указанный файл хранилища.
CreateFrameInputNode()	Создает AudioFrameInputNode , который вводит звуковые данные, созданные реализованным приложением кодом, в звуковой граф.
CreateFrameInputNode(AudioEncodingProperties)	Создает объект AudioFrameInputNode с указанными свойствами кодирования, который вводит звуковые данные, созданные с помощью кода, реализованного приложением, в звуковой граф.
CreateFrameInputNode(AudioEncodingProperties, AudioNodeEmitter)	Создает пространственный звуковой объект AudioFrameInputNode с указанными свойствами кодирования, который вводит звуковые данные, созданные с помощью кода, реализованного приложением, в звуковой граф.
CreateFrameOutputNode()	Создает новый объект AudioFrameOutputNode , который выводит звуковые данные из звукового графа в код, реализованный приложением.
CreateFrameOutputNode(AudioEncodingProperties)	Создает новый объект AudioFrameOutputNode с указанными свойствами кодирования, который выводит звуковые данные из звукового графа в код, реализованный приложением.
CreateMediaSourceAudioInputNodeAsync(MediaSource)	Создает MediaSourceAudioInputNode , который вводит звуковые данные в звуковой граф из предоставленного объекта MediaSource .
CreateMediaSourceAudioInputNodeAsync(MediaSource, AudioNodeEmitter)	Создает пространственный звуковой объект MediaSourceAudioInputNode , который вводит звуковые данные в звуковой граф из предоставленного объекта MediaSource .
CreateSubmixNode()	Создает audioSubmixNode , который смешивает выходные данные одного или нескольких узлов звукового графа в один выход, который может быть подключен к выходным узлам или другим узлам подмикса.
CreateSubmixNode(AudioEncodingProperties)	Создает audioSubmixNode , который смешивает выходные данные одного или нескольких узлов звукового графа в один выход, который может быть подключен к выходным узлам или другим узлам подмикса.
CreateSubmixNode(AudioEncodingProperties, AudioNodeEmitter)	Создает пространственный звуковой узел AudioSubmixNode , который смешивает выходные данные одного или нескольких узлов аудио графа в один выход, который можно подключить к выходным узлам или другим узлам подмикса.
Dispose()	Выполняет определяемые приложением задачи, связанные с удалением, высвобождением или сбросом неуправляемых ресурсов.
ResetAllNodes()	Сбрасывает все узлы в звуковом графе.
Start()	Запускает звуковой граф.
Stop()	Останавливает звуковой граф.

События

QuantumProcessed	Уведомляет о том, что звуковой граф обработал указанный квант.
QuantumStarted	Уведомляет о том, что звуковой граф начал обработку нового кванта.
UnrecoverableErrorOccurred	Уведомляет о неустранимой звуковой ошибке в операции звукового графа.

См. также раздел

• IClosable
• Звуковые графы
• Пример AudioGraph