次の方法で共有


CardFactory class

ボットが返すことができるさまざまなカードの種類を書式設定するためのメソッドを提供します。

注釈

これらの関数はすべて、Attachment オブジェクトを返します。このオブジェクトは、既存のアクティビティの 添付ファイル コレクションに直接追加することも、MessageFactory メソッドのいずれかに入力として渡して新しいアクティビティを生成することもできます。

この例では、1 つのヒーロー カードを含むメッセージを送信します。

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);

プロパティ

contentTypes

各カード スタイルのコンテンツ タイプ スキーマを一覧表示します。

メソッド

actions(string | CardAction[] | undefined)

正しく書式設定されたアクションの配列を返します。

adaptiveCard(any)

アダプティブ カードの添付ファイルを返します。

animationCard(string, string | MediaUrl[], string | CardAction[], Partial<AnimationCard>)

アニメーション カードの添付ファイルを返します。

audioCard(string, string | MediaUrl[], string | CardAction[], Partial<AudioCard>)

オーディオ カードの添付ファイルを返します。

heroCard(string, string | CardImage[], string | CardAction[], Partial<HeroCard>)

ヒーロー カードの添付ファイルを返します。

heroCard(string, string, string | CardImage[], string | CardAction[], Partial<HeroCard>)

ヒーロー カードの添付ファイルを返します。

images(string | CardImage[] | undefined)

正しく書式設定されたカードイメージの配列を返します。

media(string | MediaUrl[] | undefined)

メディア URL オブジェクトの正しく書式設定された配列を返します。

o365ConnectorCard(O365ConnectorCard)

Office 365 コネクタ カードの添付ファイルを返します。

oauthCard(string, string, string, string, TokenExchangeResource)

OAuth カードの添付ファイルを返します。

receiptCard(ReceiptCard)

レシート カードの添付ファイルを返します。

signinCard(string, string, string)

サインイン カードの添付ファイルを返します。

thumbnailCard(string, string | CardImage[], string | CardAction[], Partial<ThumbnailCard>)

サムネイル カードの添付ファイルを返します。

thumbnailCard(string, string, string | CardImage[], string | CardAction[], Partial<ThumbnailCard>)

サムネイル カードの添付ファイルを返します。

videoCard(string, string | MediaUrl[], string | CardAction[], Partial<VideoCard>)

ビデオ カードの添付ファイルを返します。

プロパティの詳細

contentTypes

各カード スタイルのコンテンツ タイプ スキーマを一覧表示します。

static contentTypes: any

プロパティ値

any

メソッドの詳細

actions(string | CardAction[] | undefined)

正しく書式設定されたアクションの配列を返します。

static function actions(actions: string | CardAction[] | undefined): CardAction[]

パラメーター

actions

string | CardAction[] | undefined

カードに含めるアクションの配列。 配列内の各 string は、タイトルと値が文字列の値に設定された imBack ボタンに変換されます。

戻り値

CardAction[]

適切に書式設定されたアクションの配列。

adaptiveCard(any)

アダプティブ カードの添付ファイルを返します。

static function adaptiveCard(card: any): Attachment

パラメーター

card

any

返されるアダプティブ カードの説明。

戻り値

Attachment

添付ファイル

注釈

アダプティブ カードはオープン カード交換形式であり、開発者は UI コンテンツを共通の一貫性のある方法で交換できます。 アダプティブ カードをネイティブでまだサポートしていないチャネルの場合、Bot Framework は、ターゲット チャネルで適切に表示されるようにスタイル設定されたイメージにカードをダウンレンダリングします。 ヒーロー カード をサポートするチャネルの場合は、アダプティブ カード アクションを引き続き含めることができます。これらは、レンダリングされたバージョンのカードと共にボタンとして送信されます。

アダプティブ カードの詳細と最新の SDK のダウンロードについては、adaptivecards.ioを参照してください。

例えば:

const card = CardFactory.adaptiveCard({
  "$schema": "http://adaptivecards.io/schemas/adaptive-card.json",
  "type": "AdaptiveCard",
  "version": "1.0",
  "body": [
      {
         "type": "TextBlock",
         "text": "Default text input"
      }
  ],
  "actions": [
      {
         "type": "Action.Submit",
         "title": "OK"
      }
  ]
});

animationCard(string, string | MediaUrl[], string | CardAction[], Partial<AnimationCard>)

アニメーション カードの添付ファイルを返します。

