ConversationalAgentSession Classe
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
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.IDisposablePublic NotInheritable Class ConversationalAgentSession
Implements IDisposable- Ereditarietà
- 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. |