Top / ＯＳ関係 / Android / OpenSLES

/OpenSLES

OpenSLESについて †

SLAudioIODeviceCapabilitiesItfインターフェイスについて †

このインターフェイスは、実際のハードウェアにおけるI/Oデバイスについての情報を取得するためのインターフェイスである。

コールバック †

インターフェイス関数の一覧 †

エンジンオブジェクトについて †

OpenSLESでは、まずは最初にエンジン（engineObject）を作成するところから始めるが、それにはまず、slCreateEngine関数を利用する。この関数ではengineObjectを生成するために、２つの設定できる項目がある。１つはEngineOptionで主に、スレッドセーフのオプションを指定し、もうひとつは利用するインターフェイスを設定する。といっても、OpenSLESの実装やハードウェアスペックなどによって、インターフェイス（各OpenSLの個別機能）は違っているため、通常はslQueryNumSupportedEngineInterfaces関数を利用して、対応しているインターフェイスを確認した上で設定を行う。ただし実際この engineObjectで利用できるインターフェイスは下記の実質４つ。よって設定では設定なし（null）でも大抵機能する。

EngineOption †

オプション設定の例

SLEngineOption EngineOption[] = {
     SL_ENGINEOPTION_THREADSAFE, SL_BOOLEAN_TRUE,
     SL_ENGINEOPTION_LOSSOFCONTROL, SL_BOOLEAN_TRUE
};
SLObjectItf engineObject;
slCreateEngine(
     &engineObject,			// エンジンオブジェクトを作成する場所
     2,					// 下のEngineOptionで指定したオプションの数
     EngineOption,			// 定義されたエンジンオプションの構造体
     0,					// 設定するインターフェイスの数
     NULL,					// 設定するインターフェイスIDの配列
     NULL					// 設定するインターフェイスIDに設定する値の配列
);

engineObjectの利用インターフェイス設定 †

上記で説明のあった engineObject作成時のインターフェイスの取得例

SLuint32 num = 0;
slQueryNumSupportedEngineInterfaces(&num);     // サポートされているインターフェイスの数を取得
for (i=0 ; i<num ; ++i){
    SLInterfaceID  id;
    slQuerySupportedEngineInterfaces( i, &interface_id );     // サポートしているインターフェイス情報を取得
    if ( id == SL_IID_OBJECT ) LOGD ("supported SL_IID_OBJECT");  // 表示
}

engineObjectに指定する場合は、上記の方法でインターフェイスＩＤを取得し、必要分配列を作ってslCreateEngineに渡す。

SLInterfaceID *engine_ids = calloc(num+1, sizeof(SLInterfaceID));
SLboolean *engine_req = calloc(num+1, sizeof(SLboolean));
for (i=0 ; i<num ; ++i){
    slQuerySupportedEngineInterfaces(i, &interfaceID);
    engine_ids[i] = interfaceID;
    engine_req[i] = SL_BOOLEAN_TRUE;
}
SLObjectItf engineObject;
slCreateEngine(
     &engineObject,			// エンジンオブジェクトを作成する場所
     2,						// 下のEngineOptionで指定したオプションの数
     EngineOption,			// 定義されたエンジンオプションの構造体
     num,					// 設定するインターフェイスの数
     engine_ids,				// 設定するインターフェイスIDの配列
     engine_req				// 設定するインターフェイスIDに設定する値の配列
);

＜engineObjectで作成できるインターフェイス＞

realizeについて †

realizeコマンドはすべてのオブジェクトを起動させるのに必要な関数でengineObjectでは以下のように利用する。

(*engineObject)->Realize(engineObject, SL_BOOLEAN_FALSE);

第二引数の booleanは、非同期で動作させる場合にSL_BOOLEAN_TRUEを利用する。通常はSL_BOOLEAN_FALSEで利用するほうが安全。

engineインターフェイスの作成 †

上記のengineObjectを作成し起動させると、engineインターフェイスを取得できるようになる。

engineインターフェイスの取得 †

(*engineObject)->GetInterface(engineObject, SL_IID_ENGINE, &engineItf);

engineインターフェイスでサポートしている機能の確認。 †

