![WASAPI WASAPI](/modules/owlapps_apps/img/nopic.jpg)
Windows Audio Session API、通称 WASAPI(ワサピ)はアプリ-オーディオデバイス間のストリームを管理する低レベルWin32 APIである。Core Audio APIsの1つ。
オーディオを扱うアプリケーションはマイク・スピーカー等の"オーディオエンドポイントデバイス"と連携して機能する。デバイスはOSによって管理されており、これらデバイスとアプリケーションを繋ぐオーディオストリームの管理がWASAPIの役割である。
例えばスピーカー出力を行うためにはWASAPIを用いて"エンドポイントバッファ"へ音声データを書きこめばよい。APIコールを受けたOSはAudioEngineによるミキシング、デバイスドライバを介したスピーカー制御をおこない、実際にスピーカーから音声が出力される。
WASAPIは基本的にどのようなサウンドデバイスでも利用することができるが、使用するアプリケーションがWASAPIに対応している必要がある。
OS標準のミキサーや各種エフェクト(APO)処理を一切介さずにエンドポイントバッファ上のオーディオサンプルをアプリケーションが直接読み書きできる構造となっている。
他のアプリケーションの出力と共にOS標準のミキサーや各種エフェクト(APO)を介して再生されるため、複数の音声再生・録音アプリケーションを同時に使用する場合に適している。
WASAPIはWin32 APIすなわちOSに対するシステムコールである。Windows OSはAudioclient.h
とAudiopolicy.h
で定義されるWASAPIインターフェースを介してOSのオーディオストリーム管理を公開することで、アプリケーションによる低レイテンシの音声入出力を可能にしている。アプリケーションはWASAPIを呼び出すことでI/Oストリームを利用できる。
WASAPIの利用ではまずストリームの準備を次のようにおこなう。
IAudioClient::Initialize
IAudioClient::GetService
IAudioClient::Start
オーディオI/Oの場合、開始に引き続いて、必要に応じてパケット単位のread/writeを次のようにおこなう。
IAudioClient::GetCurrentPadding
IAudioCaptureClient::GetBuffer
/IAudioRenderClient::GetBuffer
IAudioCaptureClient::ReleaseBuffer
/IAudioRenderClient::ReleaseBuffer
このように、WASAPIはクライアントとエンドポイントバッファ間のデータ転送を簡潔に記述できる。高レベルAPIと異なりバッファ取得を明示的に都度おこなうため、read/writeされるデータ量や転送頻度の調整を柔軟にプログラムできる。また初期化時の設定により排他モード/共有モード、バッファ全長、デバイス動作周期など、Windows OSが提供するストリーム管理の様々な側面を調整できる。
以下はWASAPI対応ソフトウェアの一例である。
Core Audio APIの一部としてMicrosoft Windows Vistaにて導入された。それ以降も機能が追加されている(例: IAudioClient3)。
Owlapps.net - since 2012 - Les chouettes applications du hibou