ファイル ベースの SDK ログ記録を制御する静的メソッドを持つクラス。 Speech SDK シナリオの実行中にログ記録を有効にすると、SDK のコア ネイティブ コンポーネントから詳細情報が提供されます。 Microsoft に問題を報告した場合は、Microsoft が問題を診断するのに役立つログを提供するように求められる場合があります。 アプリケーションは、特定のログ文字列に依存しないようにする必要があります。これは、SDK リリース間で予告なく変更される可能性があるためです。 FileLogger は最も簡単なログ記録ソリューションであり、Speech SDK の実行時にデバイス上のほとんどの問題を診断するのに適しています。 バージョン 1.20.0 で追加されました。
ファイル ログはプロセス全体のコンストラクトです。 つまり、(たとえば) 複数の音声認識エンジン オブジェクトが並列で実行されている場合、すべての認識エンジンのインターリーブログ行を含むログ ファイルが 1 つ存在します。 認識エンジンごとに個別のログ ファイルを取得することはできません。
メンバー
開始
構文： public inline static void Start ( const std::string & filePath , bool append );
ファイルへのログ記録を開始します。
パラメーター
filePathローカル ディスク上のログ ファイルへのパスappend省略可能です。 true の場合は、既存のログ ファイルに追加します。 false の場合は、新しいログ ファイルを作成します
ファイルへの各書き込み操作の直後に、ディスクへのフラッシュが行われます。 一般的な用途 (たとえば、1 つの Speech Recognizer とソリッド ステート ドライブ (SSD)) では、パフォーマンスの問題は発生しません。 ただし、多数の Speech SDK 認識エンジンまたは他の SDK オブジェクトを同時に実行する場合は、ファイル のログ記録を回避できます。 代わりに MemoryLogger または EventLogger を使用してください。
止める
構文： public inline static void Stop ( );
ファイルへのログ記録を停止します。
この呼び出しは省略可能です。 ログ記録が開始されている場合は、プロセスが正常に存在するときにログ ファイルが書き込まれます。
フィルターを設定
構文： public inline static void SetFilters ( std::initializer_list< std::string > filters );
ファイル ログに適用されるフィルターを設定またはクリアします。 フィルターが設定されると、ログ文字列にフィルターで指定された文字列の少なくとも 1 つが含まれている場合にのみ、コールバックが呼び出されます。 一致では大文字と小文字が区別されます。
パラメーター
-
filters省略可能です。 使用するフィルター、または以前に設定したフィルターを削除する空のリスト。
レベル設定
構文： public inline static void SetLevel ( Level level );
ロガーによってキャプチャされるメッセージのレベルを設定します。
パラメーター
-
levelロガーによってキャプチャされる詳細の最大レベルです。