統合の詳細 - GetSourcePlayPosition

イントロダクション

特定のサウンドの現在の再生位置に関する情報をサウンドエンジンが必要とする場合があります。例えば、同期的にビデオおよびオーディオコンテンツのレンダリングをサポートするゲームでは、適切にゲームのビジュアルをレンダリングするために、サウンドの再生位置クエリが必要とされます。これが（口の動きとダイアログを同期させるためなど）フレームごとに実行されなければならない場合、マーカーより再生位置クエリのほうが有利です。再生位置クエリのもう1つの利点は、ソースファイルの編集が必要ないということです。AKSoundEngine::GetSourcePlayPosition() メソッドは、イベントの最初のサウンド再生時に経過時間を返します。

Note: マーカーは、小刻みのサウンド再生ではなくサウンドファイル内で発生している特定のイベントをシグナリングするのに有用です。

統合

ソースの再生位置をクエリするには、 AK_EnableGetSourcePlayPosition フラグを AK::SoundEngine::PostEvent() メソッドに渡す必要があります。これにより、AKSoundEngine::GetSourcePlayPosition() がこの AkPlayingID のために常時呼び出される可能性があるため、このイベントに関連付けられているソースには特別な配慮が必要であることがサウンドエンジンに通知されます。

続いて、再生されているソースの現在の再生位置を取得するために、AKSoundEngine::PostEvent() への呼び出しにより受け取った AkPlayingID を渡して、AKSoundEngine::GetSourcePlayPosition() メソッドを呼び出すことができます。

例

以下のコードは、AKSoundEngine::GetSourcePlayPosition() メソッドの使用法を示しています：

(...)
static AkPlayingID g_markersPlayingID = 0;
(...)

(...)

g_markersPlayingID = AK::SoundEngine::PostEvent( AK::EVENTS::PLAY_MARKERS_TEST, GAME_OBJECT_ID_MARKERS,
    AK_EnableGetSourcePlayPosition, NULL, NULL );

(...)

AkTimeMs uPosition = 0;
// Somewhere in your game loop (happens periodically):
AK::SoundEngine::GetSourcePlayPosition( g_markersPlayingID, &uPosition );
// Now handle lip synchronization by using uPosition

制限

• イベントに複数の再生アクションが含まれている場合、GetSourcePlayPosition() は、時点0で発生する最初の再生アクションの対象により最初に再生されるソースの位置を返します。 このソースが停止している時は、返される位置のソースは未定義です。

• 連続する（ランダムまたはシーケンス）コンテナは現在再生中のサウンド位置を返します。サウンドが多数ある場合、位置が返されるソースは未定義です。 クロスフェードまたはサンプルアキュレートなトランジションでは、先のソースが再生終了した場合のみ次のソースがその位置を返します。

• 外挿と一緒に使用すると、ループ発生時に、ループするソースがループエンドを短時間オーバーシュートする可能性があります。

• そのプライオリティが特定のしきい値を下回るとバーチャルボイスがキルされる場合があります。これが発生した場合、AKSoundEngine::GetSourcePlayPosition() からエラーコードを受け取る可能性があります。AKSoundEngine::GetSourcePlayPosition() を呼び出す場合は、必ず戻り値をチェックする必要があります。

• ピッチの動的な変化は、トランジション時に若干のオフセット再生位置を短時間生じさせる可能性があります。

参照:

• 統合の詳細 - イベント
• AK::SoundEngine::PostEvent()
• AK::SoundEngine::GetSourcePlayPosition()