ConversationalAgentSession 클래스

정의

네임스페이스:

Windows.ApplicationModel.ConversationalAgent

디지털 도우미 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.IDisposable

Public NotInheritable Class ConversationalAgentSession
Implements IDisposable

상속

Object Platform::Object IInspectable ConversationalAgentSession

특성

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

구현

IClosable 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()	ConversationalAgentSession을 종료합니다.
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	시스템 또는 사용자가 디지털 도우미 하나 이상의 작업을 수행하는 기능을 제한하는 설정을 변경할 때 발생합니다.