AudioGraph クラス

リファレンス

定義

名前空間:: Windows.Media.Audio

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。

編集

オーディオを操作してルーティングする接続された入力、出力、サブミックスノードのオーディオグラフを表します。

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

注釈

オーディオグラフは、入力ノード、出力ノード、サブミックスノードで構成されます。入力ノードには、オーディオファイル、オーディオデバイス、オーディオデータを生成するコードが含まれます。出力ノードには、オーディオファイル、オーディオデバイス、オーディオデータを処理するコードも含まれます。グラフが開始されると、オーディオデータは、入力ノードからサブミックスノードを介して出力ノードにグラフを流れます。各ノードは、次のノードに渡される前にオーディオデータに適用される 0 個以上のオーディオ効果を持つことができます。このクラスおよび関連 API を使用すると、低レベルの COM XAudio2 API よりも迅速かつ簡単にオーディオアプリケーションを開発できます。オーディオグラフの使用に関するハウツーガイダンスについては、「オーディオグラフ」を参照してください。

AudioGraph.CreateAsync を呼び出して、このクラスのインスタンスを取得します。

オーディオグラフ全体が同じサンプルレートで動作する必要があります。ソースは異なるサンプルレートを持つことができますが、すぐにリサンプリングされます。

Note

使用可能なオーディオデバイスがない場合、オーディオグラフをインスタンス化することはできません。

オプションの Media Feature Pack がインストールされていない限り、Windows 8 および Windows 10 の N エディションと KN エディションで AudioGraph をインスタンス化することはできません。詳細については、「 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()	AudioGraph の新しい AudioGraphBatchUpdater を作成します。これにより、オーディオグラフ内のすべてのノードに対する後続のすべての変更が累積され、アプリがバッチアップデーターオブジェクトを閉じるか破棄した後にコミットされます。
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)	指定された MediaSource オブジェクトからオーディオグラフにオーディオデータを入力する MediaSourceAudioInputNode を作成します。
CreateMediaSourceAudioInputNodeAsync(MediaSource, AudioNodeEmitter)	指定された MediaSource オブジェクトからオーディオグラフにオーディオデータを入力する、空間オーディオ対応 MediaSourceAudioInputNode を作成します。
CreateSubmixNode()	1 つ以上のオーディオグラフノードの出力を、出力ノードまたは他のサブミックスノードに接続できる 1 つの出力に混在させる AudioSubmixNode を作成します。
CreateSubmixNode(AudioEncodingProperties)	1 つ以上のオーディオグラフノードの出力を、出力ノードまたは他のサブミックスノードに接続できる 1 つの出力に混在させる AudioSubmixNode を作成します。
CreateSubmixNode(AudioEncodingProperties, AudioNodeEmitter)	1 つ以上のオーディオグラフノードの出力を、出力ノードまたは他のサブミックスノードに接続できる 1 つの出力に混在させる、空間オーディオ対応 AudioSubmixNode を作成します。
Dispose()	アンマネージリソースの解放またはリセットに関連付けられているアプリケーション定義のタスクを実行します。
ResetAllNodes()	オーディオグラフ内のすべてのノードをリセットします。
Start()	オーディオグラフを開始します。
Stop()	オーディオグラフを停止します。

イベント

QuantumProcessed	オーディオグラフが指定した量子を処理したことを通知します。
QuantumStarted	オーディオグラフが新しい量子の処理を開始したことを通知します。
UnrecoverableErrorOccurred	オーディオグラフ操作で回復不能なオーディオエラーを通知します。

適用対象