翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# RCS リッチカードの送信
<a name="rcs-rich-cards"></a>

リッチカードは、メディア、テキスト、および推奨されるアクションを 1 つの構造化メッセージに結合します。受信者は、メッセージングクライアントでカードをネイティブ UI 要素として認識し、アプリのようなエクスペリエンスを提供します。リッチカードを使用して、製品の詳細、予約の確認、プロモーションオファーなど、やり取りを促す情報を表示します。

**重要**  
RCS がサポートされているすべての国で、RCS リッチメディアメッセージング (リッチカードを含む) を使用できます。詳細については、「[リッチ RCS メッセージを送信する](rcs-rich-messaging.md)」を参照してください。

複数のカードをスクロール可能なセットにグループ化するには、「」を参照してください[RCS カルーセルの送信](rcs-carousels.md)。

**Topics**
+ [リッチカードを使用するタイミング](#rcs-rich-cards-when)
+ [リッチカードコンポーネント](#rcs-rich-cards-components)
+ [カードの向き](#rcs-rich-cards-orientation)
+ [メディアと高さ](#rcs-rich-cards-media)
+ [カードレベルの提案](#rcs-rich-cards-suggestions)
+ [RcsMessageContent 構造](#rcs-rich-cards-structure)
+ [リッチカードの送信](#rcs-rich-cards-sending)
+ [クロスプラットフォームレンダリング](#rcs-rich-cards-rendering)
+ [リッチカードの制限](#rcs-rich-cards-limits)

## リッチカードを使用するタイミング
<a name="rcs-rich-cards-when"></a>

リッチカードは、インタラクティブな要素を含むビジュアルレイアウトの恩恵を受けるメッセージに適しています。一般的ユースケースには以下が含まれます。
+ **製品紹介**: イメージ、製品名、価格、購入ボタンを 1 つのメッセージに表示します。
+ **予約の確認**: 予約の詳細をカレンダーリンクと指示ボタンで表示します。
+ **予約の詳細**: 確認または再スケジュールする現在の日付、時刻、場所、オプション。
+ **プロモーションオファー**: メディアとの取引と明確な行動の呼びかけを強調します。

メッセージにオプションの提案を含むテキストのみが必要な場合は、[RCS テキストメッセージの送信](rcs-text-messages.md)代わりに を使用します。カード構造を追加せずにファイルを送信する必要がある場合は、「」を参照してください[RCS ファイルメッセージの送信](rcs-file-messages.md)。

## リッチカードコンポーネント
<a name="rcs-rich-cards-components"></a>

スタンドアロンのリッチカードは、次のコンポーネントで構成されます。では`Media`、、`Title`、または の少なくとも 1 つ`Description`が必要です`CardContent`。


**リッチカードコンポーネント**  

| コンポーネント | 必要 | 説明 | 
| --- | --- | --- | 
| Media | いいえ | カード内に表示されるイメージ、GIF、またはビデオ。サポートされている形式には、JPEG、PNG、GIF、MP4 などがあります。 ファイルの最大サイズは 100 MB です。 | 
| Title | いいえ | カードの短い見出し。最大 200 文字。 | 
| Description | いいえ | 追加の詳細を提供する本文テキスト。最大 2,000 文字。 | 
| Suggestions | いいえ | カードにアタッチされた最大 4 つの推奨アクションまたは返信。「[RCS の提案の設定](rcs-suggestions.md)」を参照してください。 | 

## カードの向き
<a name="rcs-rich-cards-orientation"></a>

`CardOrientation` フィールドは、メディアコンテンツとテキストコンテンツのレイアウト関係を制御します。このフィールドは必須です。

`VERTICAL`  
カードの上部に、タイトル、説明、提案がメディアに表示されます。プラットフォーム間の互換性のために推奨されるデフォルトは垂直方向です。

`HORIZONTAL`  
メディアは、カードの左側または右側にテキストコンテンツが横に表示されます。メディアエリアの固定幅は、密度に依存しない 128 ピクセル (DP) です。を使用して`ThumbnailImageAlignment`、メディアが左右に表示されるかどうかを制御します。

**警告**  
水平方向では、iOS デバイスでイメージが切り捨てられます。クロスプラットフォームデプロイには`VERTICAL`方向を使用します。

## メディアと高さ
<a name="rcs-rich-cards-media"></a>

`Media` オブジェクトには、 `FileUrl` (必須）、オプションの `ThumbnailUrl`、およびオプションの `Height` 値が含まれます。はパターンと一致する`FileUrl`必要があり、最大 2,000 文字に`^(https://|s3://).+$`することができます。最大メディアファイルサイズは 100 MB です。

サポートされているメディア形式、配信オプション、および S3 署名付き URLs「」を参照してください[RCS ファイルメッセージの送信](rcs-file-messages.md)。


**メディアの高さの値**  

| Height | サイズ | 説明 | 
| --- | --- | --- | 
| SHORT | 112 DP | コンパクトディスプレイ。サムネイルに使用するか、テキストコンテンツが主な焦点である場合に使用します。 | 
| MEDIUM | 168 DP | バランスの取れた表示。ほとんどのユースケースに推奨されるデフォルト。 | 
| TALL | 264 DP | 最大表示領域。メディアがプライマリコンテンツである場合に使用します。 | 

**注記**  
iOS では、指定された高さ設定を無視して、すべてのメディアの高さ値が同一にレンダリングされます。を使用して`TALL`、iOS で許容可能なレンダリングを維持しながら、Android デバイスの表示領域を最大化します。

## カードレベルの提案
<a name="rcs-rich-cards-suggestions"></a>

`CardContent.Suggestions` 配列に含めることで、リッチカードに最大 4 つの候補をアタッチできます。カードレベルの提案は、カードコンテンツのすぐ下に表示されます。

カードレベルの提案に加えて、`RcsMessageContent`構造の最上位`Suggestions`配列に最大 11 個のメッセージレベルの提案を含めることができます。メッセージレベルの提案は、メッセージ全体の下に永続的チップとして表示されます。

提案タイプ (`Reply`、、`OpenUrl`、、`DialPhone`、 を含む`CreateCalendarEvent`) `ShowLocation`の完全なリストについては`RequestLocation`、「」を参照してください[RCS の提案の設定](rcs-suggestions.md)。

## RcsMessageContent 構造
<a name="rcs-rich-cards-structure"></a>

次の JSON は、スタンドアロンのリッチカードの `RcsMessageContent`パラメータの構造を示しています。この JSON を CLI の `--rcs-message-content`パラメータに文字列として、または SDK AWSの `RcsMessageContent`パラメータとして渡します。

```
{
  "Content": {
    "RichCard": {
      "StandaloneCard": {
        "CardOrientation": "VERTICAL",
        "CardContent": {
          "Title": "Your card title",
          "Description": "Additional details about the card content.",
          "Media": {
            "FileUrl": "https://example.com/image.jpg",
            "ThumbnailUrl": "https://example.com/thumb.jpg",
            "Height": "MEDIUM"
          },
          "Suggestions": [
            {
              "Reply": {
                "Text": "Confirm",
                "PostbackData": "confirm_action"
              }
            },
            {
              "OpenUrl": {
                "Text": "View details",
                "PostbackData": "view_details",
                "Url": "https://www.example.com/details"
              }
            }
          ]
        }
      }
    }
  },
  "Suggestions": [
    {
      "Reply": {
        "Text": "Help",
        "PostbackData": "help_menu"
      }
    }
  ]
}
```

この構造の説明
+ `Content.RichCard.StandaloneCard` にはカード定義が含まれています。
+ `CardOrientation` は必須であり、 `VERTICAL`または を受け入れます`HORIZONTAL`。
+ `ThumbnailImageAlignment` はオプションで、水平カードにのみ適用されます。
+ `CardContent.Suggestions` は、カードレベルの提案を保持します (最大 4)。
+ 最上位の`Suggestions`配列は、メッセージレベルの提案を保持します (最大 11)。

## リッチカードの送信
<a name="rcs-rich-cards-sending"></a>

`SendRcsMessage` API アクションを使用してリッチカードを送信します。プールまたは AWSRCS エージェントを として指定`--origination-identity`し、リッチカード JSON 構造を `--rcs-message-content`パラメータとして渡します。

## クロスプラットフォームレンダリング
<a name="rcs-rich-cards-rendering"></a>

リッチカードのレンダリングは、Android デバイスと iOS デバイスによって異なります。一貫した結果を得るには、次の推奨事項に従ってください。


**クロスプラットフォームの推奨事項**  

| 推奨事項 | Reason | 
| --- | --- | 
| VERTICAL 向きを使用する | 水平方向では、iOS でイメージが切り捨てられます。 | 
| TALL メディアの高さを使用する | iOS は高さの値を無視します。 は Android の表示領域TALLを最大化します。 | 
| タイトルを 3 行以下に維持する | アクセシビリティ設定が有効になっている iOS でのメディアクロッピングを防止します。 | 
| リンクのOpenUrl提案を使用する | 説明テキストの URLs は、どちらのプラットフォームでもクリックできません。 | 
| iOS で GIF メディアをテストする | 静的な最初のフレームのレンダリングが許容できることを確認します。 | 

## リッチカードの制限
<a name="rcs-rich-cards-limits"></a>


**リッチカードの制限**  

| [リソース]  | 制限 | 
| --- | --- | 
| タイトルの長さ | 200 文字 | 
| 説明の長さ | 2,000 文字 | 
| カードレベルの提案 | カードあたり 4 | 
| メッセージレベルの提案 | メッセージあたり 11 | 
| メッセージペイロードの合計 | 250 KB | 
| メディアファイルサイズ | 100 MB | 
| FileUrl 長さ | 2,000 文字 |