Registro de datos de flujo

  • Artículo

[La característica asociada a esta página, Reproductor multimedia de Windows SDK, es una característica heredada. Se ha reemplazado por MediaPlayer. MediaPlayer se ha optimizado para Windows 10 y Windows 11. Microsoft recomienda encarecidamente que el nuevo código use MediaPlayer en lugar de Reproductor multimedia de Windows SDK, siempre que sea posible. Microsoft sugiere que el código existente que usa las API heredadas se reescriba para usar las nuevas API si es posible.

La información registrada se puede adquirir y usar para determinar el comportamiento del visor, por ejemplo, la frecuencia con la que se ve una secuencia, o si un usuario específico ha visto una secuencia y durante cuánto tiempo tiene la calidad.

La información de registro se envía automáticamente al servidor desde el que se originó la lista de reproducción. También puede enviar información de registro a servidores adicionales, incluidos los servidores web que use exclusivamente para el registro. Para ello, use el elemento LOGURL , especificando una dirección URL válida para el atributo HREF . Puede incluir elementos LOGURL como elementos secundarios del elemento ASX y como elementos secundarios de elementos ENTRY individuales. Cuando se abre la lista de reproducción por primera vez, la información de registro se envía al servidor de origen y a cada dirección URL especificada en los elementos secundarios LOGURL del elemento ASX . A continuación, a medida que se alcanza cada entrada, la información de registro específica de esa entrada se envía a cada dirección URL especificada en los elementos secundarios LOGURL del elemento ENTRY .

El SDK de Windows Media Format admite el elemento LOGURL a través de la interfaz IWMSReaderNetworkConfig y los métodos siguientes:

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

Además de la información que se registra automáticamente, una lista de reproducción de metarchivo puede registrar información personalizada mediante el uso del elemento PARAM . Para usar el elemento PARAM de esta manera, establezca el atributo NAME en "log:" seguido de un nombre de campo de registro y un espacio de nombres XML opcional separado del nombre del campo por otros dos puntos (":"). Todo lo que aparece después del segundo dos puntos se trata como un espacio de nombres, por lo que el nombre del campo no debe contener dos puntos.

El campo de registro especificado en el atributo NAME se establece en el valor del atributo VALUE . Si el registro aún no contiene un campo con el nombre especificado, se agregará.

Código de ejemplo


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

Listas de reproducción de metarchivo

Referencia de elementos de metarchivo de Windows Media