再生リストを作成する方法

2023-06-13

このトピックでは、シーケンスソースを使用して一連のファイルを再生する方法について説明します。

概要

メディアファイルをシーケンスで再生するには、再生リストを作成するトポロジをシーケンスに追加し、再生のためにメディアセッションでこれらのトポロジをキューに入れなければなりません。

シーケンサーソースは、メディアセッションが現在のトポロジの再生を開始する前に、次のトポロジを初期化して読み込むことで、シームレスな再生を保証します。これにより、アプリケーションは必要なときにいつでも次のトポロジをすばやく開始できます。

メディアセッションは、シンクにデータを供給し、シーケンスソースでトポロジを再生する役割を担います。さらに、メディアセッションはセグメントのプレゼンテーション時間を管理します。

シーケンサーソースがトポロジを管理する方法の詳細については、「 Sequencer ソースについて」を参照してください。

このチュートリアルには、次の手順が含まれています。

前提条件
Media Foundation の初期化
Media Foundation オブジェクトの作成
メディアソースの作成
部分トポロジの作成
Sequencer ソースへのトポロジの追加
メディアセッションでの最初のトポロジの設定
メディアセッションで次のトポロジをキューに入れる
Sequencer ソースの解放

このトピックに示すコード例は、完全なサンプルコードを含む Sequencer Source Example Code というトピックからの抜粋です。

[前提条件]

このチュートリアルを開始する前に、次の Media Foundation の概念を理解しておいてください。

また、Media Foundation を使用してメディアファイルを再生する方法についても説明します。ここで示すコード例は、そのトピックのコードを展開しているためです。

メディアファンデーションの初期化

Media Foundation のインターフェイスまたはメソッドを使用する前に、 MFStartup 関数を呼び出して Media Foundation を初期化します。詳細については、「 Media Foundation の初期化」を参照してください。

    hr = MFStartup(MF_VERSION);

Media Foundation オブジェクトの作成

次に、次の Media Foundation オブジェクトを作成します。

メディアセッション。このオブジェクトは、現在のトポロジを再生、一時停止、および停止するメソッドを提供する IMFMediaSession インターフェイスを公開します。
シーケンサーのソース。このオブジェクトは、シーケンス内のトポロジを追加、更新、および削除するメソッドを提供する IMFSequencerSource インターフェイスを公開します。

MFCreateMediaSession 関数を呼び出して、メディアセッションを作成します。
IMFMediaEventQueue::BeginGetEvent を呼び出して、メディアセッションから最初のイベントを要求します。
MFCreateSequencerSource 関数を呼び出して、シーケンサーソースを作成します。

次のコードは、メディアセッションを作成し、最初のイベントを要求します。

//  Create a new instance of the media session.
HRESULT CPlayer::CreateSession()
{
    // Close the old session, if any.
    HRESULT hr = CloseSession();
    if (FAILED(hr))
    {
        goto done;
    }

    assert(m_state == Closed);

    // Create the media session.
    hr = MFCreateMediaSession(NULL, &m_pSession);
    if (FAILED(hr))
    {
        goto done;
    }

    // Start pulling events from the media session
    hr = m_pSession->BeginGetEvent((IMFAsyncCallback*)this, NULL);
    if (FAILED(hr))
    {
        goto done;
    }

    m_state = Ready;

done:
    return hr;
}

メディアソースの作成

次に、最初のプレイリストセグメントのメディアソースを作成します。ソースリゾルバーを使用して、URL からメディアソースを作成します。そのためには、 MFCreateSourceResolver 関数を呼び出してソースリゾルバーを作成し 、IMFSourceResolver::CreateObjectFromURL メソッドを呼び出してメディアソースを作成します。

メディアソースの詳細については、「メディアソース」を参照してください。

部分トポロジの作成

シーケンサーソース内の各セグメントには、独自の部分トポロジがあります。次に、メディアソースの部分トポロジを作成します。部分トポロジの場合、トポロジソースノードは、中間変換を指定せずに出力ノードに直接接続されます。メディアセッションでは、トポロジローダーオブジェクトを使用してトポロジを解決します。トポロジが解決されると、必要なデコーダーとその他の変換ノードが追加されます。シーケンサーソースには、完全なトポロジを含めることもできます。

