Activity 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.
Un'attività è il tipo di comunicazione di base per il protocollo Bot Framework 3.0.
public class Activity : Microsoft.Bot.Schema.ICommandActivity, Microsoft.Bot.Schema.ICommandResultActivity, Microsoft.Bot.Schema.IContactRelationUpdateActivity, Microsoft.Bot.Schema.IConversationUpdateActivity, Microsoft.Bot.Schema.IEndOfConversationActivity, Microsoft.Bot.Schema.IEventActivity, Microsoft.Bot.Schema.IHandoffActivity, Microsoft.Bot.Schema.IInstallationUpdateActivity, Microsoft.Bot.Schema.IInvokeActivity, Microsoft.Bot.Schema.IMessageDeleteActivity, Microsoft.Bot.Schema.IMessageReactionActivity, Microsoft.Bot.Schema.IMessageUpdateActivity, Microsoft.Bot.Schema.ISuggestionActivity, Microsoft.Bot.Schema.ITraceActivity, Microsoft.Bot.Schema.ITypingActivity
type Activity = class
interface IActivity
interface IConversationUpdateActivity
interface IContactRelationUpdateActivity
interface IInstallationUpdateActivity
interface IMessageActivity
interface IMessageUpdateActivity
interface IMessageDeleteActivity
interface IMessageReactionActivity
interface ISuggestionActivity
interface ITypingActivity
interface IEndOfConversationActivity
interface IEventActivity
interface IInvokeActivity
interface ITraceActivity
interface IHandoffActivity
interface ICommandActivity
interface ICommandResultActivity
Public Class Activity
Implements ICommandActivity, ICommandResultActivity, IContactRelationUpdateActivity, IConversationUpdateActivity, IEndOfConversationActivity, IEventActivity, IHandoffActivity, IInstallationUpdateActivity, IInvokeActivity, IMessageDeleteActivity, IMessageReactionActivity, IMessageUpdateActivity, ISuggestionActivity, ITraceActivity, ITypingActivity
- Ereditarietà
-
Activity
- Implementazioni
-
IActivity ICommandActivity ICommandResultActivity IContactRelationUpdateActivity IConversationUpdateActivity IEndOfConversationActivity IEventActivity IHandoffActivity IInstallationUpdateActivity IInvokeActivity IMessageActivity IMessageDeleteActivity IMessageReactionActivity IMessageUpdateActivity ISuggestionActivity ITraceActivity ITypingActivity
Commenti
La classe Activity contiene tutte le proprietà che possono contenere singole attività più specifiche. È un tipo di superset.
Costruttori
Campi
ContentType |
Intestazione dell'entità http |
Proprietà
Action |
Ottiene o imposta una stringa che indica se il destinatario di un oggetto contactRelationUpdate è stato aggiunto o rimosso dall'elenco contatti del mittente. |
AttachmentLayout |
Ottiene o imposta l'hint di layout per più allegati. Impostazione predefinita: elenco. I valori possibili sono definiti da AttachmentLayoutTypes. |
Attachments |
Ottiene o imposta gli allegati per l'attività. |
CallerId |
Ottiene o imposta una stringa contenente un IRI che identifica il chiamante di un bot. Questo campo non deve essere trasmesso in rete, ma viene popolato da bot e client basati su dati verificabili crittograficamente che asserisce l'identità dei chiamanti (ad esempio token). |
ChannelData |
Ottiene o imposta contenuto specifico del canale. |
ChannelId |
Ottiene o imposta un ID che identifica in modo univoco il canale. Impostato dal canale. |
Code |
Ottiene o imposta un codice per le attività endOfConversation che indica il motivo per cui la conversazione è terminata. I valori possibili sono definiti in EndOfConversationCodes. |
Conversation |
Ottiene o imposta la conversazione a cui appartiene l'attività. |
DeliveryMode |
Ottiene o imposta un hint di recapito per segnalare al destinatario percorsi di recapito alternativi per l'attività. La modalità di recapito predefinita è "default". I valori possibili sono definiti in DeliveryModes. |
Entities |
Ottiene o imposta le entità menzionate nel messaggio. |
Expiration |
Ottiene o imposta l'ora in cui l'attività deve essere considerata "scaduta" e non deve essere presentata al destinatario. |
From |
Ottiene o imposta il mittente del messaggio. |
HistoryDisclosed |
Ottiene o imposta un valore che indica se la cronologia precedente del canale viene divulgata. |
Id |
Ottiene o imposta un ID che identifica in modo univoco l'attività nel canale. |
Importance |
Ottiene o imposta l'importanza dell'attività. I valori possibili sono definiti in ActivityImportance. |
InputHint |
Ottiene o imposta una stringa che indica se il bot accetta, prevede o ignora l'input dell'utente dopo che il messaggio viene recapitato al client (vedere InputHints. |
Label |
Ottiene o imposta un'etichetta descrittiva per l'attività. |
ListenFor |
Ottiene o imposta un elenco di frasi e riferimenti per cui i sistemi di riconoscimento vocale e priming della lingua devono essere in ascolto. |
Locale |
Ottiene o imposta un nome delle impostazioni locali BCP-47 per il contenuto del campo di testo. |
LocalTimestamp |
Ottiene o imposta la data e l'ora in cui il messaggio è stato inviato, nell'ora locale, espresso in formato ISO-8601. Ad esempio, 2016-09-23T13:07:49.4714686-07:00. |
LocalTimezone |
Ottiene o imposta il nome del fuso orario utilizzato per definire l'ora locale per il messaggio, espresso in formato di database del fuso orario IANA. Ad esempio, America/Los_Angeles. |
MembersAdded |
Ottiene o imposta la raccolta di membri aggiunti alla conversazione. |
MembersRemoved |
Ottiene o imposta la raccolta di membri rimossi dalla conversazione. |
Name |
Ottiene o imposta il nome dell'operazione associata a un'attività invoke o evento. |
Properties |
Ottiene o imposta proprietà che non sono definite diversamente dal tipo di Activity, ma che potrebbero essere visualizzate nell'oggetto JSON REST serializzato. |
ReactionsAdded |
Ottiene o imposta la raccolta di reazioni aggiunte alla conversazione. |
ReactionsRemoved |
Ottiene o imposta la raccolta di reazioni rimosse dalla conversazione. |
Recipient |
Ottiene o imposta il destinatario del messaggio. |
RelatesTo |
Ottiene o imposta un ConversationReference su un'altra conversazione o attività. |
ReplyToId |
Ottiene o imposta l'ID del messaggio a cui il messaggio è una risposta. |
SemanticAction |
Ottiene o imposta un'azione a livello di codice facoltativa associata a questa richiesta. |
ServiceUrl |
Ottiene o imposta l'URL che specifica l'endpoint del servizio del canale. Impostato dal canale. |
Speak |
Ottiene o imposta il testo da pronunciare. |
SuggestedActions |
Ottiene o imposta le azioni suggerite per l'attività. |
Summary |
Ottiene o imposta il testo da visualizzare se il canale non è in grado di eseguire il rendering delle schede. |
Text |
Ottiene o imposta il contenuto di testo del messaggio. |
TextFormat |
Ottiene o imposta il formato dei campi di testo. Impostazione predefinita: markdown. I valori possibili sono definiti da TextFormatTypes. |
TextHighlights |
Ottiene o imposta la raccolta di frammenti di testo da evidenziare quando l'attività contiene un valore ReplyToId. |
Timestamp |
Ottiene o imposta la data e l'ora in cui il messaggio è stato inviato, in formato UTC, espresso in formato ISO-8601. |
TopicName |
Ottiene o imposta il nome dell'argomento aggiornato della conversazione. |
Type |
Ottiene o imposta il tipo di attività. I valori possibili includono: 'message', 'contactRelationUpdate', 'conversationUpdate', 'typing', 'endOfConversation', 'event', 'invoke', 'deleteUserData', 'messageUpdate', 'messageDelete', 'installationUpdate', 'messageReaction', 'suggestion', 'trace', 'handoff'. |
Value |
Ottiene o imposta un valore associato all'attività. |
ValueType |
Ottiene o imposta il tipo dell'oggetto valore dell'attività. |
Metodi
ApplyConversationReference(ConversationReference, Boolean) |
Aggiorna questa attività con le informazioni di recapito da un ConversationReferenceesistente. |
AsCommandActivity() |
Restituisce questa attività come oggetto ICommandActivity; o Null, se questo non è il tipo di attività. |
AsCommandResultActivity() |
Restituisce questa attività come oggetto ICommandResultActivity; o Null, se questo non è il tipo di attività. |
AsContactRelationUpdateActivity() |
Restituisce questa attività come oggetto IContactRelationUpdateActivity; o Null, se questo non è il tipo di attività. |
AsConversationUpdateActivity() |
Restituisce questa attività come oggetto IConversationUpdateActivity; o Null, se questo non è il tipo di attività. |
AsEndOfConversationActivity() |
Restituisce questa attività come oggetto IEndOfConversationActivity; o Null, se questo non è il tipo di attività. |
AsEventActivity() |
Restituisce questa attività come oggetto IEventActivity; o Null, se questo non è il tipo di attività. |
AsHandoffActivity() |
Restituisce questa attività come oggetto IHandoffActivity; o Null, se questo non è il tipo di attività. |
AsInstallationUpdateActivity() |
Restituisce questa attività come oggetto IInstallationUpdateActivity; o Null, se questo non è il tipo di attività. |
AsInvokeActivity() |
Restituisce questa attività come oggetto IInvokeActivity; o Null, se questo non è il tipo di attività. |
AsMessageActivity() |
Restituisce questa attività come oggetto IMessageActivity; o Null, se questo non è il tipo di attività. |
AsMessageDeleteActivity() |
Restituisce questa attività come oggetto IMessageDeleteActivity; o Null, se questo non è il tipo di attività. |
AsMessageReactionActivity() |
Restituisce questa attività come oggetto IMessageReactionActivity; o Null, se questo non è il tipo di attività. |
AsMessageUpdateActivity() |
Restituisce questa attività come oggetto IMessageUpdateActivity; o Null, se questo non è il tipo di attività. |
AsSuggestionActivity() |
Restituisce questa attività come oggetto ISuggestionActivity; o Null, se questo non è il tipo di attività. |
AsTraceActivity() |
Restituisce questa attività come oggetto ITraceActivity; o Null, se questo non è il tipo di attività. |
AsTypingActivity() |
Restituisce questa attività come oggetto ITypingActivity; o Null, se questo non è il tipo di attività. |
CreateContactRelationUpdateActivity() |
Crea un'istanza della classe Activity come oggetto IContactRelationUpdateActivity. |
CreateConversationUpdateActivity() |
Crea un'istanza della classe Activity come oggetto IConversationUpdateActivity. |
CreateEndOfConversationActivity() |
Crea un'istanza della classe Activity come oggetto IEndOfConversationActivity. |
CreateEventActivity() |
Crea un'istanza della classe Activity come oggetto IEventActivity. |
CreateHandoffActivity() |
Crea un'istanza della classe Activity come oggetto IHandoffActivity. |
CreateInvokeActivity() |
Crea un'istanza della classe Activity come oggetto IInvokeActivity. |
CreateMessageActivity() |
Crea un'istanza della classe Activity come oggetto IMessageActivity. |
CreateReply(String, String) |
Crea una nuova attività di messaggio come risposta a questa attività. |
CreateTrace(String, Object, String, String) |
Crea una nuova attività di traccia basata su questa attività. |
CreateTraceActivity(String, String, Object, String) |
Crea un'istanza della classe Activity come oggetto ITraceActivity. |
CreateTypingActivity() |
Crea un'istanza della classe Activity come oggetto ITypingActivity. |
GetChannelData<TypeT>() |
Ottiene i dati del canale per questa attività come oggetto fortemente tipizzato. |
GetConversationReference() |
Crea un ConversationReference basato su questa attività. |
GetMentions() |
Risolve le menzioni dalle entità di questa attività. |
GetReplyConversationReference(ResourceResponse) |
Creare un oggetto ConversationReference in base alle informazioni di conversazione di questa attività e a ResourceResponse dall'invio di un'attività. |
HasContent() |
Indica se l'attività ha contenuto. |
IsActivity(String) |
Indica se questa attività è di un tipo di attività specificato. |
IsFromStreamingConnection() |
Determinare se l'attività è stata inviata tramite una connessione Http/Https o Streaming Questo può essere determinato esaminando la proprietà ServiceUrl: (1) Tutti i canali che inviano messaggi tramite http/https non sono canali di streaming (2) che inviano messaggi tramite streaming hanno un ServiceUrl che non inizia con http/https. |
TryGetChannelData<TypeT>(TypeT) |
Ottiene i dati del canale per questa attività come oggetto fortemente tipizzato. Un valore restituito indica se l'operazione è riuscita. |
Metodi di estensione
TeamsGetChannelId(IActivity) |
Ottiene l'ID del canale del team dall'attività corrente. |
TeamsGetMeetingInfo(IActivity) |
Ottiene l'oggetto TeamsMeetingInfo dall'attività corrente. |
TeamsGetSelectedChannelId(IActivity) |
Ottiene l'ID canale selezionato del team dall'attività corrente. |
TeamsGetTeamInfo(IActivity) |
Ottiene l'oggetto TeamsInfo dall'attività corrente. |
TeamsGetTeamOnBehalfOf(IActivity) |
Ottiene l'elenco OnBehalfOf di Teams dall'attività corrente. |
TeamsNotifyUser(IActivity, Boolean, String) |
Configura l'attività corrente per generare una notifica all'interno di Teams. |
TeamsNotifyUser(IActivity) |
Configura l'attività corrente per generare una notifica all'interno di Teams. |
MentionsId(IMessageActivity, String) |
Nella proprietà Text è presente una menzione di ID. |
MentionsRecipient(IMessageActivity) |
Nella proprietà Text è presente una menzione di Recipient.Id. |
RemoveMentionText(IMessageActivity, String) |
Rimuovere qualsiasi testo di menzione per l'ID specificato dalla proprietà Activity.Text. Ad esempio, dato il messaggio @echoBot Hi Bot, verrà rimosso "@echoBot", lasciando "Hi Bot". |
RemoveRecipientMention(IMessageActivity) |
Rimuovere il testo della menzione del destinatario dalla proprietà Text. Prestare attenzione perché questa funzione modifica il testo nell'attività. |
GetLocale(IActivity) |
Ottiene le impostazioni locali per l'attività. |
SetLocale(IActivity, String) |
Imposta le impostazioni locali per l'attività. |