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.IDisposablePublic NotInheritable Class AudioGraph
Implements 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 |
Уведомляет о неустранимой звуковой ошибке в операции звукового графа. |