SLEngineCapabilitiesItf engineCapItf;
SLuint16 profilesSupported;
(*engineObject)->GetInterface( engineObject, SL_IID_ENGINECAPABILITIES, &engineCapItf );
(*engineCapItf)->QuerySupportedProfiles( engineCapItf, &profilesSupported );
if ( profilesSupported & SL_PROFILES_PHONE ) LOGD ("SL_PROFILES_PHONE");
if ( profilesSupported & SL_PROFILES_MUSIC ) LOGD ("SL_PROFILES_MUSIC");
if ( profilesSupported & SL_PROFILES_GAME ) LOGD ("SL_PROFILES_GAME");

上記方法でエンジンが対応しているプロファイルを確認できるが、そもそもこのSL_IID_ENGINECAPABILITIESインターフェイスに対応していない実装が多いので本当に役に立たない。ちなみに、このSL_IID_ENGINECAPABILITIESで取得できる情報は次の通り。

engine objectで対応しているインターフェイス一覧 †

※3Dサウンドや3D-MIDIは、game profile専用の機能

engineインターフェイスで提供される機能 †

機能の一覧 †

OutputMixオブジェクトについて †

OutputMixオブジェクトは、最後の発音の段階でのミキシングを行う、いわゆるミキサー（スピーカー手前の装置）のような機能を行うが、このオブジェクトでは以下のようなインターフェイスが提供されている。

OutputMixオブジェクトで対応しているインターフェイス一覧 †

AudioPlayerオブジェクトについて（以後playerオブジェクト） †

engineインターフェイスから、CreateAudioPlayer関数を通じて作成されるAudioPlayerオブジェクトは、音源を再生するための各種インファーフェイスを提供する。

AudioPlayerオブジェクトに対応しているインターフェイス一覧 †

AudioObjectで利用できる関数 †

ListenerObjectについて †

リスナーオブジェクトは、３Ｄサウンドを実現する上で、聞き手の位置を管理するオブジェクトとなる。

ListenerObjectのインターフェイス †

SLVolumeItf（SL_IID_VOLUME）について †

ボリュームインターフェイスは、AudioPlayerオブジェクト（SL_OBJECTID_AUDIOPLAYER）、MIDIPlayerオブジェクト（SL_OBJECTID_MIDIPLAYER）、OutputMixオブジェクト（SL_OBJECTID_OUTPUTMIX）の３つのオブジェクトに提供されているインターフェイスであり、モノラルサウンドには、パン・エフェクトで、ステレオサウンドには、ポジション・エフェクトの形で提供します。（利用関数はモノもステレオも同じ）

SLVolumeItf（SL_IID_VOLUME）で提供される関数について †

全部で９個の関数が提供されている。

SLPlayItf（SL_IID_PLAY）インターフェイスについて †

SLPlayItfインターフェイスは、AudioPlayerオブジェクト（SL_OBJECTID_AUDIOPLAYER）と、MIDIPlayerオブジェクト（SL_OBJECTID_MIDIPLAYER）に提供されているインターフェイスで、主に再生状況（status）の変更や取得に用いられる。

SLPlayItf（SL_IID_PLAY）インターフェイスで提供されている関数 †

SLOutputMixItf（SL_IID_OUTPUTMIX）インターフェイスについて †

SLOutputMixItfインターフェイスは、OutputMixオブジェクトにのみ実装されるインターフェイスであり、OutputMixオブジェクトと、出力デバイスとの接続の指定を行う関数を持つ。

SLOutputMixItf（SL_IID_OUTPUTMIX）インターフェイスが提供する関数 †

全部で３つの関数とコールバック構造体がある。

|slMixDeviceChangeCallback

TIPS †

AndroidManufest.xmlに許可の追加 †

<manifest xmlns:android="http://schemas.android.com/apk/res/android"
                          package="com.collavier.android.libtremor.nativeoggplayer" >
   <uses-permission android:name="android.permission.MODIFY_AUDIO_SETTINGS" />
</manifest>

実装されているＡＰＩのチェック方法 †

MIDI利用での注意 †

• CreateMidiPlayerをDestroyする場合は、SLPlayItfのステータスをSL_PLAYSTATE_STOPPEDしなければゴミが残る。（実装による）
• SLDataFormatの値で、mimeTypeに「audio/x-midi」を、containerTypeに「SL_CONTAINERTYPE_SMF」を設定。