Connection class
Connection은 지정된 Recognizer의 음성 서비스에 대한 연결을 관리하기 위한 프록시 클래스입니다. 기본적으로 Recognizer는 필요할 때 서비스에 대한 연결을 자율적으로 관리합니다. Connection 클래스는 사용자가 연결을 명시적으로 열거나 닫고 연결 상태 변경 내용을 구독하는 추가 메서드를 제공합니다. 연결 사용은 선택 사항이며 주로 연결 상태에 따라 애플리케이션 동작을 미세 조정해야 하는 시나리오에 사용합니다. 사용자는 필요에 따라 Open()을 호출하여 이 연결과 연결된 인식기에서 인식을 시작하기 전에 사전에 연결을 수동으로 설정할 수 있습니다. Recognizer가 서비스에 연결하거나 연결을 끊어야 하는 경우 연결을 독립적으로 설정하거나 종료합니다. 이 경우 연결/연결 끊김 이벤트를 통해 연결 상태 변경으로 연결 알림이 표시됩니다. 버전 1.2.1에 추가되었습니다.
속성
connected | 인식기가 서비스에 연결되어 있음을 나타내는 Connected 이벤트입니다. |
disconnected | 인식기가 서비스에서 연결이 끊어지는 것을 나타내는 Disconnected 이벤트입니다. |
message |
Speech Service에서 받은 모든 메시지입니다. |
message |
Speech Service로 전송된 모든 메시지입니다. |
received |
다른 최상위 인식기에서 처리되지 않는 서비스의 모든 메시지입니다. 2.0에서 제거됩니다. |
메서드
close() | 연결된 리소스를 삭제합니다. |
close |
서비스 연결을 닫습니다. 사용자는 필요에 따라 closeConnection()을 호출하여 연결된 Recognizer의 연결을 수동으로 종료할 수 있습니다. 인식 중에 closeConnection()이 호출되면 인식이 실패하고 오류와 함께 취소됩니다. |
from |
지정된 인식기에서 Connection 인스턴스를 가져옵니다. |
from |
지정된 신시사이저에서 Connection 인스턴스를 가져옵니다. |
open |
서비스에 대한 연결을 설정하기 시작합니다. 사용자는 필요에 따라 openConnection()을 호출하여 이 연결과 연결된 Recognizer에서 인식을 시작하기 전에 사전에 수동으로 연결을 설정할 수 있습니다. 인식을 시작한 후 Open()을 호출해도 아무런 효과가 없습니다. 참고: 반환 시 연결이 아직 준비되지 않았을 수 있습니다. 연결이 설정될 때 알림을 받으려면 Connected 이벤트를 구독하세요. |
send |
음성 서비스에 메시지를 보냅니다. 버전 1.13.0에 추가되었습니다. |
set |
메시지에 매개 변수를 서비스에 추가합니다. 버전 1.12.1에 추가되었습니다. |
속성 세부 정보
connected
인식기가 서비스에 연결되어 있음을 나타내는 Connected 이벤트입니다.
connected: (args: ConnectionEventArgs) => void
속성 값
(args: ConnectionEventArgs) => void
disconnected
인식기가 서비스에서 연결이 끊어지는 것을 나타내는 Disconnected 이벤트입니다.
disconnected: (args: ConnectionEventArgs) => void
속성 값
(args: ConnectionEventArgs) => void
messageReceived
Speech Service에서 받은 모든 메시지입니다.
messageReceived: (args: ConnectionMessageEventArgs) => void
속성 값
(args: ConnectionMessageEventArgs) => void
messageSent
Speech Service로 전송된 모든 메시지입니다.
messageSent: (args: ConnectionMessageEventArgs) => void
속성 값
(args: ConnectionMessageEventArgs) => void
receivedServiceMessage
다른 최상위 인식기에서 처리되지 않는 서비스의 모든 메시지입니다.
2.0에서 제거됩니다.
receivedServiceMessage: (args: ServiceEventArgs) => void
속성 값
(args: ServiceEventArgs) => void
메서드 세부 정보
close()
연결된 리소스를 삭제합니다.
function close()
closeConnection(() => void, (error: string) => void)
서비스 연결을 닫습니다. 사용자는 필요에 따라 closeConnection()을 호출하여 연결된 Recognizer의 연결을 수동으로 종료할 수 있습니다.
인식 중에 closeConnection()이 호출되면 인식이 실패하고 오류와 함께 취소됩니다.
function closeConnection(cb?: () => void, err?: (error: string) => void)
매개 변수
- cb
-
() => void
- err
-
(error: string) => void
fromRecognizer(Recognizer | ConversationTranscriber)
지정된 인식기에서 Connection 인스턴스를 가져옵니다.
static function fromRecognizer(recognizer: Recognizer | ConversationTranscriber): Connection
매개 변수
- recognizer
연결과 연결된 인식기입니다.
반환
인식기의 연결 인스턴스입니다.
fromSynthesizer(SpeechSynthesizer)
지정된 신시사이저에서 Connection 인스턴스를 가져옵니다.
static function fromSynthesizer(synthesizer: SpeechSynthesizer): Connection
매개 변수
- synthesizer
- SpeechSynthesizer
연결과 연결된 신시사이저입니다.
반환
신시사이저의 연결 인스턴스입니다.
openConnection(() => void, (error: string) => void)
서비스에 대한 연결을 설정하기 시작합니다. 사용자는 필요에 따라 openConnection()을 호출하여 이 연결과 연결된 Recognizer에서 인식을 시작하기 전에 사전에 수동으로 연결을 설정할 수 있습니다. 인식을 시작한 후 Open()을 호출해도 아무런 효과가 없습니다.
참고: 반환 시 연결이 아직 준비되지 않았을 수 있습니다. 연결이 설정될 때 알림을 받으려면 Connected 이벤트를 구독하세요.
function openConnection(cb?: () => void, err?: (error: string) => void)
매개 변수
- cb
-
() => void
- err
-
(error: string) => void
sendMessageAsync(string, string | ArrayBuffer, () => void, (error: string) => void)
음성 서비스에 메시지를 보냅니다. 버전 1.13.0에 추가되었습니다.
function sendMessageAsync(path: string, payload: string | ArrayBuffer, success?: () => void, error?: (error: string) => void)
매개 변수
- path
-
string
메시지의 WebSocket 경로
- payload
-
string | ArrayBuffer
메시지의 페이로드입니다. json 문자열 또는 ArrayBuffer입니다.
- success
-
() => void
성공을 나타내는 콜백입니다.
- error
-
(error: string) => void
오류를 나타내는 콜백입니다.
setMessageProperty(string, string, string | object)
메시지에 매개 변수를 서비스에 추가합니다. 버전 1.12.1에 추가되었습니다.
function setMessageProperty(path: string, propertyName: string, propertyValue: string | object)
매개 변수
- path
-
string
네트워크 메시지의 경로입니다.
- propertyName
-
string
속성의 이름
- propertyValue
-
string | object
속성의 값입니다. json 문자열입니다.