Freigeben über

Clientprotokollierung (Windows Media Format 11 SDK)

[Das dieser Seite zugeordnete Feature Windows Media Format 11 SDK-ist ein Legacyfeature. Es wurde von Source Reader und Sink Writerersetzt. Source Reader und Sink Writer wurden für Windows 10 und Windows 11 optimiert. Microsoft empfiehlt dringend, dass neuer Code Source Reader und Sink Writer- anstelle Windows Media Format 11 SDK-verwendet werden soll. Microsoft schlägt vor, dass vorhandener Code, der die Legacy-APIs verwendet, um die neuen APIs zu verwenden, falls möglich umgeschrieben werden.]

Wenn das Leseobjekt Daten von einem Server liest, sendet es Protokollierungsinformationen an den Server. Inhaltsanbieter verwenden diese Informationen in der Regel, um die Qualität des Dienstes zu messen, Abrechnungsinformationen zu generieren oder Werbung nachzuverfolgen. Die Protokollierungsinformationen enthalten keine personenbezogenen Daten.

Die Anwendung kann einige der protokollierten Informationen angeben, indem sie die IWMReaderAdvanced::SetClientInfo-Methode für das Reader-Objekt aufrufen. Sie können z. B. die Benutzer-Agent-Zeichenfolge, den Namen der Spieleranwendung oder die Webseite angeben, auf der der Spieler gehostet wird.

Die Protokollierungsinformationen enthalten eine GUID, die die Sitzung identifiziert. Standardmäßig generiert der Leser eine anonyme Sitzungs-ID. Optional kann der Leser stattdessen eine ID senden, die den aktuellen Benutzer eindeutig identifiziert. Rufen Sie zum Aktivieren dieses Features die IWMReaderAdvanced2::SetLogClientID Methode mit dem Wert TRUEauf.

Sie können das Leseobjekt so konfigurieren, dass die Protokollierungsinformationen zusätzlich zum ursprünglichen Server an einen anderen Server gesendet werden. Rufen Sie dazu die IWMReaderNetworkConfig::AddLoggingUrl Methode mit der URL des Servers auf. Diese URL sollte auf ein Skript oder eine ausführbare Datei verweisen, die HTTP GET- und POST-Anforderungen verarbeiten kann. Sie können den Multicast- und Protokollierungsanzeige-Agent (wmsiislog.dll) verwenden oder ein benutzerdefiniertes ASP- oder CGI-Skript schreiben, um die Protokolldaten zu empfangen.

Anmerkung

Sie können die gleiche Funktionalität erhalten, indem Sie eine serverseitige Wiedergabeliste mit einem logURL--Attribut erstellen.

 

Wenn das Leseobjekt das Protokoll sendet, führt es folgende Aktionen aus:

  1. Sendet eine leere GET-Anforderung an den Server.
  2. Analysiert die Serverantwort für eine der folgenden Zeichenfolgen:
    • <body><h1>NetShow ISAPI Log Dll</h1>
    • <body><h1>WMS ISAPI Log Dll/0.0.0.0</h1> wobei "0.0.0.0" eine beliebige gültige Versionsnummer ist.
  3. Sendet eine POST-Anforderung mit den Protokollinformationen.

Der folgende Code zeigt ein ASP-Beispielskript, das die Protokollierungsinformationen empfängt und in eine Datei schreibt:

<html>
<body>
<h1>WMS ISAPI Log Dll/9.00.00.00.00</h1>
<%@ Language=VBScript %>
<%
  Dim temp, i, post, file, fso

  ' Convert the binary data to a string.
  For i = 1 To Request.TotalBytes
    temp = Request.BinaryRead(1)
    pose = pose & Chr(AscB(temp))
  Next

  Set fso = createobject("Scripting.FileSystemObject")
  Set file = fso.OpenTextFile("C:\log.txt", 8, TRUE)

  file.writeline Now
  file.writeline post
  file.writeBlankLines 2 
%>
</body>
</html>

Sie können mehrere Server angeben, die Protokollierungsinformationen empfangen sollen; Rufen Sie einfach AddLoggingUrl einmal mit jeder URL auf. Rufen Sie zum Löschen der Liste der Server, die Protokolle empfangen, die IWMReaderNetworkConfig::ResetLoggingUrlList Methode auf.

Implementieren von Netzwerkfunktionen

IWMReaderAdvanced Interface

IWMReaderAdvanced2-Schnittstelle

 

 

  • Last updated on