Logowanie klienta (Microsoft Media Foundation)

Źródło sieci obsługuje rejestrowanie klientów, co umożliwia serwerowi multimediów śledzenie aktywności klientów łączących się z nim. Dzienniki klienta umożliwiają serwerowi rejestrowanie połączenia, renderowania i statystyk przesyłania strumieniowego. Te dzienniki mogą być używane przez dostawców zawartości w różnych scenariuszach, takich jak śledzenie użycia serwera multimediów i generowanie rozliczeń lub dostarczanie odpowiedniej jakości zawartości w zależności od szybkości sieci klienta.

Plik dziennika zawiera kilka wpisów zdarzeń klienta. Każdy wpis dziennika zawiera wiele pól rozdzielanych spacjami. Istnieją dwa typy dzienników klienta: renderowania (odtwarzanie) i przesyłania strumieniowego (odbieranie). Ponieważ zawartość może być odtwarzana i przesyłana strumieniowo jednocześnie, klient może wysyłać kombinację obu typów danych dziennika. W niektórych przypadkach dla tej samej sesji mogą istnieć dwa wpisy dziennika. Na przykład po włączeniu szybkiej pamięci podręcznej klient może zakończyć odbieranie przesyłanej strumieniowo zawartości przed zakończeniem renderowania. W takim przypadku dane dziennika przesyłania strumieniowego zostaną wysłane przed danymi dziennika renderowania.

Klient wysyła dane dziennika renderowania do serwera, gdy przechodzi ze stanu odtwarzania (odtwarzanie, przewijanie do przodu, przewijanie do tyłu) do stanu braku odtwarzania (stop, pauza, koniec strumienia, początek strumienia). Po przesłaniu danych dziennika renderowania połączenie jest wykonywane bezpośrednio z serwerem multimediów lub skonfigurowanym serwerem proxy.

Jeśli zawartość jest przechowywana w tymczasowym lokalnym pliku pamięci podręcznej na komputerze, na którym działa klient, klient może odczytać plik ze swojej lokalnej pamięci podręcznej i przesłać dane dziennika renderowania, aby wskazać, że odtworzył zawartość. W takim przypadku klient odczytuje plik z lokalnej pamięci podręcznej, wpis dziennika renderowania nie zawiera żadnych statystyk sieciowych, a protokół ma wartość Pamięć podręczna.

Klient wysyła dane dziennika przesyłania strumieniowego do serwera, aby wskazać, w jaki sposób klient odebrał zawartość, ale nie sposób jego renderowania. Klient może wysłać dziennik przesyłania strumieniowego na długo przed zakończeniem renderowania zawartości przez klienta.

Ten temat nie zawiera informacji o wszystkich dostępnych polach dziennika. Aby uzyskać kompletne odniesienie, zobacz Struktura danych dziennika usługi Windows Media.

Konfigurowanie pól dziennika

Program Media Foundation umożliwia klientowi skonfigurowanie źródła sieci przy użyciu właściwości. Aplikacja musi ustawić odpowiednie właściwości w składzie właściwości i przekazać go do jednej z metod rozpoznawania źródła. Program rozpoznawania źródła tworzy źródło sieci zgodnie z żądaniem i otwiera połączenie z serwerem. Jeśli połączenie zakończy się pomyślnie, klient wysyła informacje o sobie.

W poniższej tabeli opisano pola dziennika i odpowiednie właściwości, które aplikacja może ustawić za pośrednictwem narzędzia rozpoznawania źródła. Te informacje nie zmieniają się podczas sesji.

Poniższy przykład kodu pokazuje, jak aplikacja kliencka konfiguruje źródło sieci. W tym przykładzie ustawiane jest pole dziennika "c-hostexe".

// Creates a media source from a URL.
//
// This example demonstrates how to set the MFNETSOURCE_HOSTEXE
// configuration property on the network source.

HRESULT CreateMediaSourceWithLogParams(
    PCWSTR pszURL, 
    IMFMediaSource **ppSource
    )
{
    IPropertyStore *pConfig = NULL;

    // Configure the property store.
    HRESULT hr = PSCreateMemoryPropertyStore(IID_PPV_ARGS(&pConfig));

    if (SUCCEEDED(hr))
    {
        PROPERTYKEY key;
        key.fmtid =  MFNETSOURCE_HOSTEXE;
        key.pid = 0;

        PROPVARIANT var;
        var.vt = VT_LPWSTR;
        var.pwszVal = L"MyPlayer.exe";

        hr = pConfig->SetValue(key, var);
    }

    // Create the source media source.
    if (SUCCEEDED(hr))
    {
        hr = CreateMediaSource(pszURL, pConfig, ppSource);
    }

    SafeRelease(&pConfig);
    return hr;
}

Pobieranie statystyk sieci

Gdy aplikacja wywołuje jedną z metod rozpoznawania źródła, tworzy źródło sieci, ustawia właściwości określone w magazynie właściwości i otwiera sesję z serwerem multimediów. Oprócz konfigurowalnych informacji opisanych w poprzedniej sekcji dodatkowe dane są przesyłane między serwerem a klientem na początku sesji, podczas przesyłania strumieniowego i po zamknięciu sesji.

Aplikacja może pobierać statystyki sieci przy użyciu identyfikatora usługi MFNETSOURCE_STATISTICS_SERVICE. Aby użyć tej usługi, aplikacja może wywołać funkcję MFGetService w celu uzyskania repozytorium właściwości zawierającego statystyki sieciowe we właściwości MFNETSOURCE_STATISTICS. Określone wartości można pobrać, podając odpowiedni identyfikator zdefiniowany w enumeracji MFNETSOURCE_STATISTICS_IDS.

Poniższy przykład kodu pokazuje, jak za pomocą usługi uzyskać liczbę pakietów odebranych przez klienta.

HRESULT GetPacketsReceived(IMFMediaSession *pSession, DWORD *pcPackets)
{
    IPropertyStore *pProp = NULL;
    PROPVARIANT var;

    // Get the property store from the media session.
    HRESULT hr = MFGetService(
        pSession, 
        MFNETSOURCE_STATISTICS_SERVICE, 
        IID_PPV_ARGS(&pProp)
        );

    // Get the number of packets received by the client.

    if (SUCCEEDED(hr))
    {
        PROPERTYKEY key;
        key.fmtid = MFNETSOURCE_STATISTICS;
        key.pid = MFNETSOURCE_RECVPACKETS_ID;

        hr = pProp->GetValue(key, &var);
    }

    if (SUCCEEDED(hr))
    {
        *pcPackets = var.lVal;
    }

    PropVariantClear(&var);
    SafeRelease(&pProp);
    return hr;
}

Poniższa lista zawiera opis niektórych identyfikatorów statystyk sieci zdefiniowanych w MFNETSOURCE_STATISTICS_IDS.

Tematy pokrewne

funkcje źródła sieci

Sieci w Media Foundation