MessageFactory 클래스

  • 참조
패키지:
com.microsoft.bot.builder
Maven 아티팩트:
com.microsoft.bot:bot-builder:4.14.3
  • java.lang.Object
    • com.microsoft.bot.builder.MessageFactory

public final class MessageFactory

봇이 반환할 수 있는 다양한 메시지 유형에 대한 유틸리티 메서드를 포함합니다.

메시지를 만들고 보냅니다. Activity message = MessageFactory.text("Hello World"); conext.sendActivity(message);

다음은 일반적으로 메시지 작업에 적용됩니다. 보낼 메시지 텍스트의 내용에 적용되는 제한 사항은 채널 설명서를 참조하세요.

음성, 속도, 볼륨, 발음 및 피치와 같은 봇 음성의 다양한 특성을 제어하려면 SSML(Speech Synthesis Markup Language) 형식으로 말하는 테스트를 지정합니다.

채널은 각 카드 작업이 사용자 환경에서 어떻게 매니페스트되는지 결정합니다. 대부분의 경우 카드를 클릭할 수 있습니다. 다른 경우에는 음성 입력으로 선택할 수 있습니다. 채널이 대화형 활성화 환경(예: SMS를 통해 상호 작용하는 경우)을 제공하지 않는 경우 채널은 활성화를 지원하지 않을 수 있습니다. 작업을 렌더링하는 방법에 대한 결정은 이 문서의 다른 위치(예: 카드 형식 내 또는 제안된 작업 정의 내)의 규범적 요구 사항에 의해 제어됩니다.

메서드 요약

한정자 및 형식 메서드 및 설명
static Activity attachment(Attachment attachment)

첨부 파일이 포함된 메시지 활동을 반환합니다.
static Activity attachment(Attachment attachment, String text)

첨부 파일이 포함된 메시지 활동을 반환합니다.
static Activity attachment(Attachment attachment, String text, String ssml, InputHints inputHint)

첨부 파일이 포함된 메시지 활동을 반환합니다.
static Activity attachment(List<Attachment> attachments)

첨부 파일이 포함된 메시지 활동을 반환합니다.
static Activity attachment(List<Attachment> attachments, String text, String ssml, InputHints inputHint)

첨부 파일이 포함된 메시지 활동을 반환합니다.
static Activity carousel(List<Attachment> attachments, String text)

목록에 첨부 파일 컬렉션이 포함된 메시지 활동을 반환합니다.
static Activity carousel(List<Attachment> attachments, String text, String ssml, InputHints inputHint)

목록에 첨부 파일 컬렉션이 포함된 메시지 활동을 반환합니다.
static Activity contentUrl(String url, String contentType)

단일 이미지 또는 비디오가 포함된 메시지 활동을 반환합니다.
static Activity contentUrl(String url, String contentType, String name, String text, String ssml, InputHints inputHint)

단일 이미지 또는 비디오가 포함된 메시지 활동을 반환합니다.
static Activity suggestedActions(List<String> actions, String text)

제안된 작업 및 선택적 텍스트 집합이 포함된 메시지를 반환합니다.
static Activity suggestedActions(List<String> actions, String text, String ssml, InputHints inputHint)

제안된 작업 및 선택적 텍스트 집합이 포함된 메시지를 반환합니다.
static Activity suggestedCardActions(List<CardAction> actions, String text)

제안된 작업 및 선택적 텍스트 집합이 포함된 메시지를 반환합니다.
static Activity suggestedCardActions(List<CardAction> actions, String text, String ssml, InputHints inputHint)

제안된 작업 및 선택적 텍스트 집합이 포함된 메시지를 반환합니다.
static Activity text(String text)

간단한 문자 메시지를 반환합니다.
static Activity text(String text, String ssml, InputHints inputHint)

간단한 문자 메시지를 반환합니다.

다음에서 상속된 메서드 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

메서드 세부 정보

attachment

public static Activity attachment(Attachment attachment)

첨부 파일이 포함된 메시지 활동을 반환합니다.

