Share via

記錄資料流程資料

  • 發行項

[與此頁面相關聯的功能Windows 媒體播放機 SDK是舊版功能。 它已被 MediaPlayer 取代。 MediaPlayer已針對Windows 10和Windows 11進行優化。 Microsoft 強烈建議新程式碼盡可能使用MediaPlayer，而不是Windows 媒體播放機 SDK。 Microsoft 建議盡可能重寫使用舊版 API 的現有程式碼，以使用新的 API。]

您可以取得記錄的資訊，並用來判斷檢視者行為，例如檢視資料流程的頻率，或特定使用者是否檢視資料流程，以及品質的長度。

記錄資訊會自動傳送至播放清單的來源伺服器。 您也可以將記錄資訊傳送至其他伺服器，包括您專用於記錄的網頁伺服器。 若要這樣做，請使用 LOGURL 元素，並指定 HREF 屬性的有效 URL。 您可以包含 LOGURL 元素做為 ASX 元素的子系，以及個別 ENTRY 元素的子 系 。 第一次開啟播放清單時，記錄資訊會傳送至源伺服器，以及ASX元素之 LOGURL子系中指定的每個 URL。 然後，到達每個專案時，該專案特有的記錄資訊會傳送至ENTRY元素之 LOGURL子系中指定的每個 URL。

Windows 媒體格式 SDK 透過IWMSReaderNetworkConfig介面和下列方法支援LOGURL元素：

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

除了自動記錄的資訊之外，中繼檔播放清單還可以透過 使用 PARAM 元素來記錄自訂資訊。 若要以這種方式使用 PARAM 元素，請將 NAME 屬性設定為 「log：」，後面接著記錄功能變數名稱和選擇性 XML 命名空間，並以另一個冒號分隔 (「：」) 。 第二個冒號之後的所有專案都會被視為命名空間，因此功能變數名稱不應包含冒號。

NAME屬性中指定的記錄欄位會設定為VALUE屬性的值。 如果記錄檔尚未包含具有指定名稱的欄位，則會新增。

範例程式碼


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

中繼檔播放清單

Windows Media 中繼檔元素參考