Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

# SendIceCandidate
<a name="SendIceCandidate"></a>

Mengirim kandidat ICE ke penerima target. Prasyaratnya adalah klien harus sudah terhubung ke WebSocket titik akhir yang diperoleh dari API. `GetSignalingChannelEndpoint`

Jika jenis pengirim adalah penampil, maka ia mengirim kandidat ICE ke master. Juga, tidak perlu menentukan `RecipientClientId` dan nilai tertentu untuk `RecipientClientId` diabaikan. Jika jenis pengirim adalah master,  kandidat ICE dikirim ke target yang ditentukan oleh. `RecipientClientId` `RecipientClientId`adalah masukan yang diperlukan dalam kasus ini.

Aplikasi klien master diizinkan mengirim kandidat ICE ke penampil mana pun, sedangkan aplikasi klien penampil hanya diizinkan mengirim kandidat ICE ke aplikasi klien utama. Jika aplikasi klien penampil mencoba mengirim kandidat ICE ke aplikasi klien penampil lain, permintaan tersebut TIDAK akan dihormati.

## Permintaan
<a name="SendIceCandidate-request"></a>

```
{
    "action": "ICE_CANDIDATE",
    "recipientClientId": "string",
    "messagePayload": "string",
    "correlationId": "string"
}
```
+ **action** - Jenis pesan yang sedang dikirim.
  + Jenis: ENUM
  + Nilai valid: `SDP_OFFER`, `SDP_ANSWER`, `ICE_CANDIDATE`
  + Panjang batasan: Panjang minimum 1. Panjang maksimum 256.
  + Pola: `[a-zA-Z0-9_.-]+`
  + Wajib: Ya
+ **recipientClientId**- Pengidentifikasi unik untuk penerima.
  + Tipe: String
  + Panjang batasan: Panjang minimum 1. Panjang maksimum 256.
  + Pola: `[a-zA-Z0-9_.-]+`
  + Wajib: Tidak
+ **MessagePayLoad** - Konten pesan yang dikodekan base64.
  + Tipe: String
  + Panjang batasan: Panjang minimum 1. Panjang maksimum 10K.
  + Wajib: Ya
+ **CorrelationID** - Sebuah identifier unik untuk pesan.
  + Tipe: String
  + Panjang batasan: Panjang minimum 1. Panjang maksimum 256.
  + Pola: `[a-zA-Z0-9_.-]+`
  + Wajib: Tidak

## Respons
<a name="SendIceCandidate-response"></a>

Tidak ada respons yang dikembalikan jika pesan berhasil diterima oleh backend pensinyalan. Jika layanan mengalami kesalahan dan jika `correlationId` ditentukan dalam permintaan, rincian kesalahan dikembalikan sebagai `STATUS_RESPONSE` pesan. Untuk informasi selengkapnya, lihat [Penerimaan pesan asinkron](async-message-reception-api.md).

## Kesalahan
<a name="SendIceCandidate-errors"></a>
+ InvalidArgumentException

  Parameter yang ditentukan melebihi batasannya, tidak didukung, atau tidak dapat digunakan. Untuk informasi selengkapnya, lihat pesan yang dikembalikan.

  Kode Status HTTP: 400
+ ClientLimitExceededException

  Ketika API dipanggil pada tingkat yang terlalu tinggi. Untuk informasi selengkapnya, lihat [Amazon Kinesis Video Streams dengan kuota layanan WebRTC](kvswebrtc-limits.md) dan [Error Retries dan Exponential Backoff](https://docs.aws.amazon.com/general/latest/gr/api-retries.html) di. AWS

  Kode Status HTTP: 400

## Batas/Pelambatan
<a name="SendIceCandidate-limits"></a>

API ini dibatasi pada tingkat akun jika API dipanggil pada tingkat yang terlalu tinggi. Kesalahan kembali saat dibatasi dengan. `ClientLimitExceededException`

## Idempoten
<a name="SendIceCandidate-idempotent"></a>

API ini tidak idempoten.

## Coba lagi perilaku
<a name="SendIceCandidate-retry"></a>

Ini dihitung sebagai panggilan API baru.

## Panggilan bersamaan
<a name="SendIceCandidate-concurrent"></a>

Panggilan bersamaan diizinkan. Penawaran dikirim satu kali per setiap panggilan.