매개 변수:

attachment - 메시지에 포함할 첨부 파일입니다.

반환:

첨부 파일이 포함된 메시지 활동입니다.

attachment

public static Activity attachment(Attachment attachment, String text)

첨부 파일이 포함된 메시지 활동을 반환합니다.

매개 변수:

attachment - 메시지에 포함할 첨부 파일입니다.
text - 선택 사항으로 보낼 메시지의 텍스트입니다.

반환:

첨부 파일이 포함된 메시지 활동입니다.

attachment

public static Activity attachment(Attachment attachment, String text, String ssml, InputHints inputHint)

첨부 파일이 포함된 메시지 활동을 반환합니다.

매개 변수:

attachment - 메시지에 포함할 첨부 파일입니다.
text - 선택 사항으로 보낼 메시지의 텍스트입니다.
ssml - 선택 사항으로, 음성 사용 채널에서 봇이 말하는 텍스트입니다.
inputHint - 선택 사항으로, 메시지가 클라이언트에 전달된 후 봇이 사용자 입력을 수락, 예상 또는 무시할지 여부를 나타냅니다. 기본값은 ACCEPTING_INPUT.

반환:

첨부 파일이 포함된 메시지 활동입니다.

attachment

public static Activity attachment(List attachments)

첨부 파일이 포함된 메시지 활동을 반환합니다.

매개 변수:

attachments - 메시지에 포함할 첨부 파일입니다.

반환:

첨부 파일이 포함된 메시지 활동입니다.

attachment

public static Activity attachment(List attachments, String text, String ssml, InputHints inputHint)

첨부 파일이 포함된 메시지 활동을 반환합니다.

매개 변수:

attachments - 메시지에 포함할 첨부 파일입니다.
text - 선택 사항으로 보낼 메시지의 텍스트입니다.
ssml - 선택 사항으로, 음성 사용 채널에서 봇이 말하는 텍스트입니다.
inputHint - 선택 사항으로, 메시지가 클라이언트에 전달된 후 봇이 사용자 입력을 수락, 예상 또는 무시할지 여부를 나타냅니다. 기본값은 ACCEPTING_INPUT.

반환:

첨부 파일이 포함된 메시지 활동입니다.

carousel

public static Activity carousel(List attachments, String text)

목록에 첨부 파일 컬렉션이 포함된 메시지 활동을 반환합니다.

매개 변수:

attachments - 메시지에 포함할 첨부 파일입니다.
text - 선택 사항으로 보낼 메시지의 텍스트입니다.

반환:

첨부 파일이 포함된 메시지 활동입니다.

carousel

public static Activity carousel(List attachments, String text, String ssml, InputHints inputHint)

목록에 첨부 파일 컬렉션이 포함된 메시지 활동을 반환합니다.

매개 변수:

attachments - 메시지에 포함할 첨부 파일입니다.
text - 선택 사항으로 보낼 메시지의 텍스트입니다.
ssml - 선택 사항으로, 음성 사용 채널에서 봇이 말하는 텍스트입니다.
inputHint - 선택 사항으로, 메시지가 클라이언트에 전달된 후 봇이 사용자 입력을 수락, 예상 또는 무시할지 여부를 나타냅니다. 기본값은 ACCEPTING_INPUT.

반환:

첨부 파일이 포함된 메시지 활동입니다.

contentUrl

public static Activity contentUrl(String url, String contentType)

단일 이미지 또는 비디오가 포함된 메시지 활동을 반환합니다.

매개 변수:

url - 보낼 이미지 또는 비디오의 URL입니다.
contentType - 이미지 또는 비디오의 MIME 형식입니다.

반환:

첨부 파일이 포함된 메시지 활동입니다.

contentUrl

public static Activity contentUrl(String url, String contentType, String name, String text, String ssml, InputHints inputHint)

단일 이미지 또는 비디오가 포함된 메시지 활동을 반환합니다.

매개 변수:

