Registrazione client (Microsoft Media Foundation)

L'origine di rete supporta la registrazione client, che consente al server multimediale di tenere traccia dell'attività dei client che si connettono. I log client consentono a un server di registrare le statistiche di connessione, rendering e streaming. Questi log possono essere usati dai provider di contenuto in diversi scenari, ad esempio, per tracciare l'utilizzo del server multimediale e generare la fatturazione o per offrire contenuti di qualità appropriati a seconda della velocità della rete del client.

Un file di log contiene diverse voci di evento client. Ogni voce di log contiene un numero di campi delimitati da spazio. Esistono due tipi di log client: rendering (riproduzione) e streaming (ricezione). Poiché il contenuto può essere riprodotto e trasmesso contemporaneamente, il client può inviare una combinazione di entrambi i tipi di dati di log. In alcuni casi, due voci di log possono esistere per la stessa sessione. Ad esempio, quando la cache rapida è abilitata, il client può completare la ricezione del contenuto trasmesso prima di completare il rendering. In tal caso, i dati del log di streaming verranno inviati prima dei dati del log di rendering.

Il client invia i dati del log di rendering al server quando il client cambia da qualsiasi stato di riproduzione (riproduzione, inoltro rapido o riavvolgimento) a uno stato non riprodotto (arresto, sospensione, fine del flusso e inizio del flusso). Quando vengono inviati dati per un log di rendering, viene eseguita una connessione direttamente al server multimediale o a un server proxy configurato.

Se il contenuto viene archiviato in un file di cache locale temporaneo nel computer che esegue il client, il client può leggere un file dalla cache locale e inviare i dati del log di rendering per indicare che ha riprodotto il contenuto. In questo caso, il client legge un file dalla cache locale, la voce del log di rendering non contiene statistiche di rete e il protocollo è impostato su Cache.

Il client invia i dati del log di streaming al server per indicare come il client ha ricevuto il contenuto, ma non come è stato eseguito il rendering. Il client può inviare il log di streaming a lungo prima del completamento del rendering del contenuto.

Questo argomento non fornisce informazioni su tutti i campi di log. Per un riferimento completo, vedere Struttura dei dati dei log di Windows Media.

Configurazione dei campi di log

Media Foundation consente al client di configurare l'origine di rete usando le proprietà. L'applicazione deve impostare le proprietà appropriate in un archivio delle proprietà e passarla a uno dei metodi del resolver di origine. Il resolver di origine crea l'origine di rete come richiesto e apre una connessione con il server. Se la connessione ha esito positivo, il client invia informazioni su se stesso.

La tabella seguente descrive i campi di log e le proprietà corrispondenti che un'applicazione può impostare tramite il resolver di origine. Queste informazioni non cambiano durante la sessione.

Nell'esempio di codice seguente viene illustrato come un'applicazione client configura l'origine di rete. In questo esempio viene impostato il campo di log "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;
}

Recupero delle statistiche di rete

Quando l'applicazione chiama uno dei metodi del resolver di origine, crea l'origine di rete, imposta le proprietà specificate nell'archivio delle proprietà e apre una sessione con il server multimediale. Oltre alle informazioni configurabili descritte nella sezione precedente, i dati aggiuntivi vengono trasferiti tra il server e il client all'inizio della sessione, durante lo streaming e quando la sessione viene chiusa.

L'applicazione può recuperare le statistiche di rete usando l'identificatore del servizio MFNETSOURCE_STATISTICS_SERVICE . Per usare questo servizio, l'applicazione può chiamare la funzione MFGetService per ottenere l'archivio delle proprietà contenente le statistiche di rete nella proprietà MFNETSOURCE_STATISTICS . È possibile recuperare valori specifici specificando l'identificatore corrispondente definito nell'enumerazione MFNETSOURCE_STATISTICS_IDS .

Nell'esempio di codice seguente viene illustrato come usare il servizio per ottenere il numero di pacchetti ricevuti dal client.

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

Nell'elenco seguente vengono descritti alcuni identificatori di statistiche di rete definiti in MFNETSOURCE_STATISTICS_IDS.

Argomenti correlati

Funzionalità di origine di rete

Rete in Media Foundation