다음을 통해 공유


ActivityHandler.OnConversationUpdateActivityAsync 메서드

정의

의 기본 동작 OnTurnAsync(ITurnContext, CancellationToken) 이 사용될 때 채널에서 대화 업데이트 작업을 수신할 때 호출됩니다. 대화 업데이트 활동은 대화에 추가되거나 제거되는 사용자에 응답할 때 유용합니다. 예를 들어 봇은 사용자에게 인사말을 하여 추가되는 사용자에게 응답할 수 있습니다. 기본적으로 이 메서드는 사용자가 추가되었거나 OnMembersRemovedAsync(IList<ChannelAccount>, ITurnContext<IConversationUpdateActivity>, CancellationToken) 사용자가 제거된 경우 를 호출 OnMembersAddedAsync(IList<ChannelAccount>, ITurnContext<IConversationUpdateActivity>, CancellationToken) 합니다. 메서드는 멤버 ID를 확인하여 봇 자체 이외의 멤버에 대한 업데이트에만 응답합니다.

protected virtual System.Threading.Tasks.Task OnConversationUpdateActivityAsync (Microsoft.Bot.Builder.ITurnContext<Microsoft.Bot.Schema.IConversationUpdateActivity> turnContext, System.Threading.CancellationToken cancellationToken);
abstract member OnConversationUpdateActivityAsync : Microsoft.Bot.Builder.ITurnContext<Microsoft.Bot.Schema.IConversationUpdateActivity> * System.Threading.CancellationToken -> System.Threading.Tasks.Task
override this.OnConversationUpdateActivityAsync : Microsoft.Bot.Builder.ITurnContext<Microsoft.Bot.Schema.IConversationUpdateActivity> * System.Threading.CancellationToken -> System.Threading.Tasks.Task
Protected Overridable Function OnConversationUpdateActivityAsync (turnContext As ITurnContext(Of IConversationUpdateActivity), cancellationToken As CancellationToken) As Task

매개 변수

turnContext
ITurnContext<IConversationUpdateActivity>

이 턴에 대한 강력한 형식의 컨텍스트 개체입니다.

cancellationToken
CancellationToken

취소의 통지를 받기 위해 다른 개체나 스레드에서 사용할 수 있는 취소 토큰입니다.

반환

실행할 대기 중인 작업을 나타내는 작업입니다.

설명

메서드가 OnTurnAsync(ITurnContext, CancellationToken) 대화 업데이트 작업을 받으면 이 메서드를 호출합니다. 대화 업데이트 활동에서 봇 이외의 멤버가 대화에 참가했음을 나타내는 경우 를 호출합니다 OnMembersAddedAsync(IList<ChannelAccount>, ITurnContext<IConversationUpdateActivity>, CancellationToken). 대화 업데이트 활동에서 봇 이외의 멤버가 대화를 떠났다는 것을 나타내면 를 호출합니다 OnMembersRemovedAsync(IList<ChannelAccount>, ITurnContext<IConversationUpdateActivity>, CancellationToken).

파생 클래스에서 이 메서드를 재정의하여 모든 대화 업데이트 작업에 적용되는 논리를 추가합니다. 멤버가 기본 클래스 OnConversationUpdateActivityAsync(ITurnContext<IConversationUpdateActivity>, CancellationToken) 메서드를 호출하기 전에 논리를 추가하거나 제거하기 전에 적용할 논리를 추가합니다. 멤버가 기본 클래스 OnConversationUpdateActivityAsync(ITurnContext<IConversationUpdateActivity>, CancellationToken) 메서드를 호출한 후 논리를 추가하거나 제거한 후에 적용할 논리를 추가합니다.

적용 대상

추가 정보