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

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

Mengirim penawaran 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 mengirimkan penawaran ke master. Juga, tidak perlu menentukan `RecipientClientId` dan nilai tertentu untuk `RecipientClientId` diabaikan. Jika jenis pengirim adalah master, penawaran dikirim ke penampil target yang ditentukan oleh. `RecipientClientId` `RecipientClientId`adalah masukan yang diperlukan dalam kasus ini.

Aplikasi klien master diizinkan mengirim penawaran ke penampil mana pun, sedangkan aplikasi klien penampil hanya diizinkan mengirim penawaran ke aplikasi klien utama. Jika aplikasi klien penampil mencoba mengirim penawaran ke aplikasi klien penampil lain, permintaan tersebut TIDAK akan dihormati. Jika ada penawaran luar biasa untuk klien yang sama yang belum dikirimkan, itu ditimpa dengan penawaran baru.

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

```
{
    "action": "SDP_OFFER",
    "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: Ya
+ **MessagePayLoad** - Konten pesan yang disandikan basis-64.
  + Tipe: String
  + Panjang batasan: Panjang minimum 1. Panjang maksimum 10K.
  + Wajib: Ya
+ **CorrelationID** - Sebuah identifier unik untuk pesan. Ini adalah parameter opsional.
  + Tipe: String
  + Panjang batasan: Panjang minimum 1. Panjang maksimum 256.
  + Pola: `[a-zA-Z0-9_.-]+`
  + Wajib: Tidak

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

Jika pesan berhasil diterima oleh backend pensinyalan, tidak ada respons yang dikembalikan. 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="SendSdpOffer-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="SendSdpOffer-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="SendSdpOffer-idempotent"></a>

API ini tidak idempoten.

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

Ini dihitung sebagai panggilan API baru.

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

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