다음을 통해 공유


Activity 클래스

정의

활동은 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
상속
Activity
구현

설명

활동 클래스에는 개별, 더 구체적인 활동에 포함될 수 있는 모든 속성이 포함됩니다. 상위 집합 형식입니다.

생성자

Activity()

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)

Activity 클래스의 새 인스턴스를 초기화합니다.

필드

ContentType

Activity 미디어 형식 리소스를 식별하는 HTTP Content-Type 엔터티 헤더입니다.

속성

Action

contactRelationUpdate의 받는 사람이 보낸 사람의 연락처 목록에 추가되거나 제거되었는지 여부를 나타내는 문자열을 가져오거나 설정합니다.

AttachmentLayout

여러 첨부 파일에 대한 레이아웃 힌트를 가져오거나 설정합니다. 기본값: list. 가능한 값은 AttachmentLayoutTypes정의됩니다.

Attachments

활동에 대한 첨부 파일을 가져오거나 설정합니다.

CallerId

봇의 호출자를 식별하는 IRI가 포함된 문자열을 가져오거나 설정합니다. 이 필드는 통신을 통해 전송되는 것이 아니라 호출자의 ID를 어설션하는 암호화된 확인 가능한 데이터(예: 토큰)를 기반으로 봇 및 클라이언트에 의해 채워집니다.

ChannelData

채널별 콘텐츠를 가져오거나 설정합니다.

ChannelId

채널을 고유하게 식별하는 ID를 가져오거나 설정합니다. 채널에 의해 설정됩니다.

Code

대화가 종료된 이유를 나타내는 endOfConversation 작업에 대한 코드를 가져오거나 설정합니다. 가능한 값은 EndOfConversationCodes정의됩니다.

Conversation

활동이 속한 대화를 가져오거나 설정합니다.

DeliveryMode

받는 사람에게 활동의 대체 배달 경로를 알리는 배달 힌트를 가져오거나 설정합니다. 기본 배달 모드는 "기본값"입니다. 가능한 값은 DeliveryModes정의됩니다.

Entities

메시지에 언급된 엔터티를 가져오거나 설정합니다.

Expiration

활동이 "만료됨"으로 간주되어 받는 사람에게 표시되지 않아야 하는 시간을 가져오거나 설정합니다.

From

메시지의 발신자를 가져오거나 설정합니다.

HistoryDisclosed

채널의 이전 기록이 공개되는지 여부를 나타내는 값을 가져오거나 설정합니다.

Id

채널에서 활동을 고유하게 식별하는 ID를 가져오거나 설정합니다.

Importance

활동의 중요도를 가져오거나 설정합니다. 가능한 값은 ActivityImportance정의됩니다.

InputHint

메시지가 클라이언트에 전달된 후 봇이 사용자 입력을 수락, 예상 또는 무시할지 여부를 나타내는 문자열을 가져오거나 설정합니다(InputHints참조).

Label

활동에 대한 설명이 포함된 레이블을 가져오거나 설정합니다.

ListenFor

음성 및 언어 초기화 시스템에서 수신해야 하는 구 및 참조 목록을 가져오거나 설정합니다.

Locale

텍스트 필드의 내용에 대한 BCP-47 로캘 이름을 가져오거나 설정합니다.

LocalTimestamp

ISO-8601 형식으로 표현된 메시지를 현지 시간으로 보낸 날짜 및 시간을 가져오거나 설정합니다. 예를 들어 2016-09-23T13:07:49.4714686-07:00입니다.

LocalTimezone

IANA 표준 시간대 데이터베이스 형식으로 표현된 메시지의 현지 시간을 정의하는 데 사용되는 표준 시간대의 이름을 가져오거나 설정합니다. 예를 들어 미국/Los_Angeles.

MembersAdded

대화에 추가된 멤버의 컬렉션을 가져오거나 설정합니다.

MembersRemoved

대화에서 제거된 멤버의 컬렉션을 가져오거나 설정합니다.

Name

호출 또는 이벤트 활동과 연결된 작업의 이름을 가져오거나 설정합니다.

Properties

Activity 형식에 의해 정의되지 않지만 직렬화된 REST JSON 개체에 나타날 수 있는 속성을 가져오거나 설정합니다.

ReactionsAdded

대화에 추가된 반응의 컬렉션을 가져오거나 설정합니다.

ReactionsRemoved

대화에서 제거된 반응의 컬렉션을 가져오거나 설정합니다.

Recipient

메시지의 받는 사람을 가져오거나 설정합니다.

RelatesTo

다른 대화 또는 활동에 대한 ConversationReference 가져오거나 설정합니다.

