次の方法で共有


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

注釈

オーディオ グラフは、入力ノード、出力ノード、サブミックス ノードで構成されます。 入力ノードには、オーディオ ファイル、オーディオ デバイス、オーディオ データを生成するコードが含まれます。 出力ノードには、オーディオ ファイル、オーディオ デバイス、オーディオ データを処理するコードも含まれます。 グラフが開始されると、オーディオ データは、入力ノードからサブミックス ノードを介して出力ノードにグラフを流れます。 各ノードは、次のノードに渡される前にオーディオ データに適用される 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

オーディオ グラフ操作で回復不能なオーディオ エラーを通知します。

適用対象

こちらもご覧ください