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á.
Usando o Amazon Chime SDK
Você usa o Amazon Chime SDK para criar aplicativos de mídia em tempo real que podem enviar e receber áudio e vídeo e permitir o compartilhamento de conteúdo. O Amazon Chime SDK funciona independentemente de qualquer conta de administrador do Amazon Chime e não afeta as reuniões hospedadas no Amazon Chime. Em vez disso, o Amazon Chime SDK fornece ferramentas de criação que você usa para criar seus próprios aplicativos de reunião.
Tópicos
- Pré-requisitos para usar o Amazon Chime SDK
- Conceitos para o Amazon Chime SDK
- Arquitetura para o Amazon Chime SDK
- Cotas para o Amazon Chime SDK
- Requisitos de sistema do Amazon Chime SDK
- AWSRegiões disponíveis para o serviço Amazon Chime SDK
- Saiba mais sobre as bibliotecas de clientes do Amazon Chime SDK
- Entendendo SIP a integração usando um Amazon Chime SDK Voice Connector
- Entendendo as notificações de eventos do Amazon Chime SDK
- Como migrar do namespace do Amazon Chime
Pré-requisitos para usar o Amazon Chime SDK
O uso do Amazon Chime SDK exige o seguinte:
A capacidade de programar.
Uma AWS conta.
Uma IAM função com uma política que concede permissão para acessar API as ações do Amazon Chime usadas pelo Amazon SDK Chime, como AWS a política gerenciada. AmazonChimeSDK Para obter mais informações, consulte Como o Amazon Chime trabalha com ações do Amazon Chime IAM e permite que os usuários acessem as ações do Amazon SDK Chime no Guia do administrador do Amazon Chime. SDK
Para a maior parte dos casos de uso, também é necessário o seguinte:
Um aplicativo de servidor: gerencia os recursos da reunião e dos participantes e distribui esses recursos para o aplicativo do cliente. O aplicativo do servidor é criado na AWS conta e deve ter acesso à IAM função mencionada anteriormente.
Um aplicativo do cliente: recebe informações sobre reuniões e participantes do aplicativo do servidor e usa essas informações para fazer conexões de mídia.
Conceitos para o Amazon Chime SDK
A terminologia e os conceitos a seguir são fundamentais para entender como usar o Amazon SDK Chime.
- reunião
-
Um recurso efêmero identificado por um único
MeetingId
. OMeetingId
é colocado em um grupo de serviços de mídia que hospedam a reunião ativa. - grupo de serviços de mídia
-
O grupo de serviços de mídia que organiza uma reunião ativa.
- colocação de mídia
-
Um conjunto regionalizado URLs que representa um grupo de serviços de mídia. Os participantes se conectam ao grupo de serviços de mídia com seus clientes para enviar e receber áudio e vídeo em tempo real e compartilhar suas telas.
- participante
-
Um participante da reunião identificado por um único
AttendeeId
. Os participantes podem entrar e sair livremente das reuniões usando um aplicativo cliente criado com uma biblioteca cliente Amazon SDK Chime. - token de participação
-
Um token exclusivo atribuído a cada participante. Os participantes usam o token de participação para se autenticar com o grupo de serviços de mídia.
Arquitetura para o Amazon Chime SDK
A lista a seguir descreve como os diferentes componentes da SDK arquitetura Amazon Chime trabalham juntos para apoiar reuniões e participantes, além de compartilhar áudio, vídeo e conteúdo.
- Reuniões e participantes
-
Quando o aplicativo do servidor cria uma reunião do Amazon Chime, a SDK reunião é atribuída a um serviço de mídia específico da região. Os hosts do serviço são responsáveis pela transferência segura de mídia em tempo real entre os clientes participantes. Cada participante criado recebe um token de participação exclusivo, uma chave secreta opaca que seu aplicativo de servidor deve transferir com segurança para o cliente autorizado a participar da reunião em nome de um participante. Cada cliente usa um token de participação para se autenticar com o grupo de serviços de mídia. Os clientes usam uma combinação de segurança WebSockets e Datagram Transport Layer Security (DTLS) para sinalizar com segurança o grupo de serviços de mídia e enviar e receber mídia de e para outros participantes por meio do grupo de serviços de mídia.
- Áudio
-
O serviço de mídia mistura o áudio de cada participante e envia a mixagem para cada destinatário, depois de subtrair seu próprio áudio da mixagem. O Amazon Chime SDKs coleta amostras de áudio na taxa mais alta suportada pelo dispositivo e pelo navegador, até um máximo de 48. kHz Usamos o codec Opus para codificar áudio, com uma taxa de bits padrão de 32 kbps, que pode ser aumentada para até 128 kbps estéreo e 64 kbps mono.
- Vídeo
-
O serviço de mídia atua como uma Unidade de Encaminhamento Seletivo (SFU) usando um modelo de publicação e assinatura. Cada participante pode publicar uma fonte de vídeo, até um total de 25 vídeos simultâneos por reunião. A biblioteca de SDK clientes do Amazon Chime JavaScript oferece suporte a resoluções de vídeo de até 1280x720 a 30 quadros por segundo sem transmissão simultânea e 15 quadros por segundo com transmissão simultânea. As bibliotecas de SDK cliente do Amazon Chime para iOS, Android e Windows oferecem suporte a resoluções de vídeo de até 1280x720 e 30 quadros por segundo. No entanto, a taxa de quadros e a resolução reais são gerenciadas automaticamente pelo Amazon Chime. SDK
Quando ativa, a transmissão simultânea de vídeo envia cada stream de vídeo em duas resoluções e taxas de bits diferentes. Clientes com restrições de largura de banda se inscrevem automaticamente no fluxo de menor taxa de bits. A codificação e decodificação de vídeo usam aceleração de hardware, quando disponível, para melhorar o desempenho.
- Mensagens de dados
Além do conteúdo de áudio e vídeo, os participantes da reunião podem enviar entre si mensagens de dados em tempo real de até 2 KB cada. Você pode usar mensagens para implementar atributos de reunião personalizados, como quadro branco, bate-papo, reações de emojis em tempo real e sinalização de controle de piso específica do aplicativo.
- Compartilhamento de conteúdo
-
O aplicativo do cliente pode compartilhar conteúdo de áudio e vídeo, como capturas de tela ou arquivos de mídia. O compartilhamento de conteúdo suporta vídeo de conteúdo pré-gravado de até 1280x720 a 15 quadros por segundo e áudio de até 48 a 64 kbps. kHz A captura de tela para compartilhamento de conteúdo é compatível com até 15 quadros por segundo, mas pode ser limitada pelos recursos do dispositivo e do navegador.
Cotas para o Amazon Chime SDK
As cotas para o serviço Amazon SDK Chime estão documentadas no. Referência geral da AWS Para obter mais informações, consulte SDKendpoints e cotas do Amazon Chime no. Referência geral da AWS
nota
As cotas de serviço são por API endpoint. Ao solicitar um aumento da cota de serviço, certifique-se de solicitar o aumento em todos os API endpoints que seu aplicativo usa.
Requisitos de sistema do Amazon Chime SDK
Os seguintes requisitos de sistema se aplicam aos aplicativos criados com o Amazon ChimeSDK.
Navegadores compatíveis, biblioteca de SDK cliente Amazon Chime para JavaScript
Sistema operacional | Navegador | Versões compatíveis | Observações |
---|---|---|---|
Windows |
Mozilla Firefox |
75 e versões posteriores |
|
Google Chrome |
78 e versões posteriores | ||
Edge baseado em Chromium |
79 e versões posteriores | ||
Electron baseado em Chromium | 7 e versões posteriores | Com Chrome versão 78 e versões posteriores. | |
Opera | 66 e versões posteriores | ||
macOS |
Mozilla Firefox |
75 e versões posteriores |
|
Google Chrome |
78 e versões posteriores | ||
Edge baseado em Chromium |
79 e versões posteriores | ||
Electron baseado em Chromium |
|||
Safari | 13 e versões posteriores | ||
Opera | 66 e versões posteriores | ||
iOS | Mozilla Firefox | 10 e versões posteriores | Somente áudio e vídeo, sem compartilhamento de conteúdo. |
Google Chrome | 78 e versões posteriores | Somente áudio e vídeo, sem compartilhamento de conteúdo. | |
Safari | 13 e versões posteriores | Somente áudio e vídeo, sem compartilhamento de conteúdo. | |
WKWebView | 14.3 e versões posteriores | Somente áudio e vídeo, sem compartilhamento de conteúdo. | |
Android | Google Chrome | 10 e versões posteriores | Somente áudio e vídeo, sem compartilhamento de conteúdo. |
Samsung | 12 e versões posteriores | Somente áudio e vídeo, sem compartilhamento de conteúdo. | |
Cromo WebView | 5 e versões posteriores | Somente áudio e vídeo, sem compartilhamento de conteúdo. | |
Ubuntu LTS 16.04 e versões posteriores | Google Chrome | 78 e versões posteriores |
Biblioteca de SDK cliente Amazon Chime para iOS
-
iOS versão 13 e versões posteriores
Biblioteca de SDK cliente Amazon Chime para Android
-
Sistema operacional Android versão 5 e posterior ARM e ARM64 arquitetura