다음을 통해 공유


SpeechRecognizer 클래스

음성 인식기입니다. 원본 언어 정보를 지정해야 하는 경우 언어, source_language_config 또는 auto_detect_source_language_config 세 가지 매개 변수 중 하나만 지정하세요.

상속
SpeechRecognizer

생성자

SpeechRecognizer(speech_config: SpeechConfig, audio_config: AudioConfig = None, language: str = None, source_language_config: SourceLanguageConfig = None, auto_detect_source_language_config: AutoDetectSourceLanguageConfig = None)

매개 변수

Name Description
speech_config
필수

음성 인식기 구성

audio_config

오디오 입력에 대한 구성

기본값: None
language

원본 언어입니다.

기본값: None
source_language_config

원본 언어 구성

기본값: None
auto_detect_source_language_config

자동 검색 원본 언어 구성

기본값: None

메서드

recognize_once

차단(동기) 모드에서 인식을 수행합니다. 단일 발화가 인식된 후 반환합니다. 단일 발화의 끝은 끝에서 무음을 수신하거나 최대 15초의 오디오가 처리될 때까지 대기하여 결정됩니다. 작업에서는 인식 텍스트를 결과로 반환합니다. 길게 실행되는 다중 발화 인식의 경우 start_continuous_recognition_async를 대신 사용하세요.

recognize_once_async

비차단(비동기) 모드에서 인식을 수행합니다. 단일 발화를 인식합니다. 단일 발화의 끝은 끝에서 무음을 수신하거나 최대 15초의 오디오가 처리될 때까지 대기하여 결정됩니다. 길게 실행되는 다중 발화 인식의 경우 start_continuous_recognition_async를 대신 사용하세요.

start_continuous_recognition

연속 인식 작업을 동기적으로 시작합니다. 사용자는 EventSignal에 연결하여 인식 결과를 받아야 합니다. 를 호출 stop_continuous_recognition_async 하여 인식을 중지합니다.

start_continuous_recognition_async

연속 인식 작업을 비동기적으로 시작합니다. 사용자는 EventSignal에 연결하여 인식 결과를 받아야 합니다. 를 호출 stop_continuous_recognition_async 하여 인식을 중지합니다.

start_keyword_recognition

지정된 키워드(keyword) 모델을 사용하여 인식기를 동기적으로 구성합니다. 이 메서드를 호출한 후 인식기는 키워드(keyword) 수신 대기하여 인식을 시작합니다. stop_keyword_recognition()를 호출하여 키워드(keyword) 시작된 인식을 종료합니다.

start_keyword_recognition_async

지정된 키워드(keyword) 모델을 사용하여 인식기를 비동기적으로 구성합니다. 이 메서드를 호출한 후 인식기는 키워드(keyword) 수신 대기하여 인식을 시작합니다. stop_keyword_recognition_async()를 호출하여 키워드(keyword) 시작된 인식을 종료합니다.

stop_continuous_recognition

지속적인 지속적인 인식 작업을 동기적으로 종료합니다.

stop_continuous_recognition_async

진행 중인 연속 인식 작업을 비동기적으로 종료합니다.

stop_keyword_recognition

키워드(keyword) 시작된 인식을 동기적으로 종료합니다.

stop_keyword_recognition_async

키워드(keyword) 시작된 인식을 비동기적으로 종료합니다.

recognize_once

차단(동기) 모드에서 인식을 수행합니다. 단일 발화가 인식된 후 반환합니다. 단일 발화의 끝은 끝에서 무음을 수신하거나 최대 15초의 오디오가 처리될 때까지 대기하여 결정됩니다. 작업에서는 인식 텍스트를 결과로 반환합니다. 길게 실행되는 다중 발화 인식의 경우 start_continuous_recognition_async를 대신 사용하세요.

recognize_once() -> SpeechRecognitionResult

반환

형식 Description

동기 인식의 결과 값입니다.

recognize_once_async

비차단(비동기) 모드에서 인식을 수행합니다. 단일 발화를 인식합니다. 단일 발화의 끝은 끝에서 무음을 수신하거나 최대 15초의 오디오가 처리될 때까지 대기하여 결정됩니다. 길게 실행되는 다중 발화 인식의 경우 start_continuous_recognition_async를 대신 사용하세요.

recognize_once_async() -> ResultFuture

반환

형식 Description

비동기 인식의 결과 값을 포함하는 미래입니다.

start_continuous_recognition

연속 인식 작업을 동기적으로 시작합니다. 사용자는 EventSignal에 연결하여 인식 결과를 받아야 합니다. 를 호출 stop_continuous_recognition_async 하여 인식을 중지합니다.

start_continuous_recognition()

