ConversationalAgentSession Classe

Definizione

Canale di comunicazione tra il assistente digitale e la piattaforma agente di conversazione 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
Implementazioni

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 vari altri modi, tra cui Bluetooth (quando un'espressione di parola chiave viene trasmessa tramite un visore VR o un microfono), acceleratori di tastiera di sistema (ad esempio Win+C per Cortana) e l'avvio delle interazioni vocali dall'interno dell'app (ad esempio tramite un tipo di interfaccia utente di pressione per parlare).

Proprietà

AgentState

Ottiene lo stato del assistente digitale.

IsIndicatorLightAvailable

Ottiene un valore che indica se la luce dell'indicatore è disponibile.

IsInterrupted

Ottiene un valore che indica se ConversationalAgentSession viene interrotto.

IsInterruptible

Ottiene un valore che indica se conversationalAgentSession può essere interrotto.

IsScreenAvailable

Ottiene un valore che indica se lo schermo può essere attivato.

IsUserAuthenticated

Ottiene un valore che indica se l'utente è autenticato( ad esempio, il dispositivo è bloccato).

IsVoiceActivationAvailable

Ottiene un valore che indica se il assistente digitale può essere attivato dall'input vocale.

Signal

Il segnale che ha attivato il assistente digitale, ad esempio un'espressione di 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 grafo audio.

Importante

Per evitare possibili problemi di concorrenza, è consigliabile usare invece CreateAudioDeviceInputNodeAsync .

CreateAudioDeviceInputNodeAsync(AudioGraph)

Crea in modo asincrono un nodo di input del grafo 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 invece 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 invece 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 invece GetCurrentSessionAsync .

GetMissingPrerequisites()

Ottiene i prerequisiti mancanti necessari per rendere disponibile l'attivazione vocale 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 invece GetSignalModelIdAsync .

GetSignalModelIdAsync()

Recupera in modo asincrono l'identificatore univoco del modello del segnale che ha attivato l'agente di conversazione.

GetSupportedSignalModelIds()

Recupera la raccolta di identificatori univoci del modello signal supportati dall'agente di conversazione.

Importante

Per evitare possibili problemi di concorrenza, è consigliabile usare invece GetSupportedSignalModelIdsAsync .

GetSupportedSignalModelIdsAsync()

Recupera in modo asincrono la raccolta di identificatori univoci del modello signal supportati dall'agente di conversazione.

RequestActivation(ConversationalAgentActivationKind)

Richiede che il assistente digitale venga attivato in primo piano.

RequestActivationAsync(ConversationalAgentActivationKind)

Richiede in modo asincrono che il 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 invece 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 invece RequestForegroundActivationAsync .

RequestForegroundActivationAsync()

Richiede in modo asincrono che il assistente digitale venga attivato in primo piano.

RequestInterruptible(Boolean)

Richiede in modo sincrono che conversationalAgentSession sia interrompibile se viene rilevata la parola chiave per un altro assistente digitale.

Importante

Per evitare possibili problemi di concorrenza, è consigliabile usare invece RequestInterruptibleAsync .

RequestInterruptibleAsync(Boolean)

Richiede in modo asincrono che conversationalAgentSession sia interrompibile se viene rilevata la parola chiave per un altro assistente digitale.

SetSignalModelId(UInt32)

Assegna un identificatore univoco al modello che rappresenta il segnale audio di attivazione per l'agente di conversazione.

Importante

Per evitare possibili problemi di concorrenza, è consigliabile usare invece SetSignalModelIdAsync .

SetSignalModelIdAsync(UInt32)

Assegna in modo asincrono un identificatore univoco al modello che rappresenta il segnale audio di attivazione per l'agente di conversazione.

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.

Si applica a