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.
**Topics**
+ [Pré-requisitos para usar o SDK do Amazon Chime](#mtg-prereqs)
+ [Conceitos do SDK do Amazon Chime](#mtg-glossary)
+ [Arquitetura do SDK do Amazon Chime](#mtg-arch)
+ [Cotas do SDK do Amazon Chime](#mtg-limits)
+ [Requisitos do sistema do SDK do Amazon Chime](#mtg-browsers)
+ [Regiões da AWS disponíveis para o SDK do Amazon Chime](sdk-available-regions.md)
+ [Saiba mais sobre as bibliotecas de clientes do SDK do Amazon Chime](mtgs-sdk-client-lib.md)
+ [Noções básicas sobre a integração de SIP usando um Voice Connector do SDK do Amazon Chime](mtgs-sdk-cvc.md)
+ [Noções básicas sobre as notificações de eventos do SDK do Amazon Chime](mtgs-sdk-notifications.md)
+ [Como migrar do namespace do Amazon Chime](migrate-from-chm-namespace.md)
## Pré-requisitos para usar o 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](https://docs.aws.amazon.com/chime-sdk/latest/ag/security_iam_service-with-iam.html) e [Permitir que os usuários acessem as ações do SDK do Amazon Chime](https://docs.aws.amazon.com/chime-sdk/latest/ag/security_iam_id-based-policy-examples.html#security_iam_id-based-policy-examples-chime-sdk) 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`. O `MeetingId` é 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](sdk-for-ios.md), [Android](sdk-for-android.md) e [Windows](client-lib-windows.md) 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.
## Cotas do SDK do Amazon Chime
As cotas do serviço SDK do Amazon Chime estão documentadas na Referência geral da AWS. Para mais informações, consulte [Endpoints e quotas do SDK do Amazon Chime](https://docs.aws.amazon.com/general/latest/gr/chime-sdk.html) no *Referência geral da AWS*.
**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.
## 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**
- **Windows**
- **Navegador:** Mozilla Firefox / **Versões aceitas:** 75 e versões posteriores / **Observações:**
- **Navegador:** Google Chrome / **Versões aceitas:** 78 e versões posteriores / **Observações:**
- **Navegador:** Chromium-based Borda / **Versões aceitas:** 79 e versões posteriores / **Observações:**
- **Navegador:** Chromium-based Elétron / **Versões aceitas:** 7 e versões posteriores / **Observações:** Com Chrome versão 78 e versões posteriores.
- **Navegador:** Opera / **Versões aceitas:** 66 e versões posteriores / **Observações:**
- ** macOS **
- **Navegador:** Mozilla Firefox / **Versões aceitas:** 75 e versões posteriores / **Observações:**
- **Navegador:** Google Chrome / **Versões aceitas:** 78 e versões posteriores / **Observações:**
- **Navegador:** Chromium-based Borda / **Versões aceitas:** 79 e versões posteriores / **Observações:**
- **Navegador:** Chromium-based Elétron / **Versões aceitas:** / **Observações:**
- **Navegador:** Safari / **Versões aceitas:** 13 e versões posteriores / **Observações:**
- **Navegador:** Opera / **Versões aceitas:** 66 e versões posteriores / **Observações:**
- **iOS**
- **Navegador:** Mozilla Firefox / **Versões aceitas:** 10 e versões posteriores / **Observações:** Somente áudio e vídeo, sem compartilhamento de conteúdo.
- **Navegador:** Google Chrome / **Versões aceitas:** 78 e versões posteriores / **Observações:** Somente áudio e vídeo, sem compartilhamento de conteúdo.
- **Navegador:** Safari / **Versões aceitas:** 13 e versões posteriores / **Observações:** Somente áudio e vídeo, sem compartilhamento de conteúdo.
- **Navegador:** WKWebView / **Versões aceitas:** 14.3 e versões posteriores / **Observações:** Somente áudio e vídeo, sem compartilhamento de conteúdo.
- **Android**
- **Navegador:** Google Chrome / **Versões aceitas:** 10 e versões posteriores / **Observações:** Somente áudio e vídeo, sem compartilhamento de conteúdo.
- **Navegador:** Samsung / **Versões aceitas:** 12 e versões posteriores / **Observações:** Somente áudio e vídeo, sem compartilhamento de conteúdo.
- **Navegador:** Cromo WebView / **Versões aceitas:** 5 e versões posteriores / **Observações:** Somente áudio e vídeo, sem compartilhamento de conteúdo.
- **Ubuntu LTS 16.04 e versões posteriores**
- **Navegador:** Google Chrome
- **Versões aceitas:** 78 e versões posteriores
- **Observações:**
**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