Ведение журнала клиента (Microsoft Media Foundation)

Сетевой источник поддерживает ведение журнала клиентов, что позволяет серверу мультимедиа отслеживать действия клиентов, подключающихся к нему. Журналы клиентов позволяют серверу записывать статистику подключения, отрисовки и потоковой передачи. Эти журналы могут использоваться поставщиками содержимого в различных сценариях, например для отслеживания использования сервера мультимедиа и выставления счетов, а также для доставки содержимого подходящего качества в зависимости от скорости сети клиента.

Файл журнала содержит несколько записей событий клиента. Каждая запись журнала содержит ряд полей с разделителями пробелами. Существует два типа журналов клиента: отрисовка (воспроизведение) и потоковая передача (получение). Так как содержимое может воспроизводиться и передаваться в потоковую передачу одновременно, клиент может отправлять сочетание обоих типов данных журнала. В некоторых случаях для одного сеанса могут существовать две записи журнала. Например, если включен быстрый кэш, клиент может завершить получение потокового содержимого до завершения его отрисовки. В этом случае данные журнала потоковой передачи будут отправляться перед данными журнала отрисовки.

Клиент отправляет данные журнала отрисовки на сервер, когда клиент переходит из любого состояния воспроизведения (воспроизведение, быстрое перемещение вперед или перемотка) в не воспроизводимое состояние (остановка, приостановка, конец потока и начало потока). При отправке данных для журнала отрисовки соединение выполняется непосредственно с сервером мультимедиа или настроенным прокси-сервером.

Если содержимое хранится во временном файле локального кэша на компьютере, на котором выполняется клиент, клиент может прочитать файл из локального кэша и отправить данные журнала отрисовки, чтобы указать, что он воспроизводил содержимое. В этом случае клиент считывает файл из локального кэша, запись журнала отрисовки не содержит статистики по сети, а для протокола задано значение Кэш.

Клиент отправляет данные журнала потоковой передачи на сервер, чтобы указать, как клиент получил содержимое, но не как оно было отрисовывается. Клиент может отправить журнал потоковой передачи задолго до завершения отрисовки содержимого.

В этом разделе содержатся сведения не обо всех полях журнала. Полный справочник см. в статье Структура данных журнала Windows Media.

Настройка полей журнала

Media Foundation позволяет клиенту настроить сетевой источник с помощью свойств. Приложение должно задать соответствующие свойства в хранилище свойств и передать их одному из методов сопоставителя источника. Сопоставитель источника создает сетевой источник в соответствии с запросом и открывает подключение к серверу. Если подключение установлено успешно, клиент отправляет сведения о себе.

В следующей таблице описаны поля журнала и соответствующие свойства, которые приложение может задать с помощью сопоставителя источника. Эти сведения не изменяются во время сеанса.

В следующем примере кода показано, как клиентское приложение настраивает сетевой источник. В этом примере задается поле журнала 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;
}

Получение статистики сети

Когда приложение вызывает один из методов сопоставителя источника, оно создает сетевой источник, задает свойства, указанные в хранилище свойств, и открывает сеанс с сервером мультимедиа. В дополнение к настраиваемым сведениям, описанным в предыдущем разделе, дополнительные данные передаются между сервером и клиентом в начале сеанса, во время потоковой передачи и при закрытии сеанса.

Приложение может получать статистику по сети с помощью идентификатора службы MFNETSOURCE_STATISTICS_SERVICE . Чтобы использовать эту службу, приложение может вызвать функцию MFGetService , чтобы получить хранилище свойств, содержащее статистику сети в свойстве MFNETSOURCE_STATISTICS . Конкретные значения можно получить, указав соответствующий идентификатор, определенный в перечислении MFNETSOURCE_STATISTICS_IDS .

В следующем примере кода показано, как использовать службу для получения количества пакетов, полученных клиентом.

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

В следующем списке описаны некоторые идентификаторы статистики сети, определенные в MFNETSOURCE_STATISTICS_IDS.

Связанные темы

Функции источника сети

Сеть в Media Foundation