파일 기반 SDK 로깅을 제어하는 정적 메서드가 있는 클래스입니다. Speech SDK 시나리오를 실행하는 동안 로깅을 켜면 SDK의 핵심 네이티브 구성 요소에서 자세한 정보가 제공됩니다. Microsoft에 문제를 보고하는 경우 Microsoft에서 문제를 진단하는 데 도움이 되는 로그를 제공하라는 메시지가 표시될 수 있습니다. 애플리케이션은 예고 없이 SDK 릴리스에서 다른 SDK 릴리스로 변경될 수 있으므로 특정 로그 문자열에 종속되지 않아야 합니다. FileLogger는 가장 간단한 로깅 솔루션이며 Speech SDK를 실행할 때 대부분의 디바이스 내 문제를 진단하는 데 적합합니다. 버전 1.20.0에 추가되었습니다.
파일 로깅은 프로세스 전체 구문입니다. 예를 들어 여러 음성 인식기 개체가 병렬로 실행되는 경우 모든 인식기의 인터리브 로그 줄이 포함된 로그 파일이 하나 있습니다. 각 인식기마다 별도의 로그 파일을 가져올 수 없습니다.
구성원
시작
구문: public inline static void Start ( const std::string & filePath , bool append );
파일에 대한 로깅을 시작합니다.
매개 변수
로컬 디스크의 로그 파일에 대한
filePath경로append선택 사항입니다. true이면 기존 로그 파일에 추가합니다. false이면 새 로그 파일을 만듭니다.
파일에 대한 각 쓰기 작업 뒤에 디스크에 대한 플러시가 즉시 수행됩니다. 일반적인 사용(예: Speech Recognizer 1개 및 SSD(반도체 드라이브))의 경우 성능 문제가 발생하지 않아야 합니다. 그러나 여러 Speech SDK 인식기 또는 다른 SDK 개체를 동시에 실행할 때 파일 로깅을 방지할 수 있습니다. 대신 MemoryLogger 또는 EventLogger를 사용합니다.
중지
구문: public inline static void Stop ( );
파일에 대한 로깅을 중지합니다.
이 호출은 선택 사항입니다. 로깅이 시작된 경우 프로세스가 정상적으로 존재할 때 로그 파일이 기록됩니다.
SetFilters
구문: public inline static void SetFilters ( std::initializer_list< std::string > filters );
파일 로깅에 적용되는 필터를 설정하거나 지웁니다. 필터가 설정되면 로그 문자열에 필터에 지정된 문자열 중 하나 이상이 포함된 경우에만 콜백이 호출됩니다. 일치 항목은 대/소문자를 구분합니다.
매개 변수
-
filters선택 사항입니다. 사용할 필터 또는 이전에 설정된 필터를 제거할 빈 목록입니다.
SetLevel
구문: public inline static void SetLevel ( Level level );
로거가 캡처할 메시지의 수준을 설정합니다.
매개 변수
-
level로거가 캡처할 최대 세부 수준입니다.