Поделиться через

класс Diagnostics::Logging::EventLogger

  • Статья

Класс со статическими методами для управления ведением журнала пакета SDK на основе обратных вызовов. Включение ведения журнала при запуске сценария пакета SDK службы "Речь" предоставляет подробные сведения из основных компонентов пакета SDK. Если вы сообщаете о проблеме с корпорацией Майкрософт, вам может быть предложено предоставить журналы, чтобы помочь Корпорации Майкрософт диагностировать проблему. Приложение не должно зависеть от определенных строк журнала, так как они могут меняться с одного выпуска пакета SDK на другой без уведомления. Используйте EventLogger, если вы хотите получить доступ к новым строкам журнала, как только они будут доступны, и их необходимо дополнительно обработать. Например, интеграция журналов пакета SDK службы "Речь" с существующей системой сбора журналов. Добавлено в версию 1.20.0.

Ведение журнала событий — это широкая конструкция процесса. Это означает, что если (например) у вас несколько объектов распознавателя речи, работающих параллельно, можно зарегистрировать только одну функцию обратного вызова для получения чередуемых журналов от всех распознавателей. Вы не можете зарегистрировать отдельный обратный вызов для каждого распознавателя.

Члены

SetCallback

Синтаксис: public inline static void SetCallback ( CallbackFunction_Type callback );

Зарегистрируйте функцию обратного вызова, которая будет вызываться для каждого нового сообщения журнала.

Параметры

  • callback функцию обратного вызова для вызова. Задайте значение nullptr, чтобы остановить средство ведения журнала событий.

Можно зарегистрировать только одну функцию обратного вызова. Этот вызов произойдет в рабочем потоке пакета SDK, поэтому строка журнала должна быть скопирована где-то для дальнейшей обработки другим потоком, и функция должна вернуться немедленно. В этой функции обратного вызова не следует выполнять тяжелые обработки или сетевые вызовы.

SetFilters

Синтаксис: public inline static void SetFilters ( std::initializer_list< std::string > filters );

Задает или очищает фильтры для обратных вызовов. После установки фильтров обратный вызов будет вызываться только в том случае, если строка журнала содержит по крайней мере одну из строк, указанных фильтрами. Совпадение учитывает регистр.

Параметры

  • filters Необязательно. Фильтры для использования или пустой список для очистки ранее заданных фильтров

SetLevel

Синтаксис: public inline static void SetLevel ( Level level );

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

Параметры

  • level Максимальный уровень детализации для записи средства ведения журнала.

CallbackFunction_Type

Синтаксис: typedef CallbackFunction_Type;