start_continuous_recognition_async

연속 인식 작업을 비동기적으로 시작합니다. 사용자는 EventSignal에 연결하여 인식 결과를 받아야 합니다. 를 호출 stop_continuous_recognition_async 하여 인식을 중지합니다.

start_continuous_recognition_async() -> ResultFuture

반환

형식 Description

인식이 초기화되면 수행되는 미래입니다.

start_keyword_recognition

지정된 키워드(keyword) 모델을 사용하여 인식기를 동기적으로 구성합니다. 이 메서드를 호출한 후 인식기는 키워드(keyword) 수신 대기하여 인식을 시작합니다. stop_keyword_recognition()를 호출하여 키워드(keyword) 시작된 인식을 종료합니다.

start_keyword_recognition(model: KeywordRecognitionModel)

매개 변수

Name Description
model
필수

인식할 키워드(keyword) 지정하는 키워드(keyword) 인식 모델입니다.

start_keyword_recognition_async

지정된 키워드(keyword) 모델을 사용하여 인식기를 비동기적으로 구성합니다. 이 메서드를 호출한 후 인식기는 키워드(keyword) 수신 대기하여 인식을 시작합니다. stop_keyword_recognition_async()를 호출하여 키워드(keyword) 시작된 인식을 종료합니다.

start_keyword_recognition_async(model: KeywordRecognitionModel) -> ResultFuture

매개 변수

Name Description
model
필수

인식할 키워드(keyword) 지정하는 키워드(keyword) 인식 모델입니다.

반환

형식 Description

인식이 초기화되면 수행되는 미래입니다.

stop_continuous_recognition

지속적인 지속적인 인식 작업을 동기적으로 종료합니다.

stop_continuous_recognition()

stop_continuous_recognition_async

진행 중인 연속 인식 작업을 비동기적으로 종료합니다.

stop_continuous_recognition_async()

반환

형식 Description

인식이 중지되면 수행되는 미래입니다.

stop_keyword_recognition

키워드(keyword) 시작된 인식을 동기적으로 종료합니다.

stop_keyword_recognition()

stop_keyword_recognition_async

키워드(keyword) 시작된 인식을 비동기적으로 종료합니다.

stop_keyword_recognition_async()

반환

형식 Description

인식이 중지되면 수행되는 미래입니다.

특성

authorization_token

서비스에 연결하는 데 사용할 권한 부여 토큰입니다.

참고

호출자는 권한 부여 토큰이 유효한지 확인해야 합니다. 이전의

권한 부여 토큰이 만료되면 호출자는 이 setter를 로 호출하여 새로 고쳐야 합니다.

새 유효한 토큰입니다. 그렇지 않으면 인식기에서 인식 중에 오류가 발생합니다.

canceled

취소된 인식 결과가 포함된 이벤트에 대한 신호입니다(결과로 취소된 인식 시도 또는 직접 취소 요청 또는 전송 또는 프로토콜 실패를 나타냅니다).

이 신호에 연결된 콜백은 단일 인수로 SpeechRecognitionCanceledEventArgsinstance 를 사용하여 호출됩니다.

endpoint_id

인식에 사용되는 사용자 지정 음성 모델의 엔드포인트 ID 또는 음성 합성을 위한 사용자 지정 음성 모델입니다.

properties

이 Recognizer에 대해 정의된 속성 및 해당 값의 컬렉션입니다.

recognized

최종 인식 결과가 포함된 이벤트에 대한 신호입니다(성공적인 인식 시도를 나타낸다).

이 신호에 연결된 콜백은 인식기 유형에 따라 instance 단일 인수로 호출 SpeechRecognitionEventArgs 됩니다.

recognizing

중간 인식 결과를 포함하는 이벤트에 대한 신호입니다.

이 신호에 연결된 콜백은 instance 단일 인수로 호출 SpeechRecognitionEventArgs 됩니다.

session_started

인식 세션(작업)의 시작을 나타내는 이벤트에 대한 신호입니다.

이 신호에 연결된 콜백은 instance 단일 인수로 호출 SessionEventArgs 됩니다.

session_stopped

인식 세션(작업)의 끝을 나타내는 이벤트에 대한 신호입니다.

이 신호에 연결된 콜백은 instance 단일 인수로 호출 SessionEventArgs 됩니다.

speech_end_detected

음성의 끝을 나타내는 이벤트에 대한 신호입니다.

이 신호에 연결된 콜백은 instance 단일 인수로 호출 RecognitionEventArgs 됩니다.

speech_start_detected

음성의 시작을 나타내는 이벤트에 대한 신호입니다.

이 신호에 연결된 콜백은 instance 단일 인수로 호출 RecognitionEventArgs 됩니다.