トポロジオブジェクトを作成するには、 MFCreateTopology 関数を使用し、 IMFTopologyNode インターフェイスを使用してストリームノードを作成します。

これらのプログラミング要素を使用してトポロジを作成する方法の詳細については、「再生トポロジの作成」を参照してください。

アプリケーションは、ソースノードを構成することで、ネイティブソースの選択された部分を再生できます。これを行うには、トポロジノードで MF_TOPONODE_MEDIASTART 属性と MF_TOPONODE_MEDIASTOP 属性 MF_TOPOLOGY_SOURCESTREAM_NODE 設定します。 UINT64 の種類として、ネイティブソースの開始を基準としたメディアの開始時刻とメディアの停止時間を指定します。

Sequencer ソースへのトポロジの追加

次に、作成した部分トポロジをシーケンサーソースに追加します。 セグメントと呼ばれる各シーケンス要素には、MFSequencerElementId 識別子が割り当てられます。シーケンサーソースがトポロジを管理する方法の詳細については、「 Sequencer ソースについて」を参照してください。

すべてのトポロジがシーケンサーソースに追加された後、アプリケーションは、パイプラインでの再生を終了するために、シーケンス内の最後のセグメントにフラグを設定する必要があります。このフラグがない場合、シーケンサーソースはさらに多くのトポロジが追加されることを期待します。

IMFSequencerSource::AppendTopology メソッドを呼び出して、特定のトポロジをシーケンサーソースに追加します。
```
    hr = m_pSequencerSource->AppendTopology(
        pTopology, 
        SequencerTopologyFlags_Last, 
        &SegmentId
        );
```
AppendTopology は、指定されたトポロジをシーケンスに追加します。このメソッドは 、pdwId パラメーターのセグメント識別子を返します。

トポロジがシーケンサーソースの最後のトポロジである場合は、 dwFlags パラメーターにSequencerTopologyFlags_Lastを渡します。この値は 、MFSequencerTopologyFlags 列挙型で定義されます。
IMFSequencerSource::UpdateTopologyFlags を呼び出して、入力リストのセグメント識別子に関連付けられているトポロジのフラグを更新します。この場合、呼び出しは、指定されたセグメントがシーケンサーの最後のセグメントであることを示します。 (この呼び出しは、 AppendTopology 呼び出しで最後のトポロジが指定されている場合は省略可能です)。
```
    BOOL bFirstSegment = (NumSegments() == 0);

    if (!bFirstSegment)
    {
        // Remove the "last segment" flag from the last segment.
        hr = m_pSequencerSource->UpdateTopologyFlags(LastSegment(), 0);
        if (FAILED(hr))
        {
            goto done;
        }
    }
```

アプリケーションは、 IMFSequencerSource::UpdateTopology を呼び出し、 pTopology で新しいトポロジを渡すことで、セグメントのトポロジを別のトポロジに置き換えることができます。新しいトポロジに新しいネイティブソースがある場合、ソースはソースキャッシュに追加されます。プリロールリストも更新されます。

メディアセッションでの最初のトポロジの設定

次に、メディアセッションのシーケンスソースの最初のトポロジをキューに入れます。シーケンサーソースから最初のトポロジを取得するには、アプリケーションで IMFMediaSourceTopologyProvider::GetMediaSourceTopology メソッドを呼び出す必要があります。このメソッドは、メディアセッションによって解決される部分トポロジを返します。

部分トポロジの詳細については、「トポロジについて」を参照してください。

シーケンスソースの最初のトポロジのネイティブメディアソースを取得します。
IMFMediaSource::CreatePresentationDescriptor メソッドを呼び出して、メディアソースのプレゼンテーション記述子を作成します。
IMFMediaSourceTopologyProvider::GetMediaSourceTopology メソッドを呼び出して、プレゼンテーションに関連付けられているトポロジを取得します。
IMFMediaSession::SetTopology を呼び出して、メディアセッションの最初のトポロジを設定します。