url - 보낼 이미지 또는 비디오의 URL입니다.
contentType - 이미지 또는 비디오의 MIME 형식입니다.
name - 선택 사항으로, 이미지 또는 비디오 파일의 이름입니다.
text - 선택 사항으로 보낼 메시지의 텍스트입니다.
ssml - 선택 사항으로, 음성 사용 채널에서 봇이 말하는 텍스트입니다.
inputHint - 선택 사항으로, 메시지가 클라이언트에 전달된 후 봇이 사용자 입력을 수락, 예상 또는 무시할지 여부를 나타냅니다. 기본값은 ACCEPTING_INPUT.

반환:

첨부 파일이 포함된 메시지 활동입니다.

suggestedActions

public static Activity suggestedActions(List actions, String text)

제안된 작업 및 선택적 텍스트 집합이 포함된 메시지를 반환합니다. // Create the activity and add suggested actions. Activity activity = MessageFactory.suggestedActions( new String[] { "red", "green", "blue" }, "Choose a color");

// Send the activity as a reply to the user. context.sendActivity(activity);

매개 변수:

actions - 만들 작업의 텍스트입니다.
text - 선택적. 보낼 메시지의 텍스트입니다.

반환:

제안된 작업이 포함된 메시지 활동입니다.

suggestedActions

public static Activity suggestedActions(List actions, String text, String ssml, InputHints inputHint)

제안된 작업 및 선택적 텍스트 집합이 포함된 메시지를 반환합니다. // Create the activity and add suggested actions. Activity activity = MessageFactory.suggestedActions( new String[] { "red", "green", "blue" }, "Choose a color");

// Send the activity as a reply to the user. context.sendActivity(activity);

매개 변수:

actions - 만들 작업의 텍스트입니다.
text - 선택적. 보낼 메시지의 텍스트입니다.
ssml - 선택 사항으로, 음성 사용 채널에서 봇이 말하는 텍스트입니다.
inputHint - 선택 사항으로, 메시지가 클라이언트에 전달된 후 봇이 사용자 입력을 수락, 예상 또는 무시할지 여부를 나타냅니다. 기본값은 ACCEPTING_INPUT.

반환:

제안된 작업이 포함된 메시지 활동입니다.

suggestedCardActions

public static Activity suggestedCardActions(List actions, String text)

제안된 작업 및 선택적 텍스트 집합이 포함된 메시지를 반환합니다.

매개 변수:

actions - 포함할 카드 작업입니다.
text - 선택 사항으로 보낼 메시지의 텍스트입니다.

반환:

제안된 작업이 포함된 메시지 활동입니다.

suggestedCardActions

public static Activity suggestedCardActions(List actions, String text, String ssml, InputHints inputHint)

제안된 작업 및 선택적 텍스트 집합이 포함된 메시지를 반환합니다.

매개 변수:

actions - 포함할 카드 작업입니다.
text - 선택 사항으로 보낼 메시지의 텍스트입니다.
ssml - 선택 사항으로, 음성 사용 채널에서 봇이 말하는 텍스트입니다.
inputHint - 선택 사항으로, 메시지가 클라이언트에 전달된 후 봇이 사용자 입력을 수락, 예상 또는 무시할지 여부를 나타냅니다. 기본값은 ACCEPTING_INPUT.

반환:

제안된 작업이 포함된 메시지 활동입니다.

text

public static Activity text(String text)

간단한 문자 메시지를 반환합니다.

매개 변수:

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

반환:

텍스트가 포함된 메시지 활동입니다.

text

public static Activity text(String text, String ssml, InputHints inputHint)

간단한 문자 메시지를 반환합니다.

매개 변수:

text - 보낼 메시지의 텍스트입니다.
ssml - 선택 사항으로, 음성 지원 채널에서 봇이 말할 텍스트입니다.
inputHint - 선택 사항으로, 메시지가 클라이언트에 전달된 후 봇이 사용자 입력을 수락, 예상 또는 무시할지 여부를 나타냅니다. 기본값은 ACCEPTING_INPUT.

반환:

텍스트가 포함된 메시지 활동입니다.

적용 대상