ConversationalAgentSession Classe

Definizione

Spazio dei nomi:

Windows.ApplicationModel.ConversationalAgent

Canale di comunicazione tra la assistente digitale e la piattaforma Agente conversazionale di 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

Ereditarietà

Object Platform::Object IInspectable ConversationalAgentSession

Attributi

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Implementazioni

IClosable IDisposable

Requisiti Windows

Famiglia di dispositivi	Windows 10, version 1903 (è stato introdotto in 10.0.18362.0)
API contract	Windows.Foundation.UniversalApiContract (è stato introdotto in v8.0)

Commenti

ConversationalAgentSession viene in genere creato tramite l'attivazione vocale quando viene riconosciuta un'espressione di parola chiave, ad esempio "Hey Cortana" o "Alexa".

Una ConversationalAgentSession può essere creata in diversi modi, tra cui Bluetooth (quando un'espressione di parola chiave viene trasmessa tramite un visore o un microfono), gli acceleratori di tastiera di sistema (ad esempio Win+C per Cortana) e l'avvio delle interazioni vocali dall'interno dell'app (forse tramite un tipo di interfaccia utente con pressione da conversazione).

Proprietà

AgentState	Ottiene lo stato dell'assistente digitale.
IsIndicatorLightAvailable	Ottiene se la luce dell'indicatore è disponibile.
IsInterrupted	Ottiene se conversationalAgentSession viene interrotto.
IsInterruptible	Ottiene se conversationalAgentSession può essere interrotto.
IsScreenAvailable	Ottiene se lo schermo può essere attivato.
IsUserAuthenticated	Ottiene se l'utente è autenticato( ad esempio, il dispositivo è bloccato).
IsVoiceActivationAvailable	Ottiene se l'assistente digitale può essere attivato dall'input vocale.
Signal	Segnale che ha attivato l'assistente digitale, ad esempio un'espressione parola chiave, la trasmissione Bluetooth, l'acceleratore di tastiera di sistema, il riconoscimento vocale in-app o altri suoni (slam di porta, rilevatore di fumo).

Metodi

Close()	Termina conversationalAgentSession.
CreateAudioDeviceInputNode(AudioGraph)	Crea in modo sincrono un nodo di input del grafico audio. Importante Per evitare possibili problemi di concorrenza, è consigliabile usare createAudioDeviceInputNodeAsync .
CreateAudioDeviceInputNodeAsync(AudioGraph)	Crea in modo asincrono un nodo di input del grafico audio.
Dispose()	Esegue attività definite dall'applicazione, come rilasciare o reimpostare risorse non gestite.
GetAudioCaptureDeviceId()	Recupera in modo sincrono l'ID dispositivo per il dispositivo di input vocale corrente. Importante Per evitare possibili problemi di concorrenza, è consigliabile usare invece GetAudioCaptureDeviceIdAsync .
GetAudioCaptureDeviceIdAsync()	Recupera in modo asincrono l'ID dispositivo per il dispositivo di input vocale corrente.
GetAudioClient()	Recupera in modo sincrono un oggetto IAudioClient che crea e inizializza un flusso audio tra l'applicazione e il dispositivo di rendering audio. Importante Per evitare possibili problemi di concorrenza, è consigliabile usare getAudioClientAsync .
GetAudioClientAsync()	Recupera in modo asincrono un oggetto IAudioClient che crea e inizializza un flusso audio tra l'applicazione e il dispositivo di rendering audio.
GetAudioRenderDeviceId()	Recupera in modo sincrono l'ID dispositivo per il dispositivo di output vocale corrente. Importante Per evitare possibili problemi di concorrenza, è consigliabile usare GetAudioRenderDeviceIdAsync .
GetAudioRenderDeviceIdAsync()	Recupera in modo asincrono l'ID dispositivo per il dispositivo di output vocale corrente.
GetCurrentSessionAsync()	Recupera in modo asincrono un riferimento all'oggetto ConversationalAgentSession corrente.
GetCurrentSessionSync()	Recupera in modo sincrono un riferimento all'oggetto ConversationalAgentSession corrente. Importante Per evitare possibili problemi di concorrenza, è consigliabile usare getCurrentSessionAsync .
GetMissingPrerequisites()	Ottiene i prerequisiti mancanti necessari per l'attivazione vocale per diventare disponibile e funzionare correttamente.
GetMissingPrerequisitesAsync()	Ottiene i prerequisiti mancanti per l'attivazione vocale per diventare disponibile e funzionare correttamente.
GetSignalModelId()	Recupera l'identificatore univoco del modello del segnale che ha attivato l'agente di conversazione. Importante Per evitare possibili problemi di concorrenza, è consigliabile usare getSignalModelIdAsync .
GetSignalModelIdAsync()	Recupera in modo asincrono l'identificatore univoco del modello del segnale che ha attivato l'agente conversazionale.
GetSupportedSignalModelIds()	Recupera la raccolta di identificatori di modello signal univoci supportati dall'agente di conversazione. Importante Per evitare possibili problemi di concorrenza, è consigliabile usare GetSupportedSignalModelIdsAsync .
GetSupportedSignalModelIdsAsync()	Recupera in modo asincrono la raccolta di identificatori di modello Signal univoci supportati dall'agente di conversazione.
RequestActivation(ConversationalAgentActivationKind)	Richiede che l'assistente digitale venga attivato in primo piano.
RequestActivationAsync(ConversationalAgentActivationKind)	Richiede in modo asincrono che l'assistente digitale venga attivato in primo piano.
RequestAgentStateChange(ConversationalAgentState)	Richiede in modo sincrono una modifica dello stato per ConversationalAgentSession corrente. Importante Per evitare possibili problemi di concorrenza, è consigliabile usare RequestAgentStateChangeAsync .
RequestAgentStateChangeAsync(ConversationalAgentState)	Richiede in modo asincrono una modifica dello stato per ConversationalAgentSession corrente.
RequestForegroundActivation()	Richiede in modo sincrono che il assistente digitale venga attivato in primo piano. Importante Per evitare possibili problemi di concorrenza, è consigliabile usare RequestForegroundActivationAsync .
RequestForegroundActivationAsync()	Richiede in modo asincrono che l'assistente digitale venga attivato in primo piano.
RequestInterruptible(Boolean)	Richiede in modo sincrono che questa ConversationalAgentSession sia interrotta se viene rilevata la parola chiave per un'altra assistente digitale. Importante Per evitare possibili problemi di concorrenza, è consigliabile usare RequestInterruptibleAsync .
RequestInterruptibleAsync(Boolean)	Richiede in modo asincrono che questa ConversationalAgentSession sia interrotta se viene rilevata la parola chiave per un'altra assistente digitale.
SetSignalModelId(UInt32)	Assegna un identificatore univoco al modello che rappresenta il segnale audio di attivazione per l'agente conversazionale. Importante Per evitare possibili problemi di concorrenza, è consigliabile usare SetSignalModelIdAsync .
SetSignalModelIdAsync(UInt32)	Assegna in modo asincrono un identificatore univoco al modello che rappresenta il segnale audio di attivazione per l'agente conversazionale.
SetSupportLockScreenActivation(Boolean)	Abilita o disabilita il supporto per l'attivazione della schermata di blocco dell'agente di conversazione.
SetSupportLockScreenActivationAsync(Boolean)	Abilita o disabilita in modo asincrono il supporto per l'attivazione della schermata di blocco dell'agente di conversazione.

Eventi

SessionInterrupted	Si verifica quando è stato rilevato un altro segnale di attivazione digitale assistente.
SignalDetected	Si verifica quando viene rilevato un segnale per l'attivazione di un assistente digitale.
SystemStateChanged	Si verifica quando il sistema o l'utente modifica un'impostazione che limita la capacità del assistente digitale di eseguire una o più azioni.