ReplyToId

이 메시지가 회신인 메시지의 ID를 가져오거나 설정합니다.

SemanticAction

이 요청과 함께 제공되는 선택적 프로그래밍 작업을 가져오거나 설정합니다.

ServiceUrl

채널의 서비스 엔드포인트를 지정하는 URL을 가져오거나 설정합니다. 채널에 의해 설정됩니다.

Speak

말할 텍스트를 가져오거나 설정합니다.

SuggestedActions

작업에 대해 제안된 작업을 가져오거나 설정합니다.

Summary

채널이 카드를 렌더링할 수 없는 경우 표시할 텍스트를 가져오거나 설정합니다.

Text

메시지의 텍스트 내용을 가져오거나 설정합니다.

TextFormat

텍스트 필드의 형식을 가져오거나 설정합니다. 기본값: markdown. 가능한 값은 TextFormatTypes정의됩니다.

TextHighlights

작업에 ReplyToId 값이 포함될 때 강조 표시할 텍스트 조각의 컬렉션을 가져오거나 설정합니다.

Timestamp

ISO-8601 형식으로 표현된 메시지를 보낸 날짜 및 시간을 UTC로 가져오거나 설정합니다.

TopicName

대화의 업데이트된 토픽 이름을 가져오거나 설정합니다.

Type

활동 유형을 가져오거나 설정합니다. 가능한 값은 'message', 'contactRelationUpdate', 'conversationUpdate', 'typing', 'endOfConversation', 'event', 'invoke', 'deleteUserData', 'messageUpdate', 'messageDelete', 'installationUpdate', 'messageReaction', 'suggestion', 'trace', 'handoff'입니다.

Value

활동과 연결된 값을 가져오거나 설정합니다.

ValueType

활동 값 개체의 형식을 가져오거나 설정합니다.

메서드

ApplyConversationReference(ConversationReference, Boolean)

이 작업을 기존 ConversationReference배달 정보로 업데이트합니다.

AsCommandActivity()

이 작업을 ICommandActivity 개체로 반환합니다. 또는 null입니다( 해당 유형의 활동이 아닌 경우).

AsCommandResultActivity()

이 작업을 ICommandResultActivity 개체로 반환합니다. 또는 null입니다( 해당 유형의 활동이 아닌 경우).

AsContactRelationUpdateActivity()

이 작업을 IContactRelationUpdateActivity 개체로 반환합니다. 또는 null입니다( 해당 유형의 활동이 아닌 경우).

AsConversationUpdateActivity()

이 작업을 IConversationUpdateActivity 개체로 반환합니다. 또는 null입니다( 해당 유형의 활동이 아닌 경우).

AsEndOfConversationActivity()

이 작업을 IEndOfConversationActivity 개체로 반환합니다. 또는 null입니다( 해당 유형의 활동이 아닌 경우).

AsEventActivity()

이 작업을 IEventActivity 개체로 반환합니다. 또는 null입니다( 해당 유형의 활동이 아닌 경우).

AsHandoffActivity()

이 작업을 IHandoffActivity 개체로 반환합니다. 또는 null입니다( 해당 유형의 활동이 아닌 경우).

AsInstallationUpdateActivity()

이 작업을 IInstallationUpdateActivity 개체로 반환합니다. 또는 null입니다( 해당 유형의 활동이 아닌 경우).

AsInvokeActivity()

이 작업을 IInvokeActivity 개체로 반환합니다. 또는 null입니다( 해당 유형의 활동이 아닌 경우).

AsMessageActivity()

이 작업을 IMessageActivity 개체로 반환합니다. 또는 null입니다( 해당 유형의 활동이 아닌 경우).

AsMessageDeleteActivity()

이 작업을 IMessageDeleteActivity 개체로 반환합니다. 또는 null입니다( 해당 유형의 활동이 아닌 경우).

AsMessageReactionActivity()

이 작업을 IMessageReactionActivity 개체로 반환합니다. 또는 null입니다( 해당 유형의 활동이 아닌 경우).

AsMessageUpdateActivity()

이 작업을 IMessageUpdateActivity 개체로 반환합니다. 또는 null입니다( 해당 유형의 활동이 아닌 경우).

AsSuggestionActivity()

이 작업을 ISuggestionActivity 개체로 반환합니다. 또는 null입니다( 해당 유형의 활동이 아닌 경우).

AsTraceActivity()

이 작업을 ITraceActivity 개체로 반환합니다. 또는 null입니다( 해당 유형의 활동이 아닌 경우).

AsTypingActivity()

