シーケンサーソースを使用する

[アーティクル]
12/18/2023

このトピックでは、シーケンサーソースの使用方法について説明します。このチュートリアルは、次のセクションで構成されています。

概要
トポロジを追加する
トポロジを削除する
セグメントにスキップする
関連トピック

シーケンサーソースの一般的な概要については、「シーケンサーソースについて」を参照してください。

概要

シーケンサーソースでは、次のインターフェイスが公開されます。

Interface	説明
IMFMediaSource	汎用メディアソース機能を公開します。
IMFSequencerSource	アプリケーションでトポロジを追加または削除できるようにします。
IMFMediaSourceTopologyProvider	メディアセッションでキューに登録する次のトポロジを取得します。
IMFMediaSourcePresentationProvider	セグメントを終了するためにメディアセッションによって使用されます。このインターフェイスは、アプリケーションでは使用されません。
IMFGetService	サービスインターフェイスのシーケンサーソースに対してクエリを実行します。

メディアソースのシーケンスを再生するには、次の手順を実行します。

シーケンサーソースを作成するには、MFCreateSequencerSource 関数を呼び出します。
「再生トポロジの作成」の説明に従って、セグメントごとに再生トポロジを作成します。プレゼンテーションにトポロジを追加するには、IMFSequencerSource::AppendTopology を呼び出します。
再生を開始する前に、シーケンサーソースで IMFMediaSource::CreatePresentationDescriptor を呼び出します。このメソッドは、最初のセグメントのプレゼンテーション記述子へのポインターを返します。このセグメントに関連付けられているトポロジを取得するには、IMFMediaSourceTopologyProvider インターフェイスのシーケンサーソースで QueryInterface を呼び出します。プレゼンテーション記述子を IMFMediaSourceTopologyProvider::GetMediaSourceTopology メソッドに渡します。このメソッドはトポロジへのポインターを返します。
メディアセッションの IMFMediaSession::SetTopology メソッドを呼び出して、最初のセグメントのトポロジをメディアセッションに渡します。
IMFMediaSession::Start を呼び出して再生を開始します。
シーケンサーソースは、次のセグメントをプリロールする準備ができたら、イベントデータが IMFPresentationDescriptor インターフェイスポインターである MENewPresentation イベントを送信します。ここでも、シーケンサーソースで GetMediaSourceTopology を呼び出してセグメントのトポロジを取得し、SetTopology を呼び出してメディアセッションでトポロジを設定します。メディアソースを再開する必要はありません。次のセグメントまで自動的に再生されます。
アプリケーションが終了する前に、IMFMediaSource::Shutdown を呼び出してシーケンサーソースをシャットダウンします。

次のコードは、トポロジを取得し、メディアセッションで設定する方法を示しています。

// Queues the next topology on the session.

HRESULT CPlaylist::QueueNextSegment(IMFPresentationDescriptor *pPD)
{
    IMFMediaSourceTopologyProvider *pTopoProvider = NULL;
    IMFTopology *pTopology = NULL;

    //Get the topology for the presentation descriptor
    HRESULT hr = m_pSequencerSource->QueryInterface(IID_PPV_ARGS(&pTopoProvider));
    if (FAILED(hr))
    {
        goto done;
    }

    hr = pTopoProvider->GetMediaSourceTopology(pPD, &pTopology);
    if (FAILED(hr))
    {
        goto done;
    }

    //Set the topology on the media session
    m_pSession->SetTopology(NULL, pTopology);

done:
    SafeRelease(&pTopoProvider);
    SafeRelease(&pTopology);
    return hr;
}

完全なコード例については、「シーケンサーソースのサンプルコード」を参照してください。

トポロジを追加する

シーケンサーソースには、2 つのトポロジリスト、"入力リスト" と "プリロールリスト" が含まれています。

入力リストは、再生リストセグメントに対応するトポロジのコレクションであり、IMFSequencerSource::AppendTopology を呼び出してアプリケーションによって追加された順番になっています。このメソッドにより、各トポロジに MFSequencerElementId 型の一意の "セグメント識別子" が割り当てられます。セグメント識別子は、すべてのソーストポロジノードの属性として設定されます。アプリケーションでは、MF_TOPONODE_SEQUENCE_ELEMENTID 属性を使用してソースノードからセグメント識別子を取得できます。同じトポロジに対して AppendTopology が複数回アプリケーションによって呼び出されると、入力リストにトポロジが重複して存在する可能性がありますが、それは一意のセグメント識別子によって識別されます。

プリロールリストは、再生の準備のために初期化された入力リストトポロジのコレクションです。これにより、アクティブなトポロジが終了したときにメディアセッションが次のトポロジにシームレスに移行できます。アプリケーションがトポロジの追加または削除をプリロールリストから直接行うことはできません。これがシーケンサーソースによって生成されるのは、トポロジが再生のために入力リストから選択されたときです。これにより次のトポロジが、シーケンサーソースによって、入力リストからプリロールリストに追加されます。その後、シーケンサーソースにより MENewPresentation イベントが非同期的に発生し、プリロールトポロジのプレゼンテーション記述子がイベントデータとして渡されます。アプリケーションは、メディアセッションの IMFMediaEventGenerator インターフェイスを使用してこのイベントをリッスンし、IMFMediaSession::SetTopology を呼び出して、メディアセッション上のプリロールトポロジをキューに登録する必要があります。これは、メディアセッションがアクティブトポロジの再生を完了する前に行われなければなりません。アクティブなトポロジの再生終了後に再生しなければならない次のトポロジについては、SetTopology によってメディアセッションに通知されます。シームレスな移行を確実に行うには、メディアセッションが前のトポロジの再生を完了する前に、アプリケーションで SetTopology を呼び出す必要があります。それ以外の場合、セグメント間にギャップが生まれます。

