プレイリストを作成する方法

[アーティクル]
06/13/2023

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

概要

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

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

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

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

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

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

このトピックに示すコード例は、完全なサンプルコードを含む Sequencer ソースサンプルコードに関するトピックからの抜粋です。

前提条件

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

また、「 Media Foundation を使用してメディアファイルを再生する方法」も参照してください。この例のコード shwon は、そのトピックのコードを展開しているためです。

Media Foundation の初期化

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

    hr = MFStartup(MF_VERSION);

Media Foundation オブジェクトの作成

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

メディアセッション。このオブジェクトは、現在のトポロジを再生、一時停止、停止するメソッドを提供する IMFMediaSession インターフェイスを公開します。
Sequencer ソース。このオブジェクトは 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 ソース通知を取得する方法については、「 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 ソース

次の方法で共有

プレイリストを作成する方法

概要

前提条件

Media Foundation の初期化

Media Foundation オブジェクトの作成

メディアソースの作成

部分トポロジの作成

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

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

メディアセッションでの次のトポロジのキュー

Sequencer ソースの解放

次の手順

フィードバック

その他のリソース

次の方法で共有

プレイリストを作成する方法

概要

前提条件

Media Foundation の初期化

Media Foundation オブジェクトの作成

メディア ソースの作成

部分トポロジの作成

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

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

メディア セッションでの次のトポロジのキュー

Sequencer ソースの解放

次の手順

関連トピック

フィードバック

その他のリソース

メディアソースの作成

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

メディアセッションでの次のトポロジのキュー