As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.
# JoinStorageSessionAsViewer
**nota**
Antes de usar essa API, você deve chamar a `GetSignalingChannelEndpoint` API para solicitar o endpoint WEBRTC. Em seguida, você especifica o endpoint e a região na sua solicitação de `JoinStorageSessionAsViewer` API.
`JoinStorageSessionAsViewer`permite que um espectador participe de uma sessão contínua de streaming WebRTC gravada na nuvem. Essa API inicia uma conexão WebRTC enviando uma oferta de SDP e candidatos ICE entre o espectador e o agente de gravação, permitindo que o espectador receba vídeo em tempo real do master por meio do agente de gravação e participe da comunicação de áudio bidirecional por meio do agente de gravação. Depois de conectado, o áudio do espectador, se fornecido, é encaminhado para todos os outros pares conectados, incluindo o participante principal, e é incorporado ao stream do WebRTC que está sendo salvo no stream do Kinesis Video.
**Importante**
No momento, os espectadores não podem enviar nenhuma faixa de vídeo. Os espectadores podem enviar uma faixa de áudio opcional ou nenhuma faixa.
Requisitos atuais de envio do participante espectador:
Faixa de vídeo: não suportada
Faixa de áudio (opcional): Opus
Se o participante principal estiver conectado atualmente ao dispositivo produtor de vídeo, o vídeo ingerido resultante no stream de vídeo do Kinesis terá os seguintes parâmetros: vídeo H.264 e áudio AAC.
**nota**
Os participantes visualizadores se conectam diretamente à sessão de armazenamento e não diretamente ao participante principal. A sessão de armazenamento se encarrega de misturar, duplicar e rotear a mídia para o destino apropriado.
**nota**
Se o participante principal não estiver presente, os espectadores não conseguirão se ouvir.
Depois que o espectador participante negociar uma conexão por meio do WebRTC, a sessão de áudio ingerida será armazenada no stream de vídeo do Kinesis, desde que o participante principal também esteja conectado à sessão de armazenamento.
Você também pode usar os `HLS` recursos existentes do Kinesis Video Streams, `DASH` como reprodução, [GetImages](https://docs.aws.amazon.com/kinesisvideostreams/latest/dg/gs-getImages.html)geração de imagens e muito mais, com mídia WebRTC ingerida.
**nota**
Atualmente, não há suporte para entrega de imagens e notificações do S3.
**nota**
Suponha que somente um cliente de dispositivo produtor de vídeo possa ser associado a uma sessão do canal. Se mais de um cliente ingressar na sessão de um canal específico como dispositivo de produção de vídeo, a solicitação mais recente do cliente terá precedência.
**Limites**
Os limites atuais estão em vigor:
+ **Número máximo de espectadores:** 3
+ **Tempo máximo que os participantes do visualizador permanecem conectados à sessão de armazenamento sem a presença de um participante principal:** 3 minutos
**Importante**
Se um espectador se desconectar da sessão de armazenamento (fechar a conexão entre pares), sua cota (limite de visualizações) permanecerá consumida por 1 minuto. Durante esse período de 1 minuto, o espectador pode invocar essa API com o mesmo ID do cliente para voltar à sessão sem consumir uma cota adicional de visualizador. Depois de 1 minuto, a cota de espectadores é liberada e está disponível para que outros espectadores participem.
**Informações adicionais**
+ **Idempotente** - Essa API não é idempotente.
+ **Comportamento de nova tentativa**: isso é contabilizado como uma nova chamada de API.
+ **Chamadas simultâneas - Chamadas** simultâneas são permitidas. Uma oferta é enviada uma vez por cada chamada.
## Sintaxe da Solicitação
```
POST /joinStorageSessionAsViewer HTTP/1.1
Content-type: application/json
{
"channelArn": "{{string}}",
"clientId": "{{string}}"
}
```
## Parâmetros da solicitação de URI
A solicitação não usa nenhum parâmetro de URI.
## Corpo da Solicitação
A solicitação aceita os dados a seguir no formato JSON.
** [channelArn](#API_webrtc_JoinStorageSessionAsViewer_RequestSyntax) **
O nome do recurso da Amazon (ARN) do canal de sinalização.
Observe a capitalização desse parâmetro de entrada.
Tipo: sequência
Padrão: `arn:(aws[a-zA-Z-]*):kinesisvideo:[a-z0-9-]+:[0-9]+:[a-z]+/[a-zA-Z0-9_.-]+/[0-9]+`
Obrigatório: Sim
** [clientId](#API_webrtc_JoinStorageSessionAsViewer_RequestSyntax) **
O identificador exclusivo do cliente remetente.
Tipo: string
Restrições de tamanho: tamanho mínimo 1. Tamanho máximo de 256.
Padrão: `[a-zA-Z0-9_.-]+`
Obrigatório: sim
## Sintaxe da resposta
```
HTTP/1.1 200
```
## Elementos de Resposta
Se a ação for bem-sucedida, o serviço reenviará uma resposta 200 HTTP com um corpo HTTP vazio.
## Erros
Para informações sobre os erros comuns retornados pelas ações, consulte [Tipos de erro comuns](CommonErrors.md).
** AccessDeniedException **
Você não tem as permissões necessárias para realizar essa operação.
Código de status HTTP: 403
** ClientLimitExceededException **
O Kinesis Video Streams limitou a solicitação porque você excedeu o limite permitido de chamadas de clientes. Tente fazer a ligação mais tarde.
Código de status HTTP: 400
** InvalidArgumentException **
O valor desse parâmetro de entrada é inválido.
Código de status HTTP: 400
** ResourceNotFoundException **
O recurso especificado não foi encontrado.
Código de status HTTP: 404
## Consulte Também
Para obter mais informações sobre como usar essa API em uma das linguagens específicas AWS SDKs, consulte o seguinte:
+ [AWS Interface de linha de comando V2](https://docs.aws.amazon.com/goto/cli2/kinesis-video-webrtc-storage-2018-05-10/JoinStorageSessionAsViewer)
+ [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/kinesis-video-webrtc-storage-2018-05-10/JoinStorageSessionAsViewer)
+ [AWS SDK para C\+\+](https://docs.aws.amazon.com/goto/SdkForCpp/kinesis-video-webrtc-storage-2018-05-10/JoinStorageSessionAsViewer)
+ [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/kinesis-video-webrtc-storage-2018-05-10/JoinStorageSessionAsViewer)
+ [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/kinesis-video-webrtc-storage-2018-05-10/JoinStorageSessionAsViewer)
+ [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/kinesis-video-webrtc-storage-2018-05-10/JoinStorageSessionAsViewer)
+ [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/kinesis-video-webrtc-storage-2018-05-10/JoinStorageSessionAsViewer)
+ [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/kinesis-video-webrtc-storage-2018-05-10/JoinStorageSessionAsViewer)
+ [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/kinesis-video-webrtc-storage-2018-05-10/JoinStorageSessionAsViewer)
+ [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/kinesis-video-webrtc-storage-2018-05-10/JoinStorageSessionAsViewer)