MENewPresentation イベントは、アクティブなトポロジの後にトポロジがある場合に発生します。そのため、入力リストに含まれるトポロジが 1 つだけの場合、またはアクティブなトポロジが入力リストの最後のトポロジである場合、このイベントは発生しません。

プリロールリストは入力リストと同期され、トポロジが入力リストに追加または入力リストから削除されるたびに更新されます。

トポロジを削除する

シーケンサーソースからトポロジを削除するには、アプリケーションで IMFSequencerSource::DeleteTopology メソッドを呼び出し、セグメント識別子を指定する必要があります。

DeleteTopology を呼び出す前に、削除するトポロジがメディアセッションで使用されていないことを、アプリケーションで確認する必要があります。これを行うには、DeleteTopology がアプリケーションで呼び出される前に、次の両方が発生しなければなりません。

メディアセッションで再生が確実に完了していることをトポロジが確認できるように、MF_TOPOSTATUS_ENDED を含む MESessionTopologyStatus イベントが受信される。
メディアセッションで次のトポロジの再生が開始したことを次のトポロジが確認できるように、MF_TOPOSTATUS_STARTED_SOURCEを含む MESessionTopologyStatus が受信される。メディアセッションでシーケンサーソースの最後のトポロジが完了したことを確認できるように MESessionEnded イベントが受信される。

削除されるセグメントがアクティブなトポロジの場合は、再生が停止され、シーケンサーソースによって MEEndOfPresentationSegment イベントが発生します。アクティブなトポロジも最後のトポロジである場合は、MEEndOfPresentation イベントが発生します。

セグメントにスキップする

アプリケーションでシーケンス内の特定のセグメントにスキップするには、次のようにセグメントオフセットを使用してメディアセッションを開始します。

MFCreateSequencerSegmentOffset 関数を呼び出して、セグメントオフセットを作成します。 dwId パラメーターでセグメントの識別子を指定します (識別子は、最初にトポロジをシーケンサーソースに追加したときに、IMFSequencerSource::AppendTopology メソッドによって返されました)。hnsOffset パラメーターでは、セグメントの開始位置を基準とした時間オフセットが指定されます。この時点で再生が開始します。 pvarSegmentOffset パラメーターについては、空の PROPVARIANT のアドレスを渡します。関数から制御が戻ったとき、この PROPVARIANT にはセグメントオフセットが含まれています。
メディアセッションで IMFMediaSession::Start メソッドを呼び出します。 pguidTimeFormat パラメーターについては、GUID 値 MF_TIME_FORMAT_SEGMENT_OFFSET を使用します。この値は、セグメントオフセットによってシークを示します。 pvarStartPosition パラメーターについては、前の手順で作成した PROPVARIANT のアドレスを渡します。

次のコード例は、シーケンス内の指定したセグメントの先頭にスキップする方法を示しています。

// Skips to the specified segment in the sequencer source

HRESULT CPlaylist::SkipTo(DWORD index)
{
    if (index >= m_count)
    {
        return E_INVALIDARG;
    }

    MFSequencerElementId ID = m_segments[index].SegmentID;

    PROPVARIANT var;

    HRESULT hr = MFCreateSequencerSegmentOffset(ID, NULL, &var);
    
    if (SUCCEEDED(hr))
    {
        hr = m_pSession->Start(&MF_TIME_FORMAT_SEGMENT_OFFSET, &var);
        PropVariantClear(&var);
    }
    return hr;
}

アプリケーションによるシークが複数のセグメントにわたる場合、シーケンサーソースによって現在のセグメントが終了し、新しいセグメントの再生準備が行われ、そのアプリケーションは複数のイベントを受け取ります。これらのイベントは非同期的に受信されるため、イベントの正確なシーケンスを予測することは困難です。これらのイベントは次のとおりです。

メディアセッションの新しいスキップ先セグメントに対する MENewPresentation イベントが、シーケンサーソースによって送信されます。
アクティブなセグメントを終了したシーケンサーソースにより、MEEndOfPresentationSegment イベントが送信されます。
その後、プリロールトポロジがシーケンサーソースによって取り消されます。これにより、取り消されたトポロジに対して次のイベントが発生します。
- MF_TOPOSTATUS_READY フラグを持つ MESessionTopologyStatus イベント。
- MF_TOPOSTATUS_STARTED_SOURCE フラグを持つ MESessionTopologyStatus イベント。
- MF_EVENT_SOURCE_TOPOLOGY_CANCELED 属性を持つ MEEndOfPresentationSegment イベント。これはトポロジがシーケンサーソースによって取り消されたことを示します。
次に、シーケンサーソースは新しいセグメントのイベントを送信します。これには、さまざまな MESessionTopologyStatus イベントが含まれます。
新しいセグメントがリストの最後でない場合、プリロールリストがシーケンサーソースによって更新され、新しいプリロールトポロジに対して別の MENewPresentation が生成されます。プリロールリストのトポロジの詳細については、「シーケンサーソースについて」を参照してください。

シーケンサーソースによって送信されるイベントの詳細については、シーケンサーソースイベントに関するトピックを参照してください。

再生リストを作成する方法
シーケンサーソース

次の方法で共有

シーケンサーソースを使用する

概要

トポロジを追加する

トポロジを削除する

セグメントにスキップする

フィードバック

その他のリソース

次の方法で共有

シーケンサー ソースを使用する

概要

トポロジを追加する

トポロジを削除する

セグメントにスキップする

関連トピック

フィードバック

その他のリソース

シーケンサーソースを使用する