MessageFactory class

參考

套件:: botbuilder-core

一組公用程式函式，可協助 Bot 傳回的各種訊息類型格式設定。

備註

下列範例示範傳送包含單一主圖卡片的訊息：

const { MessageFactory, CardFactory } = require('botbuilder');

const card = CardFactory.heroCard(
     'White T-Shirt',
     ['https://example.com/whiteShirt.jpg'],
     ['buy']
);
const message = MessageFactory.attachment(card);
await context.sendActivity(message);

方法

attachment(Attachment, string, string, InputHints \| string)	傳回包含附件的單一訊息活動。
carousel(Attachment[], string, string, InputHints \| string)	會傳回訊息，該訊息將使用浮動切換配置來顯示一組附件。
contentUrl(string, string, string, string, string, InputHints \| string)	傳回訊息，將向用戶顯示單一影像或視訊。
list(Attachment[], string, string, InputHints \| string)	會傳回一則訊息，該郵件會在清單窗體中顯示一組附件。
suggestedActions(string \| CardAction[], string, string, InputHints \| string)	傳回訊息，其中包含一組建議的動作和選擇性文字。
text(string, string, InputHints \| string)	傳回簡單的簡訊。

方法詳細資料

attachment(Attachment, string, string, InputHints | string)

傳回包含附件的單一訊息活動。

static function attachment(attachment: Attachment, text?: string, speak?: string, inputHint?: InputHints | string): Partial<Activity>

參數

attachment: Attachment

要包含在訊息中的調適型卡片。

text: string

（選擇性）訊息的文字。

speak: string

（選擇性）要包含在訊息中的 SSML。

inputHint: InputHints | string

（選擇性）訊息的輸入提示。預設為 acceptingInput。

傳回

Partial<Activity>

包含附件的郵件活動。

備註

此範例示範如何建立具有主圖卡片附件的訊息：

const message = MessageFactory.attachment(
    CardFactory.heroCard(
        'White T-Shirt',
        ['https://example.com/whiteShirt.jpg'],
        ['buy']
     )
);

carousel(Attachment[], string, string, InputHints | string)

會傳回訊息，該訊息將使用浮動切換配置來顯示一組附件。

static function carousel(attachments: Attachment[], text?: string, speak?: string, inputHint?: InputHints | string): Partial<Activity>

參數

attachments: Attachment[]

要包含在郵件中的附件數位。

text: string

（選擇性）訊息的文字。

speak: string

（選擇性）要包含在訊息中的 SSML。

inputHint: InputHints | string

（選擇性）訊息的輸入提示。

傳回

Partial<Activity>

訊息活動，將使用浮動切換配置來顯示一組附件。

備註

此範例示範如何使用主圖卡片的浮動切換來建立訊息：

const message = MessageFactory.carousel([
   CardFactory.heroCard('title1', ['imageUrl1'], ['button1']),
   CardFactory.heroCard('title2', ['imageUrl2'], ['button2']),
   CardFactory.heroCard('title3', ['imageUrl3'], ['button3'])
]);

contentUrl(string, string, string, string, string, InputHints | string)

傳回訊息，將向用戶顯示單一影像或視訊。

static function contentUrl(url: string, contentType: string, name?: string, text?: string, speak?: string, inputHint?: InputHints | string): Partial<Activity>

參數

url: string

要傳送之影像/視訊的URL。

contentType: string

影像/視訊的MIME類型。

name: string

（選擇性）影像/視訊檔案的名稱。

text: string

（選擇性）訊息的文字。

speak: string

（選擇性）要包含在訊息中的 SSML。

inputHint: InputHints | string

（選擇性）訊息的輸入提示。

傳回

Partial<Activity>

將向用戶顯示單一影像或視訊的訊息活動。

備註

此範例顯示傳送影像給使用者：

const message = MessageFactory.contentUrl('https://example.com/hawaii.jpg', 'image/jpeg', 'Hawaii Trip', 'A photo from our family vacation.');

list(Attachment[], string, string, InputHints | string)

會傳回一則訊息，該郵件會在清單窗體中顯示一組附件。

static function list(attachments: Attachment[], text?: string, speak?: string, inputHint?: InputHints | string): Partial<Activity>

參數

attachments: Attachment[]

要包含在郵件中的附件數位。

text: string

（選擇性）訊息的文字。

speak: string

（選擇性）要包含在訊息中的 SSML。

inputHint: InputHints | string

（選擇性）訊息的輸入提示。

傳回

Partial<Activity>

訊息活動，會顯示清單表單中的一組附件。

備註

此範例示範如何建立包含主圖卡片清單的訊息：

const message = MessageFactory.list([
   CardFactory.heroCard('title1', ['imageUrl1'], ['button1']),
   CardFactory.heroCard('title2', ['imageUrl2'], ['button2']),
   CardFactory.heroCard('title3', ['imageUrl3'], ['button3'])
]);

suggestedActions(string | CardAction[], string, string, InputHints | string)

傳回訊息，其中包含一組建議的動作和選擇性文字。

static function suggestedActions(actions: string | CardAction[], text?: string, speak?: string, inputHint?: InputHints | string): Partial<Activity>

參數

actions: string | CardAction[]

要包含的卡片動作或字串數位。字串將會轉換成 messageBack 動作。

text: string

（選擇性）訊息的文字。

speak: string

（選擇性）要包含在訊息中的 SSML。

inputHint: InputHints | string

（選擇性）訊息的輸入提示。預設為 acceptingInput。

傳回

Partial<Activity>

包含建議動作的訊息活動。

備註

此範例示範如何建立含有建議動作的訊息：

const message = MessageFactory.suggestedActions(['red', 'green', 'blue'], `Choose a color`);

text(string, string, InputHints | string)

傳回簡單的簡訊。

static function text(text: string, speak?: string, inputHint?: InputHints | string): Partial<Activity>

參數

text: string

要包含在訊息中的文字。

speak: string

（選擇性）要包含在訊息中的 SSML。

inputHint: InputHints | string

（選擇性）訊息的輸入提示。預設為 acceptingInput。

傳回

Partial<Activity>

包含文字的訊息活動。

備註

此範例示範傳送簡單的簡訊：

const message = MessageFactory.text('Greetings from example message');