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á.
Como usar o SDK do Amazon Chime
Você usa o SDK do Amazon Chime 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 SDK do Amazon Chime 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 SDK do Amazon Chime fornece ferramentas de criação que você usa para criar seus próprios aplicativos de reunião.
Tópicos
- Pré-requisitos do SDK do Amazon Chime
- Conceitos do SDK do Amazon Chime
- Arquitetura do SDK do Amazon Chime
- Service quotas do SDK do Amazon Chime
- Requisitos do sistema do SDK do Amazon Chime
- Regiões disponíveis
- Integração com uma biblioteca de cliente
- Integração SIP usando um conector de voz do SDK do Amazon Chime
- Notificações de eventos do SDK do Amazon Chime
- Como migrar do namespace do Amazon Chime
Pré-requisitos do SDK do Amazon Chime
O uso do SDK do Amazon Chime necessita do seguinte:
A capacidade de programar.
Uma AWS conta.
Uma função do IAM com uma política que concede permissão para acessar as ações da API do Amazon Chime usadas pelo SDK do Amazon Chime, como AWS a política de SDK gerenciado. AmazonChime Para mais informações, consulte Como o Amazon Chime funciona com o IAM e Permitir que os usuários acessem as ações do SDK do Amazon Chime no Guia do administrador do SDK do Amazon Chime.
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 à função do IAM 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 do SDK do Amazon Chime
Os seguintes conceitos e terminologia são fundamentais para o entendimento e uso do SDK do Amazon 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 de URLs regionalizados 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 do cliente criado com uma biblioteca de cliente do SDK do Amazon 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 do SDK do Amazon Chime
A lista a seguir descreve como os diferentes componentes da arquitetura do SDK do 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 SDK do Amazon Chime, a 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. Os SDKs do Amazon Chime coletam 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 cliente do Amazon Chime SDK JavaScript suporta 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 cliente do SDK 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 SDK do Amazon Chime.
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 pré-gravado de até 1280x720 a 15 quadros por segundo e áudio de até 48kHz a 64kbps. 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.
Service quotas do SDK do Amazon Chime
nota
Os service quotas são por endpoint da API. Ao solicitar um aumento do service quota, certifique-se de solicitar o aumento em todos os endpoints da API que seu aplicativo usa.
Esta tabela que lista os recursos e as cotas disponíveis para reuniões do SDK do Amazon Chime.
| Recurso | Cota | Ajustável |
|---|---|---|
Reuniões ativas |
250 |
Sim |
|
Participantes por reunião |
250 |
Não |
|
Transmissões de áudio por reunião |
250 |
Não |
|
Transmissões de vídeo publicadas por reunião |
25 |
Sim, até 250 |
|
Transmissões de vídeo inscritas por participante |
25 |
Não |
|
Compartilhamentos de conteúdo por reunião |
2 |
Não |
| Reuniões de réplica por reunião principal | 4 | Sim, até 40 |
Pipelines de captura de mídia ativa por reunião |
1 |
Não |
Pipelines de captura de mídia ativa por conta |
100 para endpoints us-east-1 e 10 para outros endpoints |
Sim |
|
Taxa de API |
10 solicitações por segundo (RPS) com uma intermitência de 20 RPS. |
Sim, mas indiretamente notaOs limites de taxa de API aumentam quando você aumenta a cota de reuniões ativas. |
Requisitos do sistema do SDK do Amazon Chime
Os seguintes requisitos de sistema se aplicam aos aplicativos criados com o SDK do Amazon Chime.
Navegadores compatíveis, biblioteca de cliente Amazon Chime SDK 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. | |
| WK WebView | 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 cliente do SDK do Amazon Chime para iOS
-
iOS versão 13 e versões posteriores
Biblioteca de cliente do SDK do Amazon Chime para Android
-
Android OS versão 5 e versões posteriores, arquitetura ARM e ARM64
