Partager via


Activity Classe

Définition

Une activité est le type de communication de base pour le protocole 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
Héritage
Activity
Implémente

Remarques

La classe Activity contient toutes les propriétés que des activités individuelles, plus spécifiques peuvent contenir. Il s’agit d’un type superset.

Constructeurs

Activity()

Initialise une nouvelle instance de la classe Activity.

Activity(String, String, Nullable<DateTimeOffset>, Nullable<DateTimeOffset>, String, String, ChannelAccount, ConversationAccount, ChannelAccount, String, String, IList<ChannelAccount>, IList<ChannelAccount>, IList<MessageReaction>, IList<MessageReaction>, String, Nullable<Boolean>, String, String, String, String, String, SuggestedActions, IList<Attachment>, IList<Entity>, Object, String, String, String, String, Object, String, ConversationReference, String, Nullable<DateTimeOffset>, String, String, IList<String>, IList<TextHighlight>, SemanticAction, String)

Initialise une nouvelle instance de la classe Activity.

Champs

ContentType

En-tête d’entité HTTP Content-Type qui identifie une ressource de type de média Activity.

Propriétés

Action

Obtient ou définit une chaîne indiquant si le destinataire d’un contactRelationUpdate a été ajouté ou supprimé de la liste de contacts de l’expéditeur.

AttachmentLayout

Obtient ou définit l’indicateur de disposition pour plusieurs pièces jointes. Valeur par défaut : liste. Les valeurs possibles sont définies par AttachmentLayoutTypes.

Attachments

Obtient ou définit les pièces jointes de l’activité.

CallerId

Obtient ou définit une chaîne contenant une IRI identifiant l’appelant d’un bot. Ce champ n’est pas destiné à être transmis via le réseau, mais il est plutôt rempli par des bots et des clients basés sur des données vérifiables par chiffrement qui affirment l’identité des appelants (par exemple, des jetons).

ChannelData

Obtient ou définit du contenu spécifique au canal.

ChannelId

Obtient ou définit un ID qui identifie de façon unique le canal. Défini par le canal.

Code

Obtient ou définit un code pour les activités endOfConversation qui indique pourquoi la conversation s’est terminée. Les valeurs possibles sont définies dans EndOfConversationCodes.

Conversation

Obtient ou définit la conversation à laquelle appartient l’activité.

DeliveryMode

Obtient ou définit un indicateur de remise pour signaler au destinataire d’autres chemins de remise de l’activité. Le mode de remise par défaut est « default ». Les valeurs possibles sont définies dans DeliveryModes.

Entities

Obtient ou définit les entités mentionnées dans le message.

Expiration

Obtient ou définit l’heure à laquelle l’activité doit être considérée comme « expirée » et ne doit pas être présentée au destinataire.

From

Obtient ou définit l’expéditeur du message.

HistoryDisclosed

Obtient ou définit une valeur indiquant si l’historique précédent du canal est divulgué.

Id

Obtient ou définit un ID qui identifie de manière unique l’activité sur le canal.

Importance

Obtient ou définit l’importance de l’activité. Les valeurs possibles sont définies dans ActivityImportance.

InputHint

