ConversationalAgentSession 클래스
정의
중요
일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.
디지털 도우미 Windows 대화형 에이전트 플랫폼 간의 통신 채널입니다.
public ref class ConversationalAgentSession sealed : IClosable/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 524288)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class ConversationalAgentSession final : IClosable[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 524288)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public sealed class ConversationalAgentSession : System.IDisposablePublic NotInheritable Class ConversationalAgentSession
Implements IDisposable- 상속
- 특성
- 구현
Windows 요구 사항
| 디바이스 패밀리 |
Windows 10, version 1903 (10.0.18362.0에서 도입되었습니다.)
|
| API contract |
Windows.Foundation.UniversalApiContract (v8.0에서 도입되었습니다.)
|
설명
ConversationalAgentSession은 일반적으로 "Hey Cortana" 또는 "Alexa"와 같은 키워드(keyword) 발화가 인식될 때 음성 활성화를 통해 생성됩니다.
ConversationalAgentSession은 Bluetooth(헤드셋 또는 마이크를 통해 키워드(keyword) 발화가 전송되는 경우), 시스템 키보드 가속기(예: Cortana용 Win+C) 및 앱 내에서 음성 상호 작용 시작(아마도 일종의 통신 UI를 통해)을 비롯한 다양한 방법으로 만들 수 있습니다.
속성
| AgentState |
디지털 도우미 상태를 가져옵니다. |
| IsIndicatorLightAvailable |
표시등을 사용할 수 있는지 여부를 가져옵니다. |
| IsInterrupted |
ConversationalAgentSession이 중단되는지 여부를 가져옵니다. |
| IsInterruptible |
ConversationalAgentSession을 중단할 수 있는지 여부를 가져옵니다. |
| IsScreenAvailable |
화면을 켤 수 있는지 여부를 가져옵니다. |
| IsUserAuthenticated |
사용자가 인증되었는지 여부를 가져옵니다(예: 디바이스가 잠겨 있습니다). |
| IsVoiceActivationAvailable |
음성 입력으로 디지털 도우미 활성화할 수 있는지 여부를 가져옵니다. |
| Signal |
키워드(keyword) 발화, Bluetooth 전송, 시스템 키보드 가속기, 앱 내 음성 인식 또는 기타 소리(도어 슬램, 스모크 감지기)와 같은 디지털 도우미 활성화한 신호입니다. |
메서드
| Close() | |
| CreateAudioDeviceInputNode(AudioGraph) |
오디오 그래프 입력 노드를 동기적으로 만듭니다. 중요 가능한 동시성 문제를 방지하려면 대신 CreateAudioDeviceInputNodeAsync 를 사용하는 것이 좋습니다. |
| CreateAudioDeviceInputNodeAsync(AudioGraph) |
오디오 그래프 입력 노드를 비동기적으로 만듭니다. |
| Dispose() |
관리되지 않는 리소스의 확보, 해제 또는 다시 설정과 관련된 애플리케이션 정의 작업을 수행합니다. |
| GetAudioCaptureDeviceId() |
현재 음성 입력 디바이스의 디바이스 ID를 동기적으로 검색합니다. 중요 가능한 동시성 문제를 방지하려면 대신 GetAudioCaptureDeviceIdAsync 를 사용하는 것이 좋습니다. |
| GetAudioCaptureDeviceIdAsync() |
현재 음성 입력 디바이스의 디바이스 ID를 비동기적으로 검색합니다. |
| GetAudioClient() |
애플리케이션과 오디오 렌더링 디바이스 간에 오디오 스트림을 만들고 초기화하는 IAudioClient 개체를 동기적으로 검색합니다. 중요 가능한 동시성 문제를 방지하려면 대신 GetAudioClientAsync 를 사용하는 것이 좋습니다. |
| GetAudioClientAsync() |
애플리케이션과 오디오 렌더링 디바이스 간에 오디오 스트림을 만들고 초기화하는 IAudioClient 개체를 비동기적으로 검색합니다. |
| GetAudioRenderDeviceId() |
현재 음성 출력 디바이스의 디바이스 ID를 동기적으로 검색합니다. 중요 가능한 동시성 문제를 방지하려면 대신 GetAudioRenderDeviceIdAsync 를 사용하는 것이 좋습니다. |
| GetAudioRenderDeviceIdAsync() |
현재 음성 출력 디바이스의 디바이스 ID를 비동기적으로 검색합니다. |
| GetCurrentSessionAsync() |
현재 ConversationalAgentSession에 대한 참조를 비동기적으로 검색합니다. |
| GetCurrentSessionSync() |
현재 ConversationalAgentSession에 대한 참조를 동기적으로 검색합니다. 중요 가능한 동시성 문제를 방지하려면 대신 GetCurrentSessionAsync 를 사용하는 것이 좋습니다. |
| GetMissingPrerequisites() |
음성 활성화를 사용할 수 있고 제대로 작동하는 데 필요한 필수 구성 요소가 누락되었습니다. |
| GetMissingPrerequisitesAsync() |
음성 활성화를 사용할 수 있고 제대로 작동하기 위한 필수 구성 요소가 누락되었습니다. |
| GetSignalModelId() |
대화형 에이전트를 활성화한 Signal 의 고유 모델 식별자를 검색합니다. 중요 가능한 동시성 문제를 방지하려면 대신 GetSignalModelIdAsync 를 사용하는 것이 좋습니다. |
| GetSignalModelIdAsync() |
대화형 에이전트를 활성화한 Signal 의 고유 모델 식별자를 비동기적으로 검색합니다. |
| GetSupportedSignalModelIds() |
대화형 에이전트에서 지원하는 고유한 Signal 모델 식별자의 컬렉션을 검색합니다. 중요 가능한 동시성 문제를 방지하려면 대신 GetSupportedSignalModelIdsAsync를 사용하는 것이 좋습니다. |
| GetSupportedSignalModelIdsAsync() |
대화형 에이전트에서 지원하는 고유한 Signal 모델 식별자의 컬렉션을 비동기적으로 검색합니다. |
| RequestActivation(ConversationalAgentActivationKind) |
디지털 도우미 전경으로 활성화되도록 요청합니다. |
| RequestActivationAsync(ConversationalAgentActivationKind) |
디지털 도우미 포그라운드로 활성화되도록 비동기적으로 요청합니다. |
| RequestAgentStateChange(ConversationalAgentState) |
현재 ConversationalAgentSession에 대한 상태 변경을 동기적으로 요청합니다. 중요 가능한 동시성 문제를 방지하려면 RequestAgentStateChangeAsync 를 대신 사용하는 것이 좋습니다. |
| RequestAgentStateChangeAsync(ConversationalAgentState) |
현재 ConversationalAgentSession에 대한 상태 변경을 비동기적으로 요청합니다. |
| RequestForegroundActivation() |
디지털 도우미 전경으로 활성화되도록 동기적으로 요청합니다. 중요 가능한 동시성 문제를 방지하려면 RequestForegroundActivationAsync 를 대신 사용하는 것이 좋습니다. |
| RequestForegroundActivationAsync() |
디지털 도우미 포그라운드로 활성화되도록 비동기적으로 요청합니다. |
| RequestInterruptible(Boolean) |
다른 디지털 도우미 대한 키워드(keyword) 감지되면 이 ConversationalAgentSession이 중단되도록 동기적으로 요청합니다. 중요 가능한 동시성 문제를 방지하려면 RequestInterruptibleAsync 를 대신 사용하는 것이 좋습니다. |
| RequestInterruptibleAsync(Boolean) |
다른 디지털 도우미 대한 키워드(keyword) 감지되면 이 ConversationalAgentSession을 중단할 수 있도록 비동기적으로 요청합니다. |
| SetSignalModelId(UInt32) |
대화형 에이전트의 활성화 오디오 신호를 나타내는 고유 식별자를 모델에 할당합니다. 중요 가능한 동시성 문제를 방지하려면 SetSignalModelIdAsync 를 대신 사용하는 것이 좋습니다. |
| SetSignalModelIdAsync(UInt32) |
대화형 에이전트의 활성화 오디오 신호를 나타내는 고유 식별자를 모델에 비동기적으로 할당합니다. |
| SetSupportLockScreenActivation(Boolean) |
대화형 에이전트의 잠금 화면 활성화에 대한 지원을 사용하거나 사용하지 않도록 설정합니다. |
| SetSupportLockScreenActivationAsync(Boolean) |
대화형 에이전트의 잠금 화면 활성화에 대한 지원을 비동기적으로 사용하거나 사용하지 않도록 설정합니다. |
이벤트
| SessionInterrupted |
다른 디지털 도우미 활성화 신호가 감지되었을 때 발생합니다. |
| SignalDetected |
디지털 도우미 활성화하기 위한 신호가 검색되면 발생합니다. |
| SystemStateChanged |
시스템 또는 사용자가 디지털 도우미 하나 이상의 작업을 수행하는 기능을 제한하는 설정을 변경할 때 발생합니다. |