이 작업을 ITypingActivity 개체로 반환합니다. 또는 null입니다( 해당 유형의 활동이 아닌 경우).

CreateContactRelationUpdateActivity()

Activity 클래스의 인스턴스를 IContactRelationUpdateActivity 개체로 만듭니다.

CreateConversationUpdateActivity()

Activity 클래스의 인스턴스를 IConversationUpdateActivity 개체로 만듭니다.

CreateEndOfConversationActivity()

Activity 클래스의 인스턴스를 IEndOfConversationActivity 개체로 만듭니다.

CreateEventActivity()

Activity 클래스의 인스턴스를 IEventActivity 개체로 만듭니다.

CreateHandoffActivity()

Activity 클래스의 인스턴스를 IHandoffActivity 개체로 만듭니다.

CreateInvokeActivity()

Activity 클래스의 인스턴스를 IInvokeActivity 개체로 만듭니다.

CreateMessageActivity()

Activity 클래스의 인스턴스를 IMessageActivity 개체로 만듭니다.

CreateReply(String, String)

이 활동에 대한 응답으로 새 메시지 활동을 만듭니다.

CreateTrace(String, Object, String, String)

이 활동을 기반으로 새 추적 작업을 만듭니다.

CreateTraceActivity(String, String, Object, String)

Activity 클래스의 인스턴스를 ITraceActivity 개체로 만듭니다.

CreateTypingActivity()

Activity 클래스의 인스턴스를 ITypingActivity 개체로 만듭니다.

GetChannelData<TypeT>()

이 활동의 채널 데이터를 강력한 형식의 개체로 가져옵니다.

GetConversationReference()

이 활동을 기반으로 ConversationReference 만듭니다.

GetMentions()

이 활동의 엔터티에서 멘션을 확인합니다.

GetReplyConversationReference(ResourceResponse)

이 활동의 대화 정보 및 ResourceResponse에서 활동을 보내는 것을 기반으로 ConversationReference를 만듭니다.

HasContent()

이 활동에 콘텐츠가 있는지 여부를 나타냅니다.

IsActivity(String)

이 활동이 지정된 활동 형식인지 여부를 나타냅니다.

IsFromStreamingConnection()

활동이 Http/Https 연결을 통해 전송되었는지 또는 스트리밍을 통해 전송되었는지 확인합니다. ServiceUrl 속성을 확인하여 확인할 수 있습니다. (1) http/https를 통해 메시지를 보내는 모든 채널은 스트리밍되지 않습니다(2) 스트리밍을 통해 메시지를 보내는 채널에는 http/https로 시작되지 않는 ServiceUrl이 있습니다.

TryGetChannelData<TypeT>(TypeT)

이 활동의 채널 데이터를 강력한 형식의 개체로 가져옵니다. 반환 값은 작업이 성공했는지 여부를 나타냅니다.

확장 메서드

TeamsGetChannelId(IActivity)

현재 활동에서 팀의 채널 ID를 가져옵니다.

TeamsGetMeetingInfo(IActivity)

현재 작업에서 TeamsMeetingInfo 개체를 가져옵니다.

TeamsGetSelectedChannelId(IActivity)

현재 활동에서 팀의 선택한 채널 ID를 가져옵니다.

TeamsGetTeamInfo(IActivity)

현재 활동에서 TeamsInfo 개체를 가져옵니다.

TeamsGetTeamOnBehalfOf(IActivity)

현재 활동에서 Teams OnBehalfOf 목록을 가져옵니다.

TeamsNotifyUser(IActivity, Boolean, String)

Teams 내에서 알림을 생성하도록 현재 활동을 구성합니다.

TeamsNotifyUser(IActivity)

Teams 내에서 알림을 생성하도록 현재 활동을 구성합니다.

MentionsId(IMessageActivity, String)

텍스트 속성에 ID에 대한 언급이 있습니까?

MentionsRecipient(IMessageActivity)

Text 속성에 Recipient.Id 대한 언급이 있습니까?

RemoveMentionText(IMessageActivity, String)

Activity.Text 속성에서 지정된 ID에 대한 멘션 텍스트를 제거합니다. 예를 들어 안녕 봇에 @echoBot 메시지가 표시되면 "@echoBot"이 제거되어 "안녕하세요 봇"이 남습니다.

RemoveRecipientMention(IMessageActivity)

Text 속성에서 받는 사람 멘션 텍스트를 제거합니다. 이 함수는 활동의 텍스트를 변경하므로 주의해야 합니다.

GetLocale(IActivity)

활동의 로캘을 가져옵니다.

SetLocale(IActivity, String)

활동의 로캘을 설정합니다.

적용 대상