Obtient ou définit une chaîne indiquant si votre bot accepte, attend ou ignore l’entrée de l’utilisateur une fois le message remis au client (voir InputHints.

Label

Obtient ou définit une étiquette descriptive pour l’activité.

ListenFor

Obtient ou définit la liste des expressions et des références que les systèmes de reconnaissance vocale et d’amorçage de langage doivent écouter.

Locale

Obtient ou définit un nom de paramètres régionaux BCP-47 pour le contenu du champ de texte.

LocalTimestamp

Obtient ou définit la date et l’heure à laquelle le message a été envoyé, en heure locale, exprimé au format ISO-8601. Par exemple, 2016-09-23T13:07:49.4714686-07:00.

LocalTimezone

Obtient ou définit le nom du fuseau horaire utilisé pour définir l’heure locale du message, exprimé au format de base de données de fuseau horaire IANA. Par exemple, l’Amérique/Los_Angeles.

MembersAdded

Obtient ou définit la collection de membres ajoutés à la conversation.

MembersRemoved

Obtient ou définit la collection de membres supprimés de la conversation.

Name

Obtient ou définit le nom de l’opération associée à une activité d’appel ou d’événement.

Properties

Obtient ou définit les propriétés qui ne sont pas définies par le type Activity, mais qui peuvent apparaître dans l’objet JSON REST sérialisé.

ReactionsAdded

Obtient ou définit la collection de réactions ajoutées à la conversation.

ReactionsRemoved

Obtient ou définit la collection de réactions supprimées de la conversation.

Recipient

Obtient ou définit le destinataire du message.

RelatesTo

Obtient ou définit une ConversationReference à une autre conversation ou activité.

ReplyToId

Obtient ou définit l’ID du message auquel ce message est une réponse.

SemanticAction

Obtient ou définit une action programmatique facultative qui accompagne cette requête.

ServiceUrl

Obtient ou définit l’URL qui spécifie le point de terminaison de service du canal. Défini par le canal.

Speak

Obtient ou définit le texte à parler.

SuggestedActions

Obtient ou définit les actions suggérées pour l’activité.

Summary

Obtient ou définit le texte à afficher si le canal ne peut pas afficher les cartes.

Text

Obtient ou définit le contenu texte du message.

TextFormat

Obtient ou définit le format des champs de texte. Valeur par défaut : markdown. Les valeurs possibles sont définies par TextFormatTypes.

TextHighlights

Obtient ou définit la collection de fragments de texte à mettre en surbrillance lorsque l’activité contient une valeur ReplyToId.

Timestamp

Obtient ou définit la date et l’heure à laquelle le message a été envoyé, au format UTC, exprimé au format ISO-8601.

TopicName

Obtient ou définit le nom de rubrique mis à jour de la conversation.

Type

Obtient ou définit le type d’activité. Les valeurs possibles sont les suivantes : « message », « contactRelationUpdate », « conversationUpdate », « typing », « endOfConversation », « event », « invoke », « deleteUserData », « messageUpdate », « messageDelete », « installationUpdate », « messageReaction », « suggestion », « trace », « handoff ».

Value

Obtient ou définit une valeur associée à l’activité.

ValueType

Obtient ou définit le type de l’objet valeur de l’activité.

Méthodes

ApplyConversationReference(ConversationReference, Boolean)

Met à jour cette activité avec les informations de remise d’un ConversationReferenceexistant.

AsCommandActivity()

Retourne cette activité en tant qu’objet ICommandActivity ; ou null, si ce n’est pas ce type d’activité.

AsCommandResultActivity()

Retourne cette activité en tant qu’objet ICommandResultActivity ; ou null, si ce n’est pas ce type d’activité.

AsContactRelationUpdateActivity()

Retourne cette activité en tant qu’objet IContactRelationUpdateActivity ; ou null, si ce n’est pas ce type d’activité.

AsConversationUpdateActivity()

Retourne cette activité en tant qu’objet IConversationUpdateActivity ; ou null, si ce n’est pas ce type d’activité.

AsEndOfConversationActivity()

Retourne cette activité en tant qu’objet IEndOfConversationActivity ; ou null, si ce n’est pas ce type d’activité.

AsEventActivity()

Retourne cette activité en tant qu’objet IEventActivity ; ou null, si ce n’est pas ce type d’activité.

AsHandoffActivity()

Retourne cette activité en tant qu’objet IHandoffActivity ; ou null, si ce n’est pas ce type d’activité.

AsInstallationUpdateActivity()

Retourne cette activité en tant qu’objet IInstallationUpdateActivity ; ou null, si ce n’est pas ce type d’activité.

AsInvokeActivity()

Retourne cette activité en tant qu’objet IInvokeActivity ; ou null, si ce n’est pas ce type d’activité.

AsMessageActivity()

Retourne cette activité en tant qu’objet IMessageActivity ; ou null, si ce n’est pas ce type d’activité.

AsMessageDeleteActivity()

Retourne cette activité en tant qu’objet IMessageDeleteActivity ; ou null, si ce n’est pas ce type d’activité.

AsMessageReactionActivity()

Retourne cette activité en tant qu’objet IMessageReactionActivity ; ou null, si ce n’est pas ce type d’activité.

AsMessageUpdateActivity()

Retourne cette activité en tant qu’objet IMessageUpdateActivity ; ou null, si ce n’est pas ce type d’activité.

AsSuggestionActivity()

Retourne cette activité en tant qu’objet ISuggestionActivity ; ou null, si ce n’est pas ce type d’activité.

AsTraceActivity()

Retourne cette activité en tant qu’objet ITraceActivity ; ou null, si ce n’est pas ce type d’activité.

AsTypingActivity()

Retourne cette activité en tant qu’objet ITypingActivity ; ou null, si ce n’est pas ce type d’activité.

CreateContactRelationUpdateActivity()

Crée une instance de la classe Activity en tant qu’objet IContactRelationUpdateActivity.

CreateConversationUpdateActivity()

Crée une instance de la classe Activity en tant qu’objet IConversationUpdateActivity.

CreateEndOfConversationActivity()

Crée une instance de la classe Activity en tant qu’objet IEndOfConversationActivity.

CreateEventActivity()

Crée une instance de la classe Activity en tant qu’objet IEventActivity.

CreateHandoffActivity()

Crée une instance de la classe Activity en tant qu’objet IHandoffActivity.

CreateInvokeActivity()

Crée une instance de la classe Activity en tant qu’objet IInvokeActivity.

CreateMessageActivity()

Crée une instance de la classe Activity en tant qu’objet IMessageActivity.

CreateReply(String, String)

Crée une activité de message en tant que réponse à cette activité.

CreateTrace(String, Object, String, String)

Crée une activité de suivi basée sur cette activité.

CreateTraceActivity(String, String, Object, String)

Crée une instance de la classe Activity en tant qu’objet ITraceActivity.

CreateTypingActivity()

Crée une instance de la classe Activity en tant qu’objet ITypingActivity.

GetChannelData<TypeT>()

Obtient les données de canal pour cette activité en tant qu’objet fortement typé.

GetConversationReference()

Crée une ConversationReference basée sur cette activité.

GetMentions()

Résout les mentions des entités de cette activité.

GetReplyConversationReference(ResourceResponse)

Créez une conversationReference basée sur les informations de conversation de cette activité et resourceResponse à partir de l’envoi d’une activité.

HasContent()

Indique si cette activité a du contenu.

IsActivity(String)

Indique si cette activité est d’un type d’activité spécifié.

IsFromStreamingConnection()

Déterminez si l’activité a été envoyée par le biais d’une connexion Http/Https ou de streaming, cela peut être déterminé en examinant la propriété ServiceUrl : (1) Tous les canaux qui envoient des messages via http/https ne sont pas en streaming (2) Les canaux qui envoient des messages via la diffusion en continu ont un ServiceUrl qui ne commence pas par http/https.

TryGetChannelData<TypeT>(TypeT)

Obtient les données de canal pour cette activité en tant qu’objet fortement typé. Une valeur de retour indique si l’opération a réussi.

Méthodes d’extension

TeamsGetChannelId(IActivity)

Obtient l’ID de canal de l’équipe à partir de l’activité actuelle.

TeamsGetMeetingInfo(IActivity)

Obtient l’objet TeamsMeetingInfo de l’activité actuelle.

TeamsGetSelectedChannelId(IActivity)

Obtient l’ID de canal sélectionné de l’équipe à partir de l’activité actuelle.

TeamsGetTeamInfo(IActivity)

Obtient l’objet TeamsInfo de l’activité actuelle.

TeamsGetTeamOnBehalfOf(IActivity)

Obtient la liste Teams OnBehalfOf de l’activité actuelle.

TeamsNotifyUser(IActivity, Boolean, String)

Configure l’activité actuelle pour générer une notification dans Teams.

TeamsNotifyUser(IActivity)

Configure l’activité actuelle pour générer une notification dans Teams.

MentionsId(IMessageActivity, String)

Existe-t-il une mention d’ID dans la propriété Text.

MentionsRecipient(IMessageActivity)

Existe-t-il une mention de Recipient.Id dans la propriété Text.

RemoveMentionText(IMessageActivity, String)

Supprimez tout texte de mention pour l’ID donné de la propriété Activity.Text. Par exemple, étant donné le message @echoBot Hi Bot, cela supprime « @echoBot », en laissant « Hi Bot ».

RemoveRecipientMention(IMessageActivity)

Supprimez le texte de mention du destinataire de la propriété Text. Utilisez la prudence, car cette fonction modifie le texte de l’activité.

GetLocale(IActivity)

Obtient les paramètres régionaux de l’activité.

SetLocale(IActivity, String)

Définit les paramètres régionaux de l’activité.

S’applique à