Guide pratique pour créer une playlist

2025-06-14

Cette rubrique explique comment utiliser la source de séquence pour lire une séquence de fichiers.

Aperçu

Pour lire des fichiers multimédias dans une séquence, l’application doit ajouter des topologies dans une séquence pour créer une playlist et mettre en file d’attente ces topologies sur la session multimédia pour la lecture.

La source sequencer garantit une lecture transparente en initialisant et en chargeant la topologie suivante avant que la session multimédia commence à lire la topologie actuelle. Cela permet à l’application de démarrer rapidement la topologie suivante chaque fois qu’elle est requise.

La session multimédia est chargée d'acheminer les données aux récepteurs et d'exécuter les topologies dans la source de séquence. En outre, la session multimédia gère l’heure de présentation des segments.

Pour plus d’informations sur la façon dont la source sequencer gère les topologies, consultez À propos de la source Sequencer.

Cette procédure pas à pas contient les étapes suivantes :

Conditions préalables
Initialisation de Media Foundation
Création d’objets Media Foundation
Création de la source multimédia
Création de topologies partielles
Ajout de topologies à la source Sequencer
Définition de la première topologie sur la session multimédia
Mise en file d’attente de la topologie suivante sur la session multimédia
Publication de la source du séquenceur

Les exemples de code présentés dans cette rubrique sont des extraits du sujet Sequencer Source Example Code, qui contient l’exemple de code complet.

Conditions préalables

Avant de commencer cette procédure pas à pas, familiarisez-vous avec les concepts Media Foundation suivants :

de session multimédia
Topologies
générateurs d’événements multimédias
descripteurs de présentation

Lisez également Comment lire des fichiers multimédias avec Media Foundation, car l’exemple de code présenté ici s’étend sur le code de cette rubrique.

Initialiser Media Foundation

Avant de pouvoir utiliser n’importe quelle interface ou méthode Media Foundation, initialisez Media Foundation en appelant la fonction MFStartup . Pour plus d’informations, voir Initialisation de Media Foundation.

    hr = MFStartup(MF_VERSION);

Création d’objets Media Foundation

Ensuite, créez les objets Media Foundation suivants :

Session multimédia. Cet objet expose l’interface IMFMediaSession , qui fournit des méthodes pour lire, suspendre et arrêter la topologie actuelle.
Source du séquenceur. Cet objet expose l’interface IMFSequencerSource , qui fournit des méthodes pour ajouter, mettre à jour et supprimer des topologies dans une séquence.

Appelez la fonction MFCreateMediaSession pour créer la session multimédia.
Appelez IMFMediaEventQueue ::BeginGetEvent pour demander le premier événement à partir de la session multimédia.
Appelez la fonction MFCreateSequencerSource pour créer la source séquenceur.

Le code suivant crée la session multimédia et demande le premier événement :

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

Création de la source multimédia

Ensuite, créez une source multimédia pour le premier segment de playlist. Utilisez le programme de résolution de source pour créer une source multimédia à partir d’une URL. Pour ce faire, appelez la fonction MFCreateSourceResolver pour créer un programme de résolution source, puis appelez la méthode IMFSourceResolver ::CreateObjectFromURL pour créer la source multimédia.

Pour plus d’informations sur les sources multimédias, consultez Sources multimédias.

Création de topologies partielles

Chaque segment de la source sequencer a sa propre topologie partielle. Ensuite, créez des topologies partielles pour les sources multimédias. Pour une topologie partielle, les nœuds sources de topologie sont connectés directement aux nœuds de sortie, sans spécifier de transformations intermédiaires. Media Session utilise l’objet chargeur de topologie pour résoudre la topologie. Une fois qu’une topologie est résolue, les décodeurs requis et d’autres nœuds de transformation sont ajoutés. La source sequencer peut également contenir des topologies complètes.

Pour créer l’objet de topologie, utilisez la fonction MFCreateTopology , puis utilisez l’interface IMFTopologyNode pour créer des nœuds de flux.

Pour obtenir des instructions complètes sur l’utilisation de ces éléments de programmation pour créer des topologies, consultez Création de topologies de lecture.

Une application peut lire une partie sélectionnée de la source native en configurant le nœud source. Pour ce faire, définissez l’attribut MF_TOPONODE_MEDIASTART et l’attribut MF_TOPONODE_MEDIASTOP sur MF_TOPOLOGY_SOURCESTREAM_NODE nœuds de topologie. Spécifiez l’heure de début du média et l’heure d’arrêt du média par rapport au début de la source native en tant que types UINT64 .

Ajout de topologies à la source Sequencer

Ensuite, ajoutez à la source du séquenceur les topologies partielles que vous avez créées. Chaque élément de séquence, appelé segment, reçoit un identificateur MFSequencerElementId . Pour plus d’informations sur la façon dont la source sequencer gère les topologies, consultez À propos de la source Sequencer.

Une fois que toutes les topologies sont ajoutées à la source du séquenceur, l’application doit marquer le dernier segment de la séquence pour terminer la lecture dans le pipeline. Sans cet indicateur, la source sequencer s’attend à ce que d’autres topologies soient ajoutées.

Appelez la méthode IMFSequencerSource ::AppendTopology pour ajouter une topologie spécifique à la source sequencer.
```
    hr = m_pSequencerSource->AppendTopology(
        pTopology, 
        SequencerTopologyFlags_Last, 
        &SegmentId
        );
```
AppendTopology ajoute la topologie spécifiée à la séquence. Cette méthode retourne l’identificateur de segment dans le paramètre pdwId .

