

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á.

# Armazenamento WebRTC de vídeo do Amazon Kinesis
<a name="API_Operations_Amazon_Kinesis_Video_WebRTC_Storage"></a>

As seguintes ações são suportadas pelo Amazon Kinesis Video WebRTC Storage:
+  [JoinStorageSession](API_webrtc_JoinStorageSession.md) 
+  [JoinStorageSessionAsViewer](API_webrtc_JoinStorageSessionAsViewer.md) 

# JoinStorageSession
<a name="API_webrtc_JoinStorageSession"></a>

**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
<a name="API_webrtc_JoinStorageSession_RequestSyntax"></a>

```
POST /joinStorageSession HTTP/1.1
Content-type: application/json

{
   "channelArn": "string"
}
```

## Parâmetros da solicitação de URI
<a name="API_webrtc_JoinStorageSession_RequestParameters"></a>

A solicitação não usa nenhum parâmetro de URI.

## Corpo da Solicitação
<a name="API_webrtc_JoinStorageSession_RequestBody"></a>

A solicitação aceita os dados a seguir no formato JSON.

 ** [channelArn](#API_webrtc_JoinStorageSession_RequestSyntax) **   <a name="KinesisVideo-webrtc_JoinStorageSession-request-channelArn"></a>
 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
<a name="API_webrtc_JoinStorageSession_ResponseSyntax"></a>

```
HTTP/1.1 200
```

## Elementos de Resposta
<a name="API_webrtc_JoinStorageSession_ResponseElements"></a>

Se a ação for bem-sucedida, o serviço reenviará uma resposta 200 HTTP com um corpo HTTP vazio.

## Erros
<a name="API_webrtc_JoinStorageSession_Errors"></a>

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
<a name="API_webrtc_JoinStorageSession_SeeAlso"></a>

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\$1\$1](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) 

# JoinStorageSessionAsViewer
<a name="API_webrtc_JoinStorageSessionAsViewer"></a>

**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
<a name="API_webrtc_JoinStorageSessionAsViewer_RequestSyntax"></a>

```
POST /joinStorageSessionAsViewer HTTP/1.1
Content-type: application/json

{
   "channelArn": "string",
   "clientId": "string"
}
```

## Parâmetros da solicitação de URI
<a name="API_webrtc_JoinStorageSessionAsViewer_RequestParameters"></a>

A solicitação não usa nenhum parâmetro de URI.

## Corpo da Solicitação
<a name="API_webrtc_JoinStorageSessionAsViewer_RequestBody"></a>

A solicitação aceita os dados a seguir no formato JSON.

 ** [channelArn](#API_webrtc_JoinStorageSessionAsViewer_RequestSyntax) **   <a name="KinesisVideo-webrtc_JoinStorageSessionAsViewer-request-channelArn"></a>
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) **   <a name="KinesisVideo-webrtc_JoinStorageSessionAsViewer-request-clientId"></a>
 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
<a name="API_webrtc_JoinStorageSessionAsViewer_ResponseSyntax"></a>

```
HTTP/1.1 200
```

## Elementos de Resposta
<a name="API_webrtc_JoinStorageSessionAsViewer_ResponseElements"></a>

Se a ação for bem-sucedida, o serviço reenviará uma resposta 200 HTTP com um corpo HTTP vazio.

## Erros
<a name="API_webrtc_JoinStorageSessionAsViewer_Errors"></a>

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
<a name="API_webrtc_JoinStorageSessionAsViewer_SeeAlso"></a>

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\$1\$1](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) 