dwSetTopologyFlags パラメーターを NULL に設定して SetTopology を呼び出します。これにより、現在のトポロジが完了したときに、指定したトポロジを開始するようにメディアセッションに指示します。この場合、指定したトポロジが最初のトポロジであり、現在のプレゼンテーションがないため、メディアセッションは新しいプレゼンテーションをすぐに開始します。

NULL 値は、トポロジプロバイダーによって返されるトポロジは常に部分トポロジであるため、メディアセッションがトポロジを解決する必要があることを示します。

// 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;
}

メディアセッションで次のトポロジをキューに入れる

次に、アプリケーションで MENewPresentation イベントを処理する必要があります。

Sequencer ソースは、メディアセッションがその後に別のセグメントを持つセグメントの再生を開始すると、MENewPresentation を発生させます。このイベントは、プリロールリスト内の次のセグメントのプレゼンテーション記述子を指定することによって、シーケンスソース内の次のトポロジについてアプリケーションに通知します。アプリケーションは、関連付けられているトポロジをトポロジプロバイダーを使用して取得し、メディアセッションでキューに登録する必要があります。その後、シーケンサーソースによってこのトポロジが事前登録され、プレゼンテーション間のシームレスな切り替えが保証されます。

アプリケーションが複数のセグメントをシークすると、シーケンサーソースがプリロールリストを更新し、正しいトポロジを設定するときに、アプリケーションはいくつかの MENewPresentation イベントを受け取ります。アプリケーションは、各イベントを処理し、メディアセッションのイベントデータで返されたトポロジをキューに入れなければなりません。セグメントのスキップの詳細については、「 Sequencer ソースの使用」を参照してください。

シーケンサーソース通知の取得については、「 Sequencer ソースイベント」を参照してください。

MENewPresentation イベントハンドラーで、イベントデータから次のセグメントのプレゼンテーション記述子を取得します。
IMFMediaSourceTopologyProvider::GetMediaSourceTopology メソッドを呼び出して、プレゼンテーションに関連付けられているトポロジを取得します。
IMFMediaSession::SetTopology メソッドを呼び出して、メディアセッションでトポロジを設定します。

メディアセッションは、現在のプレゼンテーションが完了すると、新しいプレゼンテーションを開始します。

HRESULT CPlaylist::OnNewPresentation(IMFMediaEvent *pEvent)
{
    IMFPresentationDescriptor *pPD = NULL;

    HRESULT hr = GetEventObject(pEvent, &pPD);

    if (SUCCEEDED(hr))
    {
        // Queue the next segment on the media session
        hr = QueueNextSegment(pPD);
    }

    SafeRelease(&pPD);
    return hr;
}

Sequencer ソースの解放

最後に、シーケンサーソースをシャットダウンします。これを行うには、シーケンサーソースで IMFMediaSource::Shutdown メソッドを呼び出します。この呼び出しにより、シーケンサーソース内のすべての基になるネイティブメディアソースがシャットダウンされます。

シーケンサーソースを解放した後、アプリケーションは、IMFMediaSession::Close と IMFMediaSession::Shutdown を呼び出して、メディアセッションを閉じてシャットダウンする必要があります。

メモリリークを回避するには、不要になったら、アプリケーションで Media Foundation インターフェイスへのポインターを解放する必要があります。

次のステップ

このチュートリアルでは、シーケンサーソースを使用して基本的なプレイリストを作成する方法を示しました。プレイリストを作成したら、セグメントのスキップ、再生状態の変更、セグメント内のシークなどの高度な機能を追加できます。次の一覧に、関連トピックへのリンクを示します。

表示状態を制御する方法: シーケンサーソースは、メディアセッションに依存して、再生、一時停止、停止などのトランスポート制御を提供します。
スクラブ（シーク）の方法では、ストリーム内の特定の位置に移動するための手順を説明します。

sequencer ソースの

フィードバック

このページはお役に立ちましたか?

次の方法で共有