다음을 통해 공유


TurnContextImpl 클래스

  • java.lang.Object
    • com.microsoft.bot.builder.TurnContextImpl

구현

TurnContext java.lang.AutoCloseable

public class TurnContextImpl
implements TurnContext, java.lang.AutoCloseable

봇의 턴에 대한 컨텍스트를 제공합니다. 컨텍스트는 들어오는 작업을 처리하는 데 필요한 정보를 제공합니다. 컨텍스트 개체는 BotAdapter 의해 만들어지고 턴의 길이 동안 유지됩니다. Bot Middleware

생성자 요약

생성자 Description
TurnContextImpl(BotAdapter withAdapter, Activity withActivity)

컨텍스트 개체를 만듭니다.

메서드 요약

한정자 및 형식 메서드 및 설명
void close()

자동Closable#close입니다.

java.util.concurrent.CompletableFuture<java.lang.Void> deleteActivity(ConversationReference conversationReference)

기존 활동을 삭제합니다.

java.util.concurrent.CompletableFuture<java.lang.Void> deleteActivity(String activityId)

기존 활동을 삭제합니다.

void finalize()

#close자동 호출.

Activity getActivity()

이 턴과 연결된 활동을 가져옵니다. 또는 자동 관리 메시지를 처리할 때 null.

BotAdapter getAdapter()

이 컨텍스트 개체를 만든 봇 어댑터를 가져옵니다.

java.util.List<Activity> getBufferedReplyActivities()

'context'일 때 보낼 활동 목록을 가져옵니다.작업입니다.배달모드 == '회신 기대'.

java.lang.String getLocale()

이 컨텍스트 개체의 로캘을 가져옵니다.

boolean getResponded()

현재 턴에 대해 하나 이상의 응답을 보냈는지 여부를 나타냅니다.

TurnContextStateCollection getTurnState()

이 컨텍스트 개체에 등록된 서비스를 가져옵니다.

TurnContext onDeleteActivity(DeleteActivityHandler handler)

작업 삭제 작업에 대한 응답 처리기를 추가합니다.

TurnContext onSendActivities(SendActivitiesHandler handler)

보내기 작업 작업에 대한 응답 처리기를 추가합니다.

TurnContext onUpdateActivity(UpdateActivityHandler handler)

업데이트 작업 작업에 대한 응답 처리기를 추가합니다.

java.util.concurrent.CompletableFuture<ResourceResponse[]> sendActivities(List<Activity> activities)

들어오는 활동의 보낸 사람에게 활동 집합을 보냅니다.

java.util.concurrent.CompletableFuture<ResourceResponse> sendActivity(Activity activityToSend)

들어오는 활동의 보낸 사람에게 활동을 보냅니다.

java.util.concurrent.CompletableFuture<ResourceResponse> sendActivity(String textReplyToSend)

들어오는 활동의 보낸 사람에게 메시지 활동을 보냅니다.

java.util.concurrent.CompletableFuture<ResourceResponse> sendActivity(String textReplyToSend, String speak)

들어오는 활동의 보낸 사람에게 메시지 활동을 보냅니다.

java.util.concurrent.CompletableFuture<ResourceResponse> sendActivity(String textReplyToSend, String speak, InputHints inputHint)

들어오는 활동의 보낸 사람에게 메시지 활동을 보냅니다.

void setLocale(String withLocale)

이 컨텍스트 개체에서 로캘을 설정합니다.

java.util.concurrent.CompletableFuture<ResourceResponse> updateActivity(Activity withActivity)

기존 활동을 대체합니다.

다음에서 상속된 메서드 java.lang.Object

java.lang.Object.clone java.lang.Object.equals java.lang.Object.finalize java.lang.Object.getClass java.lang.Object.hashCode java.lang.Object.notify java.lang.Object.notifyAll java.lang.Object.toString java.lang.Object.wait java.lang.Object.wait java.lang.Object.wait

생성자 세부 정보

TurnContextImpl

public TurnContextImpl(BotAdapter withAdapter, Activity withActivity)

컨텍스트 개체를 만듭니다.

매개 변수:

withAdapter - 컨텍스트를 만드는 어댑터입니다.
withActivity - 턴에 대한 들어오는 활동입니다. 또는 자동 관리 메시지의 순서에 대한 null.

메서드 세부 정보

close

public void close()

AutoClosable#close.

Throw:

java.lang.Exception - TurnContextStateCollection인 경우

deleteActivity

public CompletableFuture deleteActivity(ConversationReference conversationReference)

기존 활동을 삭제합니다. 대화 참조의 ConversationReference#getActivityId 삭제할 대화의 활동을 나타냅니다.

매개 변수:

conversationReference - 삭제할 활동이 포함된 대화입니다.

반환:

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

deleteActivity

public CompletableFuture deleteActivity(String activityId)

기존 활동을 삭제합니다.

매개 변수:

activityId - 삭제할 활동의 ID입니다.

반환:

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

finalize

public void finalize()

#close자동 호출.

재정의:

TurnContextImpl.finalize()

getActivity

public Activity getActivity()

이 턴과 연결된 활동을 가져옵니다. 또는 자동 관리 메시지를 처리할 때 null.

