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á.
# JoinStorageSession
**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 `JoinStorageSession` API.
Participe da sessão contínua de and/or áudio WebRTC de áudio multidirecional de vídeo unidirecional como um dispositivo de produção de vídeo para um canal de entrada. Se não houver uma sessão existente para o canal, crie uma nova sessão de streaming e forneça o Amazon Resource Name (ARN) do canal de sinalização.
Atualmente, para o `SINGLE_MASTER` tipo, um dispositivo produtor de vídeo é capaz de ingerir mídia de áudio e vídeo em um stream. Somente dispositivos produtores de vídeo podem participar da sessão e gravar mídia.
**Importante**
Atualmente, as faixas de áudio e vídeo são necessárias para a ingestão do WebRTC.
Requisitos atuais:
Faixa de vídeo: H.264
Faixa de áudio: Opus
Vídeo:
A resolução máxima é SQFHD (1920x1920)
A ingestão do KVS WebRTC atualmente suporta um conjunto específico de perfis H264:
linha de base restrita
linha de base
main
high
restringido-alto
alta progressiva
O vídeo ingerido resultante no stream de vídeo do Kinesis terá os seguintes parâmetros: vídeo H.264 e áudio AAC.
Depois que um participante principal negociar uma conexão por meio do WebRTC, a sessão de mídia ingerida será armazenada no stream de vídeo do Kinesis. Vários espectadores podem então reproduzir mídia em tempo real por meio de nossa reprodução APIs.
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.
**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 /joinStorageSession HTTP/1.1
Content-type: application/json
{
"channelArn": "{{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_JoinStorageSession_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
## 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/JoinStorageSession)
+ [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/kinesis-video-webrtc-storage-2018-05-10/JoinStorageSession)
+ [AWS SDK para C\+\+](https://docs.aws.amazon.com/goto/SdkForCpp/kinesis-video-webrtc-storage-2018-05-10/JoinStorageSession)
+ [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/kinesis-video-webrtc-storage-2018-05-10/JoinStorageSession)
+ [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/kinesis-video-webrtc-storage-2018-05-10/JoinStorageSession)
+ [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/kinesis-video-webrtc-storage-2018-05-10/JoinStorageSession)
+ [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/kinesis-video-webrtc-storage-2018-05-10/JoinStorageSession)
+ [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/kinesis-video-webrtc-storage-2018-05-10/JoinStorageSession)
+ [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/kinesis-video-webrtc-storage-2018-05-10/JoinStorageSession)
+ [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/kinesis-video-webrtc-storage-2018-05-10/JoinStorageSession)