共用方式為

如何建立播放清單

  • 發行項

本主題描述如何使用時序來源來播放一連串的檔案。

概觀

若要在序列中播放媒體檔案，應用程式必須在序列中新增拓撲，以建立播放清單，並將這些拓撲排入媒體會話以播放。

排序器來源可確保在媒體會話開始播放目前拓撲之前，初始化和載入下一個拓撲，以確保順暢播放。 這可讓應用程式在需要時快速啟動下一個拓撲。

媒體會話負責將資料摘要至接收，並在序列來源中播放拓撲。 此外，媒體會話會管理區段的簡報時間。

如需排序器來源如何管理拓撲的詳細資訊，請參閱 關於 Sequencer 來源。

此逐步解說包含下列步驟：

  1. 先決條件
  2. 初始化媒體基礎
  3. 建立媒體基礎物件
  4. 建立媒體來源
  5. 建立部分拓撲
  6. 將拓撲新增至 Sequencer 來源
  7. 在媒體會話上設定第一個拓撲
  8. 佇列媒體會話上的下一個拓撲
  9. 釋放 Sequencer 來源

本主題所示的程式碼範例是 Sequencer 來源範例程式碼主題的摘錄，其中包含完整的範例程式碼。

必要條件

開始進行此逐步解說之前，請先熟悉下列媒體基礎概念：

另請參閱 如何使用 Media Foundation 播放媒體檔案，因為此處的範例程式碼 shwon 會展開該主題中的程式碼。

初始化媒體基礎

在您可以使用任何 Media Foundation 介面或方法之前，請先呼叫 MFStartup 函式來初始化 Media Foundation。 如需詳細資訊，請參閱 初始化媒體基礎。

    hr = MFStartup(MF_VERSION);

建立媒體基礎物件

接下來，建立下列 Media Foundation 物件：

  • 媒體會話。 此物件會公開 IMFMediaSession 介面，其提供播放、暫停和停止目前拓撲的方法。
  • Sequencer 來源。 這個物件會公開 IMFSequencerSource 介面，這個介面提供在序列中新增、更新和刪除拓撲的方法。
  1. 呼叫 MFCreateMediaSession 函式 以建立媒體會話。
  2. 呼叫 IMFMediaEventQueue：：BeginGetEvent 以向媒體會話要求第一個事件。
  3. 呼叫 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_TOPOLOGY_SOURCESTREAM_NODE拓撲節點上設定MF_TOPONODE_MEDIASTART屬性和MF_TOPONODE_MEDIASTOP屬性。 將媒體開始時間和媒體停止時間指定為 UINT64 類型，相對於原生來源的開始時間。

將拓撲新增至 Sequencer 來源

接下來，將 新增至排序器來源您所建立的部分拓撲。 每個稱為 區段的序列元素都會指派 MFSequencerElementId 識別碼。 如需排序器來源如何管理拓撲的詳細資訊，請參閱 關於 Sequencer 來源。

將所有拓撲新增至排序器來源之後，應用程式必須標幟序列中的最後一個區段，才能結束管線中的播放。 如果沒有此旗標，排序器來源預期會新增更多拓撲。

  1. 呼叫 IMFSequencerSource：：AppendTopology 方法，將特定拓撲新增至排序器來源。

        hr = m_pSequencerSource->AppendTopology(
        pTopology, 
        SequencerTopologyFlags_Last, 
        &SegmentId
        );

    AppendTopology 會將指定的拓撲新增至序列。 這個方法會傳回 pdwId 參數中的區段識別碼。

    如果拓撲是排序器來源的最後一個拓撲，請在 dwFlags 參數中傳遞SequencerTopologyFlags_Last。 此值定義于 MFSequencerTopologyFlags 列舉中。

  2. 呼叫 IMFSequencerSource：：UpdateTopologyFlags 來更新與輸入清單中區段識別碼相關聯的拓撲旗標。 在此情況下，呼叫會指出指定的區段是排序器中的最後一個區段。 (如果 AppendTopology call.) 中指定最後一個拓撲，則此呼叫是選擇性的。

        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 方法。 這個方法會傳回媒體會話所解析的部分拓撲。

如需部分拓撲的相關資訊，請參閱 關於拓撲。

  1. 擷取序列來源第一個拓撲的原生媒體來源。

  2. 呼叫 IMFMediaSource：：CreatePresentationDescriptor 方法，為媒體來源建立簡報描述元。

  3. 呼叫 IMFMediaSourceTopologyProvider：：GetMediaSourceTopology 方法來擷取簡報的相關拓撲。

  4. 呼叫 IMFMediaSession：：SetTopology，在媒體會話上設定第一個拓撲。

    呼叫 SetTopology，並將dwSetTopologyFlags 參數設定為 Null。 這會指示媒體會話在目前拓撲完成時啟動指定的拓撲。 在此情況下，指定的拓撲是第一個拓撲，而且沒有目前的簡報，媒體會話會立即啟動新的簡報。

    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 來源事件。

  1. 在 MENewPresentation 事件處理常式中，從事件資料擷取下一個區段的簡報描述元。

  2. 呼叫 IMFMediaSourceTopologyProvider：：GetMediaSourceTopology 方法，以取得簡報的相關拓撲。

  3. 藉由呼叫 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來關閉和關閉媒體會話。

若要避免記憶體流失，應用程式必須在不再需要時釋出媒體基礎介面的指標。

後續步驟

本逐步解說說明如何使用排序器來源建立基本播放清單。 建立播放清單之後，您可能會想要新增進階功能，例如區段略過、變更播放狀態，以及在區段內搜尋。 下列清單提供相關主題的連結：

Sequencer 來源