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

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

Terhubung sebagai penampil ke saluran pensinyalan yang ditentukan oleh titik akhir. Pustaka WebSocket yang sesuai dapat digunakan untuk terhubung ke titik akhir websocket (WSS) aman yang diperoleh dari panggilan API. `GetSignalingChannelEndpoint` Nama Sumber Daya Amazon (ARN) dari saluran pensinyalan dan ID klien harus disediakan sebagai parameter string kueri. Ada titik akhir terpisah untuk menghubungkan sebagai master dan sebagai penampil. Jika ada koneksi yang ada dengan sama `ClientId` seperti yang ditentukan dalam permintaan, koneksi baru diutamakan. Metadata koneksi ditimpa dengan informasi baru.

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

```
"X-Amz-ChannelARN": "string",
"X-Amz-ClientId": "string"
```
+ **X-AMZ-channelarn - ARN** dari saluran pensinyalan.
  + Jenis: string
  + Panjang batasan: Panjang minimum 1. Panjang maksimal 1024
  + Pola: `arn:aws:kinesisvideo:[a-z0-9-]+:[0-9]+:[a-z]+/[a-zA-Z0-9_.-]+/[0-9]+`
  + Wajib: Ya
+ **X-Amz- ClientId** - Pengidentifikasi unik untuk klien.
  + Jenis: string
  + Panjang batasan: Panjang minimum 1. Panjang maksimum 256.
  + Pola: `^(?!(?i)AWS_.*)[a-zA-Z0-9_.-]`
**catatan**  
`X-Amz-ClientId`Tidak bisa mulai dengan`AWS_`.
  + Wajib: Ya

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

200 OK kode status HTTP dengan badan kosong.

## Kesalahan
<a name="ConnectAsViewer-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
+ AccessDeniedException

  Penelepon tidak berwenang untuk mengakses saluran yang diberikan atau token telah kedaluwarsa.

  Kode Status HTTP: 403
+ ResourceNotFoundException

  Saluran itu tidak ada.

  Kode Status HTTP: 404
+ ClientLimitExceededException

  Ketika API dipanggil pada tingkat yang terlalu tinggi atau ketika ada lebih dari jumlah maksimum pemirsa yang didukung yang terhubung ke saluran. 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="ConnectAsViewer-limits"></a>

API ini dibatasi pada tingkat akun jika API dipanggil pada tingkat yang terlalu tinggi atau ketika jumlah maksimum penonton yang didukung terhubung ke saluran lebih dari jumlah maksimum yang didukung. Kesalahan kembali saat dibatasi dengan. `ClientLimitExceededException`

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

Jika koneksi sudah ada untuk yang ditentukan `ClientId` dan saluran, metadata koneksi diperbarui dengan informasi baru.

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

Ini dihitung sebagai panggilan API baru.

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

Panggilan bersamaan diizinkan, metadata koneksi diperbarui untuk setiap panggilan.