Données de flux de journalisation

  • Article

[La fonctionnalité associée à cette page, Lecteur multimédia Windows SDK, est une fonctionnalité héritée. Il a été remplacé par MediaPlayer. MediaPlayer a été optimisé pour Windows 10 et Windows 11. Microsoft recommande vivement que le nouveau code utilise MediaPlayer au lieu de Lecteur multimédia Windows SDK, lorsque cela est possible. Microsoft suggère que le code existant qui utilise les API héritées soit réécrit pour utiliser les nouvelles API si possible.]

Les informations journalisées peuvent être acquises et utilisées pour déterminer le comportement de la visionneuse, par exemple, la fréquence à laquelle un flux est consulté ou si un utilisateur spécifique a consulté un flux et pendant combien de temps à quelle qualité.

Les informations de journalisation sont automatiquement envoyées au serveur d’où provient la playlist. Vous pouvez également envoyer des informations de journalisation à d’autres serveurs, y compris des serveurs web que vous utilisez exclusivement pour la journalisation. Pour ce faire, utilisez l’élément LOGURL , en spécifiant une URL valide pour l’attribut HREF . Vous pouvez inclure des éléments LOGURL en tant qu’enfants de l’élément ASX et en tant qu’enfants d’éléments ENTRY individuels. Lorsque la playlist est ouverte pour la première fois, les informations de journalisation sont envoyées au serveur d’origine et à chaque URL spécifiée dans LOGURL children de l’élément ASX . Ensuite, à mesure que chaque entrée est atteinte, les informations de journalisation spécifiques à cette entrée sont envoyées à chaque URL spécifiée dans LOGURL children de l’élément ENTRY .

Le Kit de développement logiciel (SDK) Windows Media Format prend en charge l’élément LOGURL via l’interface IWMSReaderNetworkConfig et les méthodes suivantes :

HRESULT AddLoggingUrl(LPCWSTR pwszUrl);
HRESULT GetLoggingUrl(DWORD dwIndex, LPCWSTR pwszUrl, DWORD *pcchUrl);
HRESULT GetLoggingUrlCount(DWORD *pdwUrlCount);
HRESULT ResetLoggingUrlList();

En plus des informations journalisées automatiquement, une playlist de métafichiers peut enregistrer des informations personnalisées via l’utilisation de l’élément PARAM . Pour utiliser l’élément PARAM de cette façon, définissez l’attribut NAME sur « log: », suivi d’un nom de champ de journal et d’un espace de noms XML facultatif séparé du nom du champ par un autre signe deux-points (« : »). Tout ce qui se trouve après le deuxième signe deux-points est traité comme un espace de noms. Par conséquent, le nom de champ ne doit pas contenir de deux points.

Le champ de journal spécifié dans l’attribut NAME est défini sur la valeur de l’attribut VALUE . Si le journal ne contient pas encore de champ portant le nom spécifié, il est ajouté.

Exemple de code


    <ASX version="3.0">
      <LOGURL href="https://www.proseware.com/log.asp?SomeArg=SomeVal" />
      <ENTRY>
        <REF href="mms://ucast.proseware.com/Media1.wma" />
        <LOGURL href="https://www.proseware.com/cgi-bin/logging.pl?SomeArg=SomeVal" />
        <LOGURL href="https://www.proseware.com/WMLogging.dll?SomeArg=SomeVal" />
        <PARAM name="log:cs-media-role" value="Advertisement"/>
        <PARAM name="log:cs-media-name:namespace" value="Music"/>
        <REF href=rtsp://ucast.proseware.com/Media1.wma"/>
      </ENTRY>
      <ENTRY>
        <REF href="mms://ucast.proseware.com/Media2.wma"/>
      </ENTRY>
    </ASX>

Playlists de métafichiers

Informations de référence sur les éléments de métafichier Windows Media