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 issoAPI, você deve chamar o GetSignalingChannelEndpoint API para solicitar o WEBRTC endpoint. Em seguida, você especifica o endpoint e a região em sua JoinStorageSession API solicitação.
Participe da RTC sessão contínua na Web de vídeo unidirecional e/ou áudio multidirecional 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 RTC ingestão na Web.
Requisitos atuais:
-
Faixa de vídeo: H.264
-
Faixa de áudio: Opus
O vídeo ingerido resultante no stream de vídeo do Kinesis terá os seguintes parâmetros: vídeo e áudio H.264. AAC
Depois que um participante principal negociar uma conexão pela 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çãoAPIs.
Você também pode usar os HLS recursos existentes do Kinesis Video Streams, DASH como reprodução, GetImagesgeração de imagens via e muito mais, com mídia da Web ingerida. RTC
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 - Isso não API é idempotente.
-
Comportamento de nova tentativa: isso é contabilizado como uma nova API chamada.
-
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"
}URIParâmetros de solicitação
A solicitação não usa nenhum URI parâmetro.
Corpo da Solicitação
A solicitação aceita os seguintes dados no JSON formato.
- channelArn
-
O Amazon Resource Name (ARN) do canal de sinalização.
Importante
Observe a capitalização desse parâmetro de entrada.
Tipo: string
Padrão:
^arn:(aws[a-zA-Z-]*):kinesisvideo:[a-z0-9-]+:[0-9]+:[a-z]+/[a-zA-Z0-9_.-]+/[0-9]+$Exigido: Sim
Sintaxe da Resposta
HTTP/1.1 200
Elementos de Resposta
Se a ação for bem-sucedida, o serviço retornará uma resposta de HTTP 200 com o HTTP corpo vazio.
Erros
Para obter informações sobre os erros comuns retornados pelas ações, consulte Erros comuns.
- AccessDeniedException
-
Você não tem as permissões necessárias para realizar essa operação.
HTTPCódigo de status: 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.
HTTPCódigo de status: 400
- InvalidArgumentException
-
O valor desse parâmetro de entrada é inválido.
HTTPCódigo de status: 400
- ResourceNotFoundException
-
O recurso especificado não foi encontrado.
HTTPCódigo de status: 404
Consulte também
Para obter mais informações sobre como usar isso API em um idioma específico AWS SDKs, consulte o seguinte:
