Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Mengirim kartu kaya RCS
Kartu kaya menggabungkan media, teks, dan tindakan yang disarankan ke dalam satu pesan terstruktur. Penerima melihat kartu sebagai elemen UI asli di klien perpesanan mereka, memberikan pengalaman seperti aplikasi. Gunakan kartu kaya untuk menyajikan informasi yang mendorong interaksi, seperti detail produk, konfirmasi pemesanan, atau penawaran promosi.
**penting**
Anda dapat menggunakan pesan media kaya RCS (termasuk kartu kaya) di semua negara di mana RCS didukung. Untuk informasi selengkapnya, lihat [Mengirim pesan RCS yang kaya](rcs-rich-messaging.md).
Untuk mengelompokkan beberapa kartu ke dalam satu set yang dapat digulir, lihat. [Mengirim komidi putar RCS](rcs-carousels.md)
**Topics**
+ [Kapan menggunakan kartu kaya](#rcs-rich-cards-when)
+ [Komponen kartu kaya](#rcs-rich-cards-components)
+ [Orientasi kartu](#rcs-rich-cards-orientation)
+ [Media dan ketinggian](#rcs-rich-cards-media)
+ [Card-level saran](#rcs-rich-cards-suggestions)
+ [RcsMessageContent struktur](#rcs-rich-cards-structure)
+ [Mengirim kartu kaya](#rcs-rich-cards-sending)
+ [Cross-platform rendering](#rcs-rich-cards-rendering)
+ [Batas kartu kaya](#rcs-rich-cards-limits)
## Kapan menggunakan kartu kaya
Kartu kaya sangat cocok untuk pesan yang mendapat manfaat dari tata letak visual dengan elemen interaktif. Kasus penggunaan umum meliputi:
+ Tampilan **produk**: Menampilkan gambar, nama produk, harga, dan tombol pembelian dalam satu pesan.
+ **Konfirmasi pemesanan**: Tampilkan detail reservasi dengan tautan kalender dan tombol arah.
+ **Detail janji temu**: Tampilkan tanggal, waktu, lokasi, dan opsi untuk mengonfirmasi atau menjadwal ulang.
+ **Penawaran promosi**: Sorot kesepakatan dengan media dan ajakan bertindak yang jelas.
Jika pesan Anda hanya memerlukan teks dengan saran opsional, gunakan sebagai [Mengirim pesan teks RCS](rcs-text-messages.md) gantinya. Jika Anda perlu mengirim file tanpa struktur kartu tambahan, lihat[Mengirim pesan file RCS](rcs-file-messages.md).
## Komponen kartu kaya
Kartu kaya mandiri terdiri dari komponen-komponen berikut. Setidaknya satu dari `Media``Title`,, atau `Description` diperlukan di`CardContent`.
**Komponen kartu kaya**
| Komponen | Diperlukan | Deskripsi |
| --- | --- | --- |
| Media | Tidak | Gambar, GIF, atau video yang ditampilkan di dalam kartu. Format yang didukung termasuk JPEG, PNG, GIF, dan MP4. Ukuran file maksimum adalah 100 MB. |
| Title | Tidak | Judul singkat untuk kartu. Maksimal 200 karakter. |
| Description | Tidak | Teks tubuh memberikan detail tambahan. Maksimal 2.000 karakter. |
| Suggestions | Tidak | Hingga 4 tindakan yang disarankan atau balasan yang dilampirkan pada kartu. Lihat [Mengkonfigurasi saran RCS](rcs-suggestions.md). |
## Orientasi kartu
`CardOrientation`Bidang mengontrol hubungan tata letak antara media dan konten teks. Bidang ini wajib diisi.
`VERTICAL`
Media ditampilkan di bagian atas kartu dengan judul, deskripsi, dan saran di bawah ini. Orientasi vertikal adalah standar yang direkomendasikan untuk kompatibilitas lintas platform.
`HORIZONTAL`
Media ditampilkan di sisi kiri atau kanan kartu dengan konten teks di sampingnya. Area media memiliki lebar tetap 128 piksel independen kepadatan (DP). Gunakan `ThumbnailImageAlignment` untuk mengontrol apakah media muncul di kiri atau kanan.
**Awas**
Orientasi horizontal menyebabkan pemotongan gambar pada perangkat iOS. Gunakan `VERTICAL` orientasi untuk penerapan lintas platform.
## Media dan ketinggian
`Media`Objek berisi `FileUrl` (wajib), opsional`ThumbnailUrl`, dan `Height` nilai opsional. `FileUrl`Harus cocok dengan pola `^(https://|s3://).+$` dan bisa maksimal 2.000 karakter. Ukuran file media maksimum adalah 100 MB.
Untuk detail tentang format media yang didukung, opsi pengiriman, dan URL yang telah ditetapkan sebelumnya S3, lihat. [Mengirim pesan file RCS](rcs-file-messages.md)
**Nilai tinggi media**
| Tinggi | Size | Deskripsi |
| --- | --- | --- |
| SHORT | 112 DP | Tampilan kompak. Gunakan untuk thumbnail atau ketika konten teks adalah fokus utama. |
| MEDIUM | 168 DP | Tampilan seimbang. Default yang direkomendasikan untuk sebagian besar kasus penggunaan. |
| TALL | 264 DP | Area tampilan maksimum. Gunakan ketika media adalah konten utama. |
**catatan**
iOS merender semua nilai tinggi media secara identik, mengabaikan pengaturan ketinggian yang ditentukan. Gunakan `TALL` untuk memaksimalkan area tampilan di perangkat Android sambil mempertahankan rendering yang dapat diterima di iOS.
## Card-level saran
Anda dapat melampirkan hingga 4 saran ke kartu kaya dengan memasukkannya ke dalam `CardContent.Suggestions` array. Card-level saran muncul langsung di bawah konten kartu.
Selain saran tingkat kartu, Anda dapat menyertakan hingga 11 saran tingkat pesan dalam susunan tingkat atas struktur`Suggestions`. `RcsMessageContent` Message-level saran muncul sebagai chip persisten di bawah seluruh pesan.
Untuk daftar lengkap jenis saran (termasuk`Reply`,,,`OpenUrl`, `DialPhone` `ShowLocation``RequestLocation`, dan`CreateCalendarEvent`), lihat[Mengkonfigurasi saran RCS](rcs-suggestions.md).
## RcsMessageContent struktur
JSON berikut menunjukkan struktur `RcsMessageContent` parameter untuk kartu kaya mandiri. Berikan JSON ini sebagai string ke `--rcs-message-content` parameter di AWS CLI atau sebagai parameter `RcsMessageContent` di SDK.
```
{
"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"
}
}
]
}
```
Dalam struktur ini:
+ `Content.RichCard.StandaloneCard`berisi definisi kartu.
+ `CardOrientation`diperlukan dan menerima `VERTICAL` atau`HORIZONTAL`.
+ `ThumbnailImageAlignment`bersifat opsional dan hanya berlaku untuk kartu horizontal.
+ `CardContent.Suggestions`memegang saran tingkat kartu (maksimal 4).
+ `Suggestions`Array tingkat atas menyimpan saran tingkat pesan (maksimum 11).
## Mengirim kartu kaya
Gunakan tindakan `SendRcsMessage` API untuk mengirim kartu kaya. Tentukan pool atau Agen AWS RCS Anda sebagai `--origination-identity` dan berikan struktur JSON kartu kaya sebagai parameter. `--rcs-message-content`
## Cross-platform rendering
Rendering kartu kaya bervariasi antara perangkat Android dan iOS. Ikuti rekomendasi ini untuk hasil yang konsisten:
**Cross-platform rekomendasi**
| Rekomendasi | Alasan |
| --- | --- |
| Gunakan VERTICAL orientasi | Orientasi horizontal menyebabkan pemotongan gambar di iOS. |
| Gunakan ketinggian TALL media | iOS mengabaikan nilai ketinggian. TALLmemaksimalkan area tampilan di Android. |
| Jaga judul menjadi 3 baris atau kurang | Mencegah pemotongan media di iOS dengan pengaturan aksesibilitas diaktifkan. |
| Gunakan OpenUrl saran untuk tautan | URL dalam teks deskripsi tidak dapat diklik di kedua platform. |
| Uji media GIF di iOS | Konfirmasikan render frame pertama statis dapat diterima. |
## Batas kartu kaya
**Batas kartu kaya**
| Sumber daya | Kuota |
| --- | --- |
| Panjang judul | 200 karakter |
| Deskripsi panjang | 2.000 karakter |
| Card-level saran | 4 per kartu |
| Message-level saran | 11 per pesan |
| Total payload pesan | 250 KB |
| Ukuran file media | 100 MB |
| FileUrlpanjang | 2.000 karakter |