# SDK de Mensagens para Clientes do Chat do IVS O Amazon Interactive Video Services (IVS) Chat Client Messaging SDK destina-se a desenvolvedores que estão criando aplicações com o Amazon IVS. Este SDK foi desenvolvido para aproveitar a arquitetura do Amazon IVS e receberá atualizações, juntamente com o Amazon IVS Chat. Na condição um SDK nativo, ele foi projetado para minimizar o impacto na performance em sua aplicação e nos dispositivos com os quais seus usuários acessam sua aplicação. ## Requisitos da plataforma ### Navegadores desktop | Navegador | Versões compatíveis | | --- | --- | | Chrome | Duas versões principais (versão anterior atual e mais recente) | | Borda | Duas versões principais (versão anterior atual e mais recente) | | Firefox | Duas versões principais (versão anterior atual e mais recente) | | Opera | Duas versões principais (versão anterior atual e mais recente) | | Safari | Duas versões principais (versão anterior atual e mais recente) | ### Navegadores móveis | Navegador | Versões compatíveis | | --- | --- | | Chrome para Android | Duas versões principais (versão anterior atual e mais recente) | | Firefox para Android | Duas versões principais (versão anterior atual e mais recente) | | Opera para Android | Duas versões principais (versão anterior atual e mais recente) | | WebView Android | Duas versões principais (versão anterior atual e mais recente) | | Internet da Samsung | Duas versões principais (versão anterior atual e mais recente) | | Safari para iOS | Duas versões principais (versão anterior atual e mais recente) | ### Plataformas nativas | Plataforma | Versões compatíveis | | --- | --- | | Android | 5.0 e posterior | | iOS | 13.0 e posterior | ## Suporte Em caso de erro ou outro problema com a sala de chat, determine o identificador exclusivo da sala via API do IVS Chat (consulte [ListRooms](https://docs.aws.amazon.com//ivs/latest/ChatAPIReference/API_ListRooms.html)). Compartilhe esse identificador de sala de transmissão com o AWS Support. Com ele, a equipe de suporte poderá obter informações para ajudar a solucionar seu problema. **Observação:** consulte as [Notas de versão do Chat do Amazon IVS](release-notes.md) para obter informações sobre versões disponíveis e problemas corrigidos. Se apropriado, antes de entrar em contato com o suporte, atualize sua versão do SDK de transmissão e veja se isso resolve seu problema. ### Versionamento Os SDKs do Amazon IVS Chat Client Messaging usam [versionamento semântico](https://semver.org/). Para esta discussão, suponha que: + A versão mais recente é 4.1.3. + A versão mais recente da versão principal anterior é 3.2.4. + A versão mais recente da versão 1.x é 1.5.6. Novos recursos compatíveis com versões anteriores são adicionados como versões secundárias da versão mais recente. Nesse caso, o próximo conjunto de novos recursos vai ser adicionado como versão 4.2.0. Compatíveis com versões anteriores, pequenas correções de bugs são adicionadas como lançamentos de patch da versão mais recente. Aqui, o próximo conjunto de pequenas correções de bugs vai ser adicionado como versão 4.1.4. Compatíveis com versões anteriores, as principais correções de bugs são tratadas de forma diferente; estas são adicionadas a várias versões: + Versão do patch da versão mais recente. Aqui, esta é a versão 4.1.4. + Lançamento do patch da versão secundária anterior. Aqui, esta é a versão 3.2.5. + Versão do patch da versão 1.x mais recente. Aqui, esta é a versão 1.5.7. As principais correções de bugs são definidas pela equipe de produtos do Amazon IVS. Exemplos típicos são atualizações de segurança críticas e outras correções selecionadas necessárias para os clientes. **Observação:** nos exemplos acima, versões lançadas incrementam sem ignorar nenhum número (por exemplo, de 4.1.3 para 4.1.4). Na realidade, um ou mais números de patch podem permanecer internos e não ser liberados, de modo que a versão lançada pode ser incrementada de 4.1.3 para, digamos, 4.1.6. Além disso, o suporte à versão 1.x será oferecido até o final de 2023 ou quando a versão 3.x for lançada, o que ocorrer por último. ## APIs do Amazon IVS Chat No lado do servidor (não gerenciado pelos SDKs), há duas APIs, cada uma com suas próprias responsabilidades: + **Plano de dados**: a [API de mensagens do IVS Chat](https://docs.aws.amazon.com//ivs/latest/chatmsgapireference/welcome.html) é uma API de WebSocket projetada para ser usada por aplicações front-end (iOS, Android, macOS, etc.) que são acionadas por um esquema de autenticação baseado em tokens. Usando um token de chat gerado anteriormente, é possível se conectar a salas de chat já existentes usando essa API. *Os Amazon IVS Chat Client Messaging SDKs atuam somente no plano de dados. Os SDKs presumem que você já está gerando tokens de chat por meio do seu backend. Supõe-se que a recuperação desses tokens seja gerenciada pela aplicação front-end, e não pelos SDKs.* + **Ambiente de gerenciamento**: a [API de ambiente de gerenciamento do IVS Chat](https://docs.aws.amazon.com//ivs/latest/ChatAPIReference/Welcome.html) fornece uma interface para suas próprias *aplicações de backend* para gerenciar e criar salas de chat, bem como os usuários que se juntam a elas. Pense nisso como o painel de administração da experiência de chat da sua aplicação, gerenciado pelo *seu próprio backend*. Existem operações do ambiente de gerenciamento que são responsáveis por criar o *token de chat* de que o plano de dados precisa para ser autenticado em uma sala de chat. **Importante:** *os IVS Chat Client Messaging SDKs não chamam nenhuma operações do plano de ambiente de gerenciamento. O backend deve ser configurado para criar tokens de chat para você. A aplicação front-end deve se comunicar com o backend para recuperar esse token de chat.*