Si la topologie est la dernière dans la source du séquenceur, passez SequencerTopologyFlags_Last dans le paramètre dwFlags . Cette valeur est définie dans l’énumération MFSequencerTopologyFlags .
Appelez IMFSequencerSource ::UpdateTopologyFlags pour mettre à jour les indicateurs de la topologie associée à l’identificateur de segment dans la liste d’entrée. Dans ce cas, l’appel indique que le segment spécifié est le dernier segment du séquenceur. (Cet appel est facultatif si la dernière topologie est spécifiée dans l’appel 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;
        }
    }
```

L’application peut remplacer la topologie d’un segment par une autre topologie en appelant IMFSequencerSource ::UpdateTopology et en passant la nouvelle topologie dans pTopology. S’il existe de nouvelles sources natives dans la nouvelle topologie, les sources sont ajoutées au cache source. La liste de prérolls est également actualisée.

Définition de la première topologie sur la session multimédia

Ensuite, mettez en file d'attente la première topologie dans la source de la séquence sur la Session Média. Pour obtenir la première topologie à partir de la source du séquenceur, l’application doit appeler la méthode IMFMediaSourceTopologyProvider::GetMediaSourceTopology. Cette méthode retourne la topologie partielle, qui est résolue par la session multimédia.

Pour plus d’informations sur les topologies partielles, consultez À propos des topologies.

Récupérez la source multimédia native pour la première topologie de la séquence d'origine.
Créez un descripteur de présentation pour la source multimédia en appelant la méthode IMFMediaSource ::CreatePresentationDescriptor .
Récupérez la topologie associée pour la présentation en appelant la méthode IMFMediaSourceTopologyProvider ::GetMediaSourceTopology .
Définissez la première topologie sur la session multimédia en appelant IMFMediaSession ::SetTopology.

Appelez SetTopology avec le paramètre dwSetTopologyFlags défini sur NULL. Cela indique à la session multimédia de démarrer la topologie spécifiée lorsque la topologie actuelle a été terminée. Étant donné que dans ce cas, la topologie spécifiée est la première topologie et qu’il n’y a pas de présentation actuelle, la session multimédia démarre la nouvelle présentation immédiatement.

La valeur NULL indique également que la session multimédia doit résoudre la topologie, car la topologie retournée par le fournisseur de topologie est toujours une topologie partielle.

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

Mise en file d’attente de la topologie suivante sur la session multimédia

Ensuite, l’application doit gérer l’événement MENewPresentation .

La source du séquenceur déclenche MENewPresentation lorsque la session multimédia commence la lecture d'un segment suivi par un autre segment. Cet événement informe l’application de la topologie suivante dans la source de séquence en fournissant le descripteur de présentation pour le segment suivant dans la liste de prérolls. L’application doit récupérer la topologie associée, à l’aide du fournisseur de topologie et la mettre en file d’attente sur la session multimédia. La source du séquenceur prépare ensuite à l'avance cette topologie, ce qui garantit une transition transparente entre les présentations.

Lorsque l'application recherche à travers les segments, l'application reçoit plusieurs événements MENewPresentation à mesure que la source de séquenceur actualise la liste de préchargement et configure la topologie correcte. L'application doit d'abord gérer chaque événement, puis mettre en file d'attente la topologie retournée à partir des données liées à l'événement, sur la session multimédia. Pour plus d’informations sur l’ignorer des segments, consultez Utilisation de la source Sequencer.

Pour plus d’informations sur l’obtention de notifications de source du séquenceur, consultez Sequencer Source Events.

Dans le gestionnaire d’événements MENewPresentation , récupérez le descripteur de présentation pour le segment suivant à partir des données d’événement.
Obtenez la topologie associée pour la présentation en appelant la méthode IMFMediaSourceTopologyProvider ::GetMediaSourceTopology .
Définissez la topologie sur la session multimédia en appelant la méthode IMFMediaSession ::SetTopology .

La session multimédia démarre la nouvelle présentation lorsque la présentation actuelle a été terminée.

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

Publication de la source du séquenceur

Enfin, arrêtez la source du séquenceur. Pour ce faire, appelez la méthode IMFMediaSource ::Shutdown sur la source du séquenceur. Cet appel arrête toutes les sources multimédias natives sous-jacentes dans la source du séquenceur.

Après avoir libéré la source du séquenceur, l’application doit fermer et arrêter la session multimédia en appelant IMFMediaSession ::Close et IMFMediaSession ::Shutdown, dans cet ordre.

Pour éviter les fuites de mémoire, l’application doit libérer des pointeurs vers les interfaces Media Foundation lorsqu’elles ne sont plus nécessaires.

Étapes suivantes

Cette procédure pas à pas a montré comment créer une playlist de base à l’aide de la source sequencer. Après avoir créé la playlist, vous souhaiterez peut-être ajouter des fonctionnalités avancées telles que l’saut de segment, la modification de l’état de lecture et la recherche dans un segment. La liste suivante fournit des liens vers les rubriques connexes :

Comment contrôler les états de présentation : le séquenceur source s’appuie sur la session multimédia pour permettre un contrôle du transport tel que lecture, pause et arrêt.
Comment effectuer un nettoyage décrit les étapes requises pour rechercher une position spécifique dans un flux.

source Sequencer