getAdapter

public BotAdapter getAdapter()

이 컨텍스트 개체를 만든 봇 어댑터를 가져옵니다.

반환:

이 턴에 대한 BotAdaptor입니다.

getBufferedReplyActivities

public List getBufferedReplyActivities()

'context'일 때 보낼 활동 목록을 가져옵니다. Activity.DeliveryMode == 'expectReplies'.

반환:

활동 목록입니다.

getLocale

public String getLocale()

이 컨텍스트 개체의 로캘을 가져옵니다.

반환:

이 컨텍스트 개체의 로캘 문자열입니다.

getResponded

public boolean getResponded()

현재 턴에 대해 하나 이상의 응답을 보냈는지 여부를 나타냅니다.

반환:

현재 턴에 대해 하나 이상의 응답이 전송되었는지 true.

getTurnState

public TurnContextStateCollection getTurnState()

이 컨텍스트 개체에 등록된 서비스를 가져옵니다.

반환:

이 턴에 대한 TurnContextStateCollection입니다.

onDeleteActivity

public TurnContext onDeleteActivity(DeleteActivityHandler handler)

작업 삭제 작업에 대한 응답 처리기를 추가합니다.

매개 변수:

handler - 컨텍스트 개체에 추가할 처리기입니다.

반환:

업데이트된 컨텍스트 개체입니다.

onSendActivities

public TurnContext onSendActivities(SendActivitiesHandler handler)

보내기 작업 작업에 대한 응답 처리기를 추가합니다.

매개 변수:

handler - 컨텍스트 개체에 추가할 처리기입니다.

반환:

업데이트된 컨텍스트 개체입니다.

onUpdateActivity

public TurnContext onUpdateActivity(UpdateActivityHandler handler)

업데이트 작업 작업에 대한 응답 처리기를 추가합니다.

매개 변수:

handler - 컨텍스트 개체에 추가할 처리기입니다.

반환:

업데이트된 컨텍스트 개체입니다.

sendActivities

public CompletableFuture sendActivities(List activities)

들어오는 활동의 보낸 사람에게 활동 집합을 보냅니다.

매개 변수:

activities - 보낼 활동입니다.

반환:

실행할 큐에 대기 중인 작업을 나타내는 작업입니다. 작업이 성공적으로 전송되면 작업 결과에는 수신 채널이 활동에 할당한 ID를 포함하는 ResourceResponse 개체의 배열이 포함됩니다.

sendActivity

public CompletableFuture sendActivity(Activity activityToSend)

들어오는 활동의 보낸 사람에게 활동을 보냅니다.

매개 변수:

activityToSend - 보낼 활동입니다.

반환:

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

sendActivity

public CompletableFuture sendActivity(String textReplyToSend)

들어오는 활동의 보낸 사람에게 메시지 활동을 보냅니다.

작업이 성공적으로 전송되면 작업 결과에는 수신 채널이 작업에 할당한 ID를 포함하는 ResourceResponse 개체가 포함됩니다.

textReplyToSend콘텐츠에 적용되는 제한은 채널 설명서를 참조하세요.

매개 변수:

textReplyToSend - 보낼 메시지의 텍스트입니다.

반환:

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

sendActivity

public CompletableFuture sendActivity(String textReplyToSend, String speak)

들어오는 활동의 보낸 사람에게 메시지 활동을 보냅니다.

작업이 성공적으로 전송되면 작업 결과에는 수신 채널이 작업에 할당한 ID를 포함하는 ResourceResponse 개체가 포함됩니다.

textReplyToSend콘텐츠에 적용되는 제한은 채널 설명서를 참조하세요.

매개 변수:

textReplyToSend - 보낼 메시지의 텍스트입니다.
speak - 음성 속도, 볼륨, 발음 및 피치와 같은 봇 음성의 다양한 특성을 제어하려면 SSML(Speech Synthesis Markup Language) 형식을 지정합니다.

반환:

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

sendActivity

public CompletableFuture sendActivity(String textReplyToSend, String speak, InputHints inputHint)

들어오는 활동의 보낸 사람에게 메시지 활동을 보냅니다.

작업이 성공적으로 전송되면 작업 결과에는 수신 채널이 작업에 할당한 ID를 포함하는 ResourceResponse 개체가 포함됩니다.

textReplyToSend콘텐츠에 적용되는 제한은 채널 설명서를 참조하세요.

매개 변수:

textReplyToSend - 보낼 메시지의 텍스트입니다.
speak - 음성 속도, 볼륨, 발음 및 피치와 같은 봇 음성의 다양한 특성을 제어하려면 SSML(Speech Synthesis Markup Language) 형식을 지정합니다.
inputHint - (선택 사항) 입력 힌트입니다.

반환:

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

setLocale

public void setLocale(String withLocale)

이 컨텍스트 개체에서 로캘을 설정합니다.

매개 변수:

withLocale - 이 컨텍스트 개체의 로캘 문자열입니다.

updateActivity

public CompletableFuture updateActivity(Activity withActivity)

기존 활동을 대체합니다.

매개 변수:

withActivity - 새 대체 작업입니다.

반환:

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

적용 대상