Listen 메서드

  • 아티클

[Microsoft 에이전트는 Windows 7을 기준으로 더 이상 사용되지 않으며 이후 버전의 Windows에서는 사용할 수 없습니다.]

Description

시간 제한 기간 동안 수신 대기 모드(음성 인식)를 켭니다.

Syntax

에이전트. 문자 ("CharacterID"). Listen** 상태

부분 설명
상태 필수 사항입니다. 수신 모드를 켜거나 끌지 여부를 결정하는 부울 값입니다. 사실 수신 대기 모드를 켭니다.
False 수신 모드를 끕니다.

설명

이 메서드를 True 로 설정하면 고정된 기간(10초)동안 수신 대기 모드(음성 인식 켜기)가 가능합니다. 제한 시간 값을 설정할 수는 없지만 제한 시간이 만료되기 전에 수신 대기 모드를 끌 수 있습니다. 사용자(또는 다른 클라이언트)가 수신 대기 모드를 설정했고 제한 시간이 만료되기 전에 이 속성을 True 로 설정하려고 하면 메서드가 성공하고 시간 초과를 다시 설정합니다. 그러나 사용자가 수신 대기 키를 누르고 있기 때문에 수신 모드가 켜진 경우 메서드는 성공하지만 시간 제한은 무시되고 수신 대기 모드는 사용자의 수신 대기 키 조작에 따라 종료됩니다.

이 메서드는 입력 활성 클라이언트에서 호출하고 음성 서비스가 시작된 경우에만 성공합니다. 음성 서비스가 시작되었는지 확인하려면 SRModeID를 쿼리하거나 설정하거나 Listen을 호출하기 전에 명령에 대한 음성 설정을 설정하면 메서드가 실패합니다. 이 메서드의 성공을 검색하려면 함수로 호출하고 메서드의 성공 여부를 나타내는 부울 값을 반환합니다.

   If Genie.Listen(True) Then
      'The method succeeded

   Else
      ' The method failed

   End If

사용자가 수신 대기 키를 누르고 False로 수신 대기를 설정하려고 하면 메서드도 실패 합니다. 그러나 사용자가 수신 대기 키를 해제하고 수신 모드가 시간 초과되지 않은 경우 성공합니다.

문자의 LanguageID 설정과 일치하는 호환 가능한 음성 엔진이 없거나, 사용자가 Microsoft 에이전트 속성 시트를 사용하여 음성 입력을 사용하지 않도록 설정했거나, 오디오 디바이스가 사용 중인 경우에도 수신 대기가 실패합니다.

이 메서드를 True로 설정하면 서버가 ListenStart 이벤트를 트리거합니다. 수신 모드 제한 시간이 완료되거나 False로 수신 대기를 설정할 때 서버에서 ListenComplete를 보냅니다.

이 메서드는 수신 대기 키를 누를 때 서버와 마찬가지로 자동으로 중지 를 호출하고 수신 대기 상태 애니메이션을 재생하지 않습니다. 이렇게 하면 중지를 호출하고 고유한 적절한 애니메이션을 재생하여 ListenStart 애니메이션을 사용하여 현재 애니메이션을 중단할지 여부를 결정할 수 있습니다. 그러나 서버는 중지 를 호출하고 사용자 발화가 감지되면 청각 상태 애니메이션을 재생합니다.

참고 항목

LanguageID 속성, ListenComplete 이벤트, ListenStart 이벤트