static function animationCard(title: string, media: string | MediaUrl[], buttons?: string | CardAction[], other?: Partial<AnimationCard>): Attachment

パラメーター

title

string

カードのタイトル。

media

string | MediaUrl[]

カードのメディア URL。

buttons

string | CardAction[]

随意。 カードに含めるボタンの配列。 配列内の各 string は、タイトルと値が文字列の値に設定された imBack ボタンに変換されます。

other

Partial<AnimationCard>

随意。 カードに含める追加のプロパティ。

戻り値

Attachment

添付ファイル

audioCard(string, string | MediaUrl[], string | CardAction[], Partial<AudioCard>)

オーディオ カードの添付ファイルを返します。

static function audioCard(title: string, media: string | MediaUrl[], buttons?: string | CardAction[], other?: Partial<AudioCard>): Attachment

パラメーター

title

string

カードのタイトル。

media

string | MediaUrl[]

カードのメディア URL。

buttons

string | CardAction[]

随意。 カードに含めるボタンの配列。 配列内の各 string は、タイトルと値が文字列の値に設定された imBack ボタンに変換されます。

other

Partial<AudioCard>

随意。 カードに含める追加のプロパティ。

戻り値

Attachment

添付ファイル

heroCard(string, string | CardImage[], string | CardAction[], Partial<HeroCard>)

ヒーロー カードの添付ファイルを返します。

static function heroCard(title: string, images?: string | CardImage[], buttons?: string | CardAction[], other?: Partial<HeroCard>): Attachment

パラメーター

title

string

カードのタイトル。

images

string | CardImage[]

随意。 カードに含める画像の配列。 各要素には、CardImage または含めるイメージの URL を指定できます。

buttons

string | CardAction[]

随意。 カードに含めるボタンの配列。 配列内の各 string は、タイトルと値が文字列の値に設定された imBack ボタンに変換されます。

other

Partial<HeroCard>

随意。 カードに含める追加のプロパティ。

戻り値

Attachment

添付ファイル

注釈

ヒーロー カードは、1 つの主要な全角画像を持つ傾向があります。 通常、チャネルはカードのテキストとボタンを画像の下にレンダリングします。

例えば:

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

heroCard(string, string, string | CardImage[], string | CardAction[], Partial<HeroCard>)

ヒーロー カードの添付ファイルを返します。

static function heroCard(title: string, text: string, images?: string | CardImage[], buttons?: string | CardAction[], other?: Partial<HeroCard>): Attachment

パラメーター

title

string

カードのタイトル。

text

string

カード テキスト。

images

string | CardImage[]

随意。 カードに含める画像の配列。 各要素には、CardImage または含めるイメージの URL を指定できます。

buttons

string | CardAction[]

随意。 カードに含めるボタンの配列。 配列内の各 string は、タイトルと値が文字列の値に設定された imBack ボタンに変換されます。

other

Partial<HeroCard>

随意。 カードに含める追加のプロパティ。

戻り値

Attachment

添付ファイル

注釈

ヒーロー カードは、1 つの主要な全角画像を持つ傾向があります。 通常、チャネルはカードのテキストとボタンを画像の下にレンダリングします。 例えば:

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

images(string | CardImage[] | undefined)

正しく書式設定されたカードイメージの配列を返します。

static function images(images: string | CardImage[] | undefined): CardImage[]

パラメーター

images

string | CardImage[] | undefined

カードに含める画像の配列。 各要素には、CardImage または含めるイメージの URL を指定できます。

戻り値

CardImage[]

適切に書式設定されたカード画像の配列。

media(string | MediaUrl[] | undefined)

メディア URL オブジェクトの正しく書式設定された配列を返します。

static function media(links: string | MediaUrl[] | undefined): MediaUrl[]

パラメーター

links

string | MediaUrl[] | undefined

メディア URL。 各 string はメディア URL オブジェクトに変換されます。

戻り値

MediaUrl[]

適切に書式設定されたメディア URL オブジェクトの配列。

o365ConnectorCard(O365ConnectorCard)

Office 365 コネクタ カードの添付ファイルを返します。

static function o365ConnectorCard(card: O365ConnectorCard): Attachment

パラメーター

card

O365ConnectorCard

返される Office 365 コネクタ カードの説明。

戻り値

Attachment

添付ファイル

注釈

例えば:

