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 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 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. O Amazon Chime faz a SDKs amostragem 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** [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/chime-sdk/latest/dg/meetings-sdk.html) **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** + Sistema operacional Android versão 5 e posterior, ARM e ARM64 arquitetura # Regiões da AWS disponíveis para o SDK do Amazon Chime As tabelas a seguir listam os recursos do serviço Amazon Chime SDK e as AWS regiões que fornecem cada serviço. **nota** As regiões marcadas com um asterisco (**\$1**) devem estar habilitadas em sua AWS conta. AWS bloqueia essas regiões por padrão. Para obter mais informações sobre como ativar regiões, consulte [Especificar quais AWS regiões sua conta pode usar](https://docs.aws.amazon.com/accounts/latest/reference/manage-acct-regions.html), na *Referência de gerenciamento de AWS contas*. **Topics** + [Regiões do console](#sdk-console-regions) + [Regiões de análise de chamadas](#call-analytics-regions) + [Regiões de reunião](#sdk-meeting-regions) + [Regiões do pipeline de mídia](#sdk-media-pipelines) + [Regiões de mensagens](#sdk-messaging-regions) + [Regiões de voz](#voice-regions) ## Regiões do console Você usa o console do SDK do Amazon Chime para configurar recursos e aprender mais sobre o serviço do SDK do Amazon Chime. | **AWS Região** | **Console** | | --- | --- | | Ásia-Pacífico (Seul) | Sim | | Ásia-Pacífico (Singapura) | Sim | | Ásia-Pacífico (Sydney) | Sim | | Ásia Pacific (Tóquio) (ap-northeast-1) | Sim | | Canadá (Central) (ca-central-1) | Sim | | Europa (Frankfurt) (eu-central-1) | Sim | | Europa (Irlanda) (eu-west-1) | Sim | | Europa (Londres) (eu-west-2) | Sim | | Leste dos EUA (Norte da Virgínia) (us-east-1) | Sim | | Oeste dos EUA (Oregon) (us-west-2) | Sim | ## Regiões de análise de chamadas A tabela a seguir lista as AWS regiões disponíveis para análise, transcrição e gravação de chamadas. | **AWS Região** | **Análise de voz** | **Transcrição** | **Gravação de chamadas** | | --- | --- | --- | --- | | Leste dos EUA (Norte da Virgínia) (us-east-1) | Sim | Sim | Sim | | Oeste dos EUA (Oregon) (us-west-2) | Sim | Sim | Sim | | Europa (Frankfurt) (eu-central-1) | Não | Sim | Sim | ## Regiões de reunião As reuniões do SDK do Amazon Chime têm *regiões de controle* e *regiões de mídia*. Uma região de controle fornece o endpoint da API usado para criar, atualizar e excluir reuniões. As regiões de controle também recebem e processam [Noções básicas sobre eventos do ciclo de vida de reuniões do SDK do Amazon Chime](using-events.md). As regiões de mídia organizam as reuniões reais e os clientes se conectam às suas regiões de mídia. É possível especificar a região de mídia ao chamar a API [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_meeting-chime_CreateMeeting.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_meeting-chime_CreateMeeting.html). Uma região de controle pode criar uma reunião em qualquer região de mídia na mesma AWS partição. No entanto, você só pode atualizar uma reunião na região de controle usada para criar a reunião. Para mais informações sobre como selecionar as regiões de controle e mídia, consulte [Usar regiões de reuniões para reuniões do SDK do Amazon Chime](chime-sdk-meetings-regions.md). A tabela a seguir lista as regiões que fornecem controle, mídia ou ambos. | **AWS Região** | **Controle de reuniões** | **Mídia de reuniões** | | --- | --- | --- | | África (Cidade do Cabo) (af-south-1)**\$1** | Sim \$1\$1 | Sim | | Ásia-Pacífico (Mumbai) (ap-south-1) | Sim | Sim | | Ásia-Pacífico (Seul) (ap-northeast-2) | Sim | Sim | | Ásia-Pacífico (Singapura) (ap-southeast-1) | Sim | Sim | | Ásia-Pacífico (Sydney) (ap-southeast-2) | Sim | Sim | | Ásia Pacific (Tóquio) (ap-northeast-1) | Sim | Sim | | Canadá (Central) (ca-central-1) | Sim | Sim | | Europa (Frankfurt) (eu-central-1) | Sim | Sim | | Europa (Irlanda) (eu-west-1) | | Sim | | Europa (Londres) (eu-west-2) | Sim | Sim | | Europa (Milão) (eu-south-1)**\$1** | | Sim | | Europa (Paris) (eu-west-3) | | Sim | | UE (Estocolmo) (eu-north-1) | | Sim | | Israel (Tel Aviv) (il-central-1)**\$1** | Sim**\$1\$1** | Sim | | América do Sul (São Paulo) (sa-east-1) | | Sim | | Leste dos EUA (Ohio) (us-east-2) | | Sim | | Leste dos EUA (Norte da Virgínia) (us-east-1) | Sim | Sim | | Oeste dos EUA (Norte da Califórnia) (us-west-1) | | Sim | | Oeste dos EUA (Oregon) (us-west-2) | Sim | Sim | | AWS GovCloud (Leste dos EUA) (us-gov-east-1) | Sim | Sim | | AWS GovCloud (Oeste dos EUA) (us-gov-west-1) | Sim | Sim | **\$1** Você deve habilitar essas regiões em sua AWS conta. Para mais informações, consulte [Habilitar uma região](https://docs.aws.amazon.com/general/latest/gr/rande-manage.html#rande-manage-enable) na *Referência geral da AWS *. **\$1\$1**As reuniões que usam o controle de reuniões nesta região só podem hospedar mídia nessa região. **nota** Para criar uma reunião em uma região AWS GovCloud (EUA), você deve usar uma região de controle em GovCloud. Além disso, as regiões de controle em só GovCloud podem fazer reuniões nas regiões AWS GovCloud (EUA). ## Regiões do pipeline de mídia Os pipelines de mídia do SDK do Amazon Chime têm *regiões de controle* e *regiões de mídia*. Uma região de controle fornece o endpoint da API do pipeline de mídia usado para criar e excluir pipelines de mídia. Você também usa regiões de controle para receber e processar [eventos de pipeline de mídia](media-pipe-events.md). As regiões de mídia administram seus canais de mídia, e o sistema seleciona automaticamente a mesma região de mídia da reunião. Você pode usar uma região de controle para criar um pipeline de mídia em qualquer região de dados. O pipeline de mídia pode participar de uma reunião em qualquer região de mídia de reunião. | **AWS Região** | **Controle** | **Mídia** | | --- | --- | --- | | África (Cidade do Cabo) (af-south-1)**\$1** | | Sim | | Ásia-Pacífico (Mumbai) (ap-south-1) | Sim | Sim | | Ásia-Pacífico (Seul) (ap-northeast-2) | Sim | Sim | | Ásia-Pacífico (Singapura) (ap-southeast-1) | Sim | Sim | | Ásia-Pacífico (Sydney) (ap-southeast-2) | Sim | Sim | | Ásia Pacific (Tóquio) (ap-northeast-1) | Sim | Sim | | Canadá (Central) (ca-central-1) | Sim | Sim | | Europa (Frankfurt) (eu-central-1) | Sim | Sim | | Europa (Irlanda) (eu-west-1) | | Sim | | Europa (Londres) (eu-west-2) | Sim | Sim | | Europa (Milão) (eu-south-1)**\$1** | | Sim | | Europa (Paris) (eu-west-3) | | Sim | | UE (Estocolmo) (eu-north-1) | | Sim | | América do Sul (São Paulo) (sa-east-1) | | Sim | | Leste dos EUA (Ohio) (us-east-2) | | Sim | | Leste dos EUA (Norte da Virgínia) (us-east-1) | Sim | Sim | | Oeste dos EUA (Norte da Califórnia) (us-west-1) | | Sim | | Oeste dos EUA (Oregon) (us-west-2) | Sim | Sim | **\$1** Você deve habilitar essas regiões em sua AWS conta. Para mais informações, consulte [Habilitar uma região](https://docs.aws.amazon.com/general/latest/gr/rande-manage.html#rande-manage-enable) na *Referência geral da AWS *. ## Regiões de mensagens O sistema de mensagens do SDK do Amazon Chime tem *regiões de controle* e *regiões de dados*. A região de controle expõe o endpoint da API de mensagens e a região de dados armazena as mensagens. Se você usa o Amazon Kinesis para transmitir dados de mensagens ou AWS Lambda funções para fluxos de canais, eles devem residir na região de controle. | **AWS Região** | **Controle** | **Dados** | | --- | --- | --- | | Europa (Frankfurt) (eu-central-1) | Sim | Sim | | Leste dos EUA (Norte da Virgínia) (us-east-1) | Sim | Sim | ## Regiões de voz Os recursos SIP (Session Initiation Protocol) do SDK do Amazon Chime têm *regiões de API*, *regiões de mídia* e *regiões PSTN*. As regiões da API fornecem os endpoints da API para criar e configurar atributos SIP. As regiões de mídia contêm conectores de voz do SDK do Amazon Chime e aplicativos de mídia SIP. As regiões PSTN permitem que os clientes conectem sistemas telefônicos on-premises à rede telefônica pública. Além disso, as regiões PSTN oferecem suporte ao provisionamento e gerenciamento de números de telefone. | **AWS Região** | **API** | **Mídia** | **PSTN** | | --- | --- | --- | --- | | Ásia-Pacífico (Seul) (ap-northeast-2) | Sim | Sim | | | Ásia-Pacífico (Singapura) (ap-southeast-1) | Sim | Sim | | | Ásia-Pacífico (Sydney) (ap-southeast-2) | Sim | Sim | | | Ásia Pacific (Tóquio) (ap-northeast-1) | Sim | Sim | | | Canadá (Central) (ca-central-1) | Sim | Sim | | | Europa (Frankfurt) (eu-central-1) | Sim | Sim | | | Europa (Irlanda) (eu-west-1) | Sim | Sim | | | Europa (Londres) (eu-west-2) | Sim | Sim | | | Leste dos EUA (Norte da Virgínia) (us-east-1) | Sim | Sim | Sim**\$1** | | Oeste dos EUA (Oregon) (us-west-2) | Sim | Sim | Sim **\$1** | **\$1** Consulte a página de [preços do Amazon Chime SDK](https://aws.amazon.com/chime/chime-sdk/pricing/) para obter informações sobre a disponibilidade de números de telefone em regiões específicas. AWS # Saiba mais sobre as bibliotecas de clientes do SDK do Amazon Chime Antes de criar clientes de reunião em tempo real com o SDK do Amazon Chime, você deve integrar seu aplicativo de cliente a uma biblioteca de cliente do SDK do Amazon Chime. As seguintes bibliotecas de cliente estão disponíveis: + [Biblioteca de cliente do SDK do Amazon Chime para Android](https://github.com/aws/amazon-chime-sdk-android): Uma biblioteca Kotlin que ajuda você a criar aplicativos do SDK do Amazon Chime em dispositivos Android compatíveis. + [Biblioteca de cliente de sinalização do SDK do Amazon Chime para C\$1\$1](https://github.com/aws/amazon-chime-sdk-cpp/tree/main/chime-sdk-signaling-cpp): uma biblioteca C\$1\$1 que ajuda você a configurar conexões de sinalização para reuniões do SDK do Amazon Chime em dispositivos incorporados. + [Biblioteca de cliente do SDK do Amazon Chime para iOS](https://github.com/aws/amazon-chime-sdk-ios): uma biblioteca Swift que ajuda você a criar aplicativos do SDK do Amazon Chime em dispositivos iOS compatíveis. + [Biblioteca cliente do Amazon Chime SDK para JavaScript ([NPM](https://www.npmjs.com/package/amazon-chime-sdk-js)) — Uma JavaScript biblioteca](https://github.com/aws/amazon-chime-sdk-js) com definições de TypeScript tipo que ajuda você a criar aplicativos do Amazon Chime SDK em navegadores habilitados para WebRTC. + [Biblioteca de cliente do SDK do Amazon Chime para Windows](https://github.com/aws/amazon-chime-sdk-cpp). Uma biblioteca C\$1\$1 que ajuda você a criar aplicativos do SDK do Amazon Chime em dispositivos compatíveis. Para saber como integrar seu aplicativo de cliente ao SDK do Amazon Chime, consulte as ações nos arquivos `README.md` da biblioteca de cliente. Use as demonstrações para aprender como criar componentes de mídia específicos para seu aplicativo. # Noções básicas sobre a integração de SIP usando um Voice Connector do SDK do Amazon Chime Integre sua infraestrutura de voz compatível com SIP com um conector de voz do SDK do Amazon Chime para fazer chamadas de voz SIP. Você deve usar as regiões `us-east-1` ou `us-east-2`. Você deve ter um IP PBX (Private Branch Exchange), SBC (Session Border Controller) ou outra infraestrutura de voz com acesso à Internet compatível com SIP (Session Initiation Protocol). Para mais informações, consulte [Antes de começar](https://docs.aws.amazon.com/chime-sdk/latest/ag/voice-connectors.html#vc-prereq) no *Guia do administrador do SDK do Amazon Chime*. **Para integrar sua infraestrutura de voz** 1. Crie um conector de voz Amazon Chime SDK em sua conta. AWS Para mais informações, consulte [Criando um conector de voz do SDK do Amazon Chime](https://docs.aws.amazon.com/chime-sdk/latest/ag/voice-connectors.html#create-voicecon) no *Guia do administrador do SDK do Amazon Chime*. 1. Edite as configurações do conector de voz do SDK do Amazon Chime para permitir chamadas da sua infraestrutura de voz para a AWS. Para mais informações, consulte [Como editar as configurações do conector de voz do SDK do Amazon Chime](https://docs.aws.amazon.com/chime-sdk/latest/ag/voice-connectors.html#edit-voicecon) no *Guia do administrador do SDK do Amazon Chime*. 1. Em **Configurações de encerramento**, selecione **Habilitado**. 1. Em **Lista de permissões**, escolha **Nova**. 1. Insira as anotações CIDR dos endereços IP da sua infraestrutura SIP interna. Isso permite que sua infraestrutura acesse o conector de voz do SDK do Amazon Chime. Por exemplo, para permitir o tráfego do endereço IP `10.24.34.0`, liste a notação CIDR na lista de permissões `10.24.34.0/32`. 1. Escolha **Adicionar**. 1. Para **Plano de chamadas**, selecione o país ou os países a serem adicionados a esse plano. 1. Edite todas as outras configurações conforme necessário e escolha **Salvar**. 1. No console do SDK do Amazon Chime, em **Conectores de voz**, visualize o **nome do host de saída** do seu conector de voz do SDK do Amazon Chime. Por exemplo, *abcdef1ghij2klmno3pqr4* .voiceconnector.chime.aws. 1. Para participar de uma reunião usando o SDK do Amazon Chime, use um URI do SIP para fazer uma solicitação SIP para o **nome do host de saída** do seu conector de voz do SDK do Amazon Chime. Use o número de telefone **\$117035550122** no URI do SIP. Use o parâmetro `transport` para usar o protocolo TLS. Por fim, use o token de junção exclusivo gerado ao chamar o [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_meeting-chime_CreateAttendee.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_meeting-chime_CreateAttendee.html)Ação da API. Para obter mais informações, veja o exemplo a seguir. **Example Exemplo: solicitação SIP** O exemplo a seguir mostra o conteúdo de um URI do SIP usado para fazer uma solicitação SIP a um conector de voz do SDK do Amazon Chime. ``` sip:+17035550122@abcdef1ghij2klmno3pqr4.voiceconnector.chime.aws;transport=tls;X-chime-join-token=join-token ``` O exemplo a seguir mostra um exemplo de mensagem SIP INVITE para participar de uma reunião do SDK do Amazon Chime. ``` INVITE sip:+17035550122@abcdef1ghij2klmno3pqr4.voiceconnector.chime.aws;transport=tls;X-chime-join-token=join-token SIP/2.0 Via: SIP/2.0/TLS IPaddress:12345;rport;branch=branch;alias Max-Forwards: 70 From: sip:+12065550100@IPaddress;tag=tag To: sip:+17035550122@abcdef1ghij2klmno3pqr4.voiceconnector.chime.aws;X-chime-join-token=join-token Contact: Call-ID: a1234567-89b0-1c2d-e34f-5gh678j9k2lm CSeq: 6214 INVITE Allow: PRACK, INVITE, ACK, BYE, CANCEL, UPDATE, INFO, SUBSCRIBE, NOTIFY, REFER, MESSAGE, OPTIONS Supported: replaces, 100rel, timer, norefersub Session-Expires: 1800 Min-SE: 90 Content-Type: application/sdp Content-Length: 991 v=0 o=- 3775321410 3775321410 IN IP4 IPaddress s=pjmedia b=AS:117 t=0 0 a=X-nat:0 m=audio 4000 RTP/SAVP 0 3 8 9 125 101 c=IN IP4 IPaddress b=TIAS:96000 a=rtcp:4001 IN IP4 IPaddress a=sendrecv a=rtpmap:0 PCMU/8000 a=rtpmap:3 GSM/8000 a=rtpmap:8 PCMA/8000 a=rtpmap:9 G722/8000 a=rtpmap:125 opus/48000/2 a=fmtp:125 useinbandfec=1 a=rtpmap:101 telephone-event/8000 a=fmtp:101 0-16 a=crypto:1 AEAD_AES_256_GCM inline:EXAMPLE a=crypto:2 AEAD_AES_256_GCM_8 inline:EXAMPLE a=crypto:3 AES_256_CM_HMAC_SHA1_80 inline:EXAMPLE a=crypto:4 AES_256_CM_HMAC_SHA1_32 inline:EXAMPLE a=crypto:5 AES_CM_128_HMAC_SHA1_80 inline:EXAMPLE a=crypto:6 AES_CM_128_HMAC_SHA1_32 inline:EXAMPLE ``` **nota** O SDK do Amazon Chime reconhece números de telefone somente no formato E.164. Certifique-se de que um número de telefone E.164 esteja em seu cabeçalho `From`. # Noções básicas sobre as notificações de eventos do SDK do Amazon Chime O Amazon Chime SDK suporta o envio de notificações de eventos de reuniões para a Amazon, Amazon Simple Queue Service (SQS) EventBridge, Amazon Simple Queue Service (SQS) e Amazon Simple Notification Service (SNS). **nota** O namespace de reuniões do SDK do Amazon Chime padrão usa os endpoints `ChimeSDKMeetings`. O namespace Chime legado usa um único endpoint. Para ter mais informações sobre os namespaces e os endpoints, consulte [Migrar para o namespace de reuniões do SDK do Amazon Chime](meeting-namespace-migration.md) no início deste guia. ## Enviando notificações para EventBridge Você pode enviar notificações de eventos do Amazon Chime SDK para. EventBridge *Para obter informações detalhadas sobre o uso do Amazon Chime SDK com EventBridge, consulte [Automatizar o Amazon Chime SDK com o Amazon Chime SDK EventBridge no Guia do administrador do Amazon Chime SDK](https://docs.aws.amazon.com/chime-sdk/latest/ag/automating-chime-with-cloudwatch-events.html#events-sdk).* Para obter informações sobre EventBridge, consulte o [Guia EventBridge do usuário da Amazon](https://docs.aws.amazon.com/eventbridge/latest/userguide/). ## Como enviar notificações para o Amazon SQS e o Amazon SNS É possível usar a API [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_meeting-chime_CreateMeeting.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_meeting-chime_CreateMeeting.html) na *Referência de API do SDK do Amazon Chime* para enviar notificações de eventos de reunião do SDK do Amazon Chime a uma fila do Amazon SQS e um tópico do Amazon SNS por reunião. Isso pode ajudar a reduzir a latência das notificações. Para obter mais informações sobre o Amazon SQS, consulte o [Guia do desenvolvedor do Amazon Simple Queue Service](https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/). Para obter mais informações sobre tópicos do Amazon SNS, consulte o [Guia do desenvolvedor do Amazon Simple Notification Service](https://docs.aws.amazon.com/sns/latest/dg/). As notificações enviadas para o Amazon SQS e o Amazon SNS contêm as mesmas informações que as notificações para as quais o SDK do Amazon Chime envia. EventBridge O SDK do Amazon Chime suporta o envio de notificações de eventos de reuniões para filas e tópicos na região da API usados para criar uma reunião. As notificações de eventos podem ser entregues fora da ordem de ocorrência. ## Como conceder ao SDK do Amazon Chime acesso ao Amazon SQS e ao Amazon SNS Antes que o SDK do Amazon Chime possa enviar notificações por meio de uma fila do Amazon SQS ou tópico do Amazon SNS, você deve conceder ao SDK do Amazon Chime permissão para publicar mensagens no nome do recurso da Amazon (ARN) da fila ou do tópico. Para fazer isso, anexe uma política AWS Identity and Access Management (IAM) à fila ou ao tópico que conceda as permissões apropriadas ao SDK do Amazon Chime. Para obter mais informações, consulte [Gerenciamento de identidade e acesso no Amazon SQS](https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-authentication-and-access-control.html) no *Guia do desenvolvedor do Amazon Simple Queue Service* e [Casos de exemplo para controle de acesso do Amazon SNS](https://docs.aws.amazon.com/sns/latest/dg/sns-access-policy-use-cases.html) no *Guia do desenvolvedor do Amazon Simple Notification Service*. **nota** Sua fila do Amazon SQS ou tópico do Amazon SNS deve usar a mesma região do AWS seu endpoint da API Amazon Chime SDK. **Example Permita que o SDK do Amazon Chime publique eventos em uma fila do Amazon SQS** O exemplo de política do IAM a seguir concede ao SDK do Amazon Chime permissão para publicar notificações de eventos de reuniões na fila especificada do Amazon SQS. Observe a declaração condicional para `aws:SourceArn` e `aws:SourceAccount`. Eles abordam possíveis problemas [Confused Deputy](https://docs.aws.amazon.com/IAM/latest/UserGuide/confused-deputy.html). + Você pode usar `aws:SourceArn` ou `aws:SourceAccount` ao criar as políticas abaixo. Não é necessário usar ambos. + Esses exemplos usam o namespace `ChimeSDKMeetings` e o endpoint correspondente. Se você usar o namespace `Chime`, deverá usar o endpoint `chime.amazonaws.com`. **** ``` { "Version":"2012-10-17", "Id": "example-ID", "Statement": [ { "Sid": "example-statement-ID", "Effect": "Allow", "Principal": { "Service": "meetings.chime.amazonaws.com" }, "Action": [ "sqs:SendMessage", "sqs:GetQueueUrl" ], "Resource": "arn:aws:sqs:us-east-1:111122223333:queueName", "Condition": { "ArnLike": { "aws:SourceArn": "arn:aws:chime:us-east-1:111122223333:*" }, "StringEquals": { "aws:SourceAccount": "111122223333" } } } ] } ``` Este exemplo mostra uma política do Amazon SNS que permite que o SDK do Amazon Chime envie notificações de eventos de reuniões para seu tópico do SNS. **** ``` { "Version":"2012-10-17", "Id": "example-ID", "Statement": [ { "Sid": "allow-chime-sdk-access-statement-id", "Effect": "Allow", "Principal": { "Service": "meetings.chime.amazonaws.com" }, "Action": [ "SNS:Publish" ], "Resource": "arn:aws:sns:us-east-1:111122223333:topicName", "Condition": { "ArnLike": { "aws:SourceArn": "arn:aws:chime:us-east-1:111122223333:*" }, "StringEquals": { "aws:SourceAccount": "111122223333" } } } ] } ``` Se a fila do Amazon SQS estiver habilitada para criptografia do lado do servidor (SSE), é necessário realizar uma etapa adicional. Anexe uma política do IAM à AWS KMS chave associada que concede ao SDK do Amazon Chime permissão para as AWS KMS ações necessárias para criptografar dados adicionados à fila. **** ``` { "Version":"2012-10-17", "Id": "example-ID", "Statement": [ { "Sid": "example-statement-ID", "Effect": "Allow", "Principal": { "Service": "meetings.chime.amazonaws.com" }, "Action": [ "kms:GenerateDataKey", "kms:Decrypt" ], "Resource": "*" } ] } ``` **Example Permita que o SDK do Amazon Chime publique eventos em um tópico do Amazon SNS** O exemplo de política do IAM a seguir concede ao SDK do Amazon Chime permissão para publicar notificações de eventos de reuniões no tópico especificado do Amazon SNS. **** ``` { "Version":"2012-10-17", "Id": "example-ID", "Statement": [ { "Sid": "allow-chime-sdk-access-statement-id", "Effect": "Allow", "Principal": { "Service": "meetings.chime.amazonaws.com" }, "Action": [ "SNS:Publish" ], "Resource": "arn:aws:sns:us-east-1:111122223333:topicName", "Condition": { "ArnLike": { "aws:SourceArn": "arn:aws:chime:us-east-1:111122223333:*" }, "StringEquals": { "aws:SourceAccount": "111122223333" } } } ] } ``` # Como migrar do namespace do Amazon Chime O Amazon Chime SDK é exposto APIs em um conjunto de endpoints. Embora você possa fazer solicitações HTTPS diretamente para os endpoints, muitos clientes usam o AWS SDK em seus aplicativos para chamar o serviço. APIs O AWS SDK está disponível em diferentes linguagens e simplifica a chamada de API ao encapsular a assinatura da solicitação e a lógica de repetição. O AWS SDK inclui um namespace para cada endpoint de serviço. Quando lançado pela primeira vez, o SDK do Amazon Chime compartilhou um único endpoint com o aplicativo do Amazon Chime. Como resultado, as soluções usaram o `Chime` namespace no AWS SDK para chamar o aplicativo Amazon Chime e o Amazon Chime SDK. APIs O SDK do Amazon Chime agora fornece endpoints dedicados para cada subserviço, como reuniões e áudio PSTN. Cada endpoint é endereçável por meio de um namespace dedicado no SDK. AWS Os tópicos a seguir listam os serviços, namespaces e endpoints e descrevem como usá-los no código e com a CLI. AWS **Topics** + [Endpoints, namespaces e comandos da CLI](#endpoint-namespace-cli) + [Ajuda de migração de cada serviço](#help-per-service) + [Mapeamento de API](#name-end-map) ## Endpoints, namespaces e comandos da CLI A tabela a seguir lista os namespaces, endpoints e comandos da CLI dedicados do SDK do Amazon Chime. Os links levam você a mais informações sobre cada serviço. | Endpoint | AWS Namespace do SDK | AWS CLI DO SDK | | --- | --- | --- | | [identity-chime](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_Operations_Amazon_Chime_SDK_Identity.html) | Carrilhão SDKIdentity | [https://docs.aws.amazon.com/cli/latest/reference/chime-sdk-identity/index.html](https://docs.aws.amazon.com/cli/latest/reference/chime-sdk-identity/index.html) | | [media-pipelines-chime](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_Operations_Amazon_Chime_SDK_Media_Pipelines.html) | Tubulações de carrilhão SDKMedia | [https://docs.aws.amazon.com/cli/latest/reference/chime-sdk-media-pipelines/index.html](https://docs.aws.amazon.com/cli/latest/reference/chime-sdk-media-pipelines/index.html) | | [meetings-chime](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_Operations_Amazon_Chime_SDK_Meetings.html) | Carrilhão SDKMeetings | [https://docs.aws.amazon.com/cli/latest/reference/chime-sdk-meetings/index.html](https://docs.aws.amazon.com/cli/latest/reference/chime-sdk-meetings/index.html) | | [messaging-chime](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_Operations_Amazon_Chime_SDK_Messaging.html) | Carrilhão SDKMessaging | [https://docs.aws.amazon.com/cli/latest/reference/chime-sdk-messaging/index.html](https://docs.aws.amazon.com/cli/latest/reference/chime-sdk-messaging/index.html) | | [voice-chime](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_Operations_Amazon_Chime_SDK_Voice.html) | Carrilhão SDKVoice | [https://docs.aws.amazon.com/cli/latest/reference/chime-sdk-voice/index.html](https://docs.aws.amazon.com/cli/latest/reference/chime-sdk-voice/index.html) | ## Ajuda de migração de cada serviço Todos os clientes devem considerar o uso de endpoints dedicados do Amazon Chime SDK para acessar os recursos e regiões mais recentes do Amazon Chime SDK. APIs AWS Se você usa o endpoint compartilhado com o namespace `Chime`, os guias de migração a seguir podem ajudar a entender as diferenças técnicas antes da migração. + [Migração para o namespace Amazon Chime SDKIdentity ](identity-namespace-migration.md) + [Migração para o namespace Amazon SDKMedia Chime Pipelines](migrate-pipelines.md) + [Migração para o namespace Amazon Chime SDKMeetings ](meeting-namespace-migration.md) + [Migração para o namespace Amazon Chime SDKMessaging ](messaging-namespace-migration.md) + [Migração para o namespace Amazon Chime SDKVoice ](voice-namespace-migration.md) ## Mapeamento de API A tabela a seguir lista os APIs no `Chime` namespace e seus namespaces dedicados correspondentes e. APIs Alguns dos dedicados APIs diferem do `Chime` APIs, e a tabela indica essas instâncias. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/chime-sdk/latest/dg/migrate-from-chm-namespace.html) **\$1** A API foi substituída por uma API com outro nome. **\$1 **A API não está mais disponível.