Поделиться через


AudioGraph Класс

Определение

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

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
Атрибуты
Реализации

Требования к 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

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

Применяется к

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