const card = CardFactory.o365ConnectorCard({
  "title": "card title",
  "text": "card text",
  "summary": "O365 card summary",
  "themeColor": "#E67A9E",
  "sections": [
      {
          "title": "**section title**",
          "text": "section text",
          "activityTitle": "activity title",
      }
  ]
});

oauthCard(string, string, string, string, TokenExchangeResource)

OAuth カードの添付ファイルを返します。

static function oauthCard(connectionName: string, title: string, text?: string, link?: string, tokenExchangeResource?: TokenExchangeResource): Attachment

パラメーター

connectionName

string

使用する OAuth 接続の名前。

title

string

カードのサインイン ボタンのタイトル。

text

string

随意。 カードに含める追加のテキスト。

link

string

随意。 使用するサインイン リンク。

tokenExchangeResource

TokenExchangeResource

随意。 トークン交換を実行するリソース。

戻り値

Attachment

添付ファイル

注釈

OAuth カードは、Bot Framework のシングル サインオン (SSO) サービスをサポートします。

receiptCard(ReceiptCard)

レシート カードの添付ファイルを返します。

static function receiptCard(card: ReceiptCard): Attachment

パラメーター

card

ReceiptCard

返すレシート カードの説明。

戻り値

Attachment

添付ファイル

signinCard(string, string, string)

サインイン カードの添付ファイルを返します。

static function signinCard(title: string, url: string, text?: string): Attachment

パラメーター

title

string

カードのサインイン ボタンのタイトル。

url

string

使用するサインイン ページの URL。

text

string

随意。 カードに含める追加のテキスト。

戻り値

Attachment

添付ファイル

注釈

ネイティブでサインイン カードをサポートしていないチャネルの場合は、代替メッセージが表示されます。

thumbnailCard(string, string | CardImage[], string | CardAction[], Partial<ThumbnailCard>)

サムネイル カードの添付ファイルを返します。

static function thumbnailCard(title: string, images?: string | CardImage[], buttons?: string | CardAction[], other?: Partial<ThumbnailCard>): Attachment

パラメーター

title

string

カードのタイトル。

images

string | CardImage[]

随意。 カードに含める画像の配列。 各要素には、CardImage または含めるイメージの URL を指定できます。

buttons

string | CardAction[]

随意。 カードに含めるボタンの配列。 配列内の各 string は、タイトルと値が文字列の値に設定された imBack ボタンに変換されます。

other

Partial<ThumbnailCard>

随意。 カードに含める追加のプロパティ。

戻り値

Attachment

添付ファイル

注釈

サムネイル カードはヒーロー カードに似ていますが、全幅の画像ではなく、通常は縮小版の画像でレンダリングされます。 通常、チャネルはカードのテキストを画像の一方の側にレンダリングし、カードの下にボタンが表示されます。

thumbnailCard(string, string, string | CardImage[], string | CardAction[], Partial<ThumbnailCard>)

サムネイル カードの添付ファイルを返します。

static function thumbnailCard(title: string, text: string, images?: string | CardImage[], buttons?: string | CardAction[], other?: Partial<ThumbnailCard>): Attachment

パラメーター

title

string

カードのタイトル。

text

string

カード テキスト。

images

string | CardImage[]

随意。 カードに含める画像の配列。 各要素には、CardImage または含めるイメージの URL を指定できます。

buttons

string | CardAction[]

随意。 カードに含めるボタンの配列。 配列内の各 string は、タイトルと値が文字列の値に設定された imBack ボタンに変換されます。

other

Partial<ThumbnailCard>

随意。 カードに含める追加のプロパティ。

戻り値

Attachment

添付ファイル

注釈

サムネイル カードはヒーロー カードに似ていますが、全幅の画像ではなく、通常は縮小版の画像でレンダリングされます。 通常、チャネルはカードのテキストを画像の一方の側にレンダリングし、カードの下にボタンが表示されます。

videoCard(string, string | MediaUrl[], string | CardAction[], Partial<VideoCard>)

ビデオ カードの添付ファイルを返します。

static function videoCard(title: string, media: string | MediaUrl[], buttons?: string | CardAction[], other?: Partial<VideoCard>): Attachment

パラメーター

title

string

カードのタイトル。

media

string | MediaUrl[]

カードのメディア URL。

buttons

string | CardAction[]

随意。 カードに含めるボタンの配列。 配列内の各 string は、タイトルと値が文字列の値に設定された imBack ボタンに変換されます。

other

Partial<VideoCard>

随意。 カードに含める追加のプロパティ。

戻り値

Attachment

添付ファイル