sendbird chat sdk android
v4.21.1
O Sendbird Chat SDK para Android permite adicionar bate-papo em tempo real ao seu aplicativo cliente com o mínimo de esforço. Sendbird oferece uma solução de bate-papo rica em recursos, escalonável e comprovada, da qual empresas como Reddit, Hinge, PubG e Paytm dependem.
O Chat SDK fornece funcionalidade completa para fornecer uma experiência de chat rica. A implementação começa adicionando um login de usuário, listando os canais disponíveis, selecionando ou criando um canal aberto ou canal de grupo e recebendo mensagens e outros eventos por meio de delegados de eventos de canal e o capacidade de enviar uma mensagem. Assim que esta funcionalidade básica estiver implementada, parabéns, agora você tem um aplicativo de bate-papo!
Uma vez implementado, dê uma olhada em todos os outros recursos suportados pelo Sendbird e adicione o que funciona melhor para seus usuários.
Saiba mais sobre o Sendbird Chat para Android na documentação. Se você tiver algum comentário, dúvida ou solicitação de recurso, informe-nos na comunidade Sendbird.
Os requisitos mínimos para o Chat SDK para Android são:
Android 5.0 (API level 21) or higherJava 8 or higherAndroid Gradle plugin 3.4.2 or higherFirebase Cloud Messaging 19.0.1 or higherNota : O servidor Sendbird suporta Transport Layer Security (TLS) da versão 1.0 até 1.3. Por exemplo, nas regiões de servidor onde o TLS 1.3 não está disponível, versões inferiores, sequencialmente de 1.2 a 1.0, serão suportadas para transmissão segura de dados.
A maneira mais rápida de começar é usar um dos aplicativos de amostra do repositório de amostras, criar um aplicativo no painel Sendbird e copiar o App ID para o aplicativo de amostra e você estará pronto para começar.
Antes de instalar o Sendbird Chat SDK, você precisa criar um aplicativo Sendbird no Sendbird Dashboard. Você precisará do App ID do seu aplicativo Sendbird ao inicializar o Chat SDK.
Nota : Cada aplicativo Sendbird pode ser integrado a um único aplicativo cliente. Dentro de um mesmo aplicativo, os usuários podem se comunicar entre si em todas as plataformas, sejam eles em dispositivos móveis ou na web.
Instalar o Chat SDK é simples se você estiver familiarizado com o uso de bibliotecas externas ou SDKs. Primeiro, adicione o seguinte código ao arquivo root build.gradle :
allprojects {
repositories {
.. .
maven { url " https://repo.sendbird.com/public/maven " }
}
}Nota: Certifique-se de que o bloco de código acima não seja adicionado ao arquivo
build.gradledo módulo.
Se estiver usando o Gradle 6.8 ou superior, adicione o seguinte ao seu arquivo settings.gradle :
dependencyResolutionManagement {
repositories {
maven { url " https://repo.sendbird.com/public/maven " }
}
} Em seguida, adicione a dependência ao arquivo build.gradle de nível superior do projeto:
dependencies {
.. .
implementation ' com.sendbird.sdk:sendbird-chat:4.21.1 '
.. .
}O TLS 1.3 está habilitado por padrão no Sendbird SDK para Android. Para desativá-lo, inclua a seguinte configuração na dependência do Gradle:
Nota: O SendBird Android SDK depende da biblioteca Conscrypt para suportar TLS 1.3
dependencies {
implementation ( ' com.sendbird.sdk:sendbird-chat:4.21.1 ' ) {
exclude group : ' org.conscrypt ' , module : ' conscrypt-android '
}
} O Chat SDK requer permissões do sistema, que permitem a comunicação com o servidor Sendbird e a leitura e gravação no armazenamento do dispositivo do usuário. Para conceder permissões do sistema, adicione as seguintes linhas ao seu arquivo AndroidManifest.xml .
< uses-permission android : name = " android.permission.INTERNET " />
< uses-permission android : name = " android.permission.READ_EXTERNAL_STORAGE " />
< uses-permission android : name = " android.permission.WRITE_EXTERNAL_STORAGE " /> Ao criar seu APK com minifyEnabled true , adicione a linha a seguir ao arquivo de regras ProGuard do módulo.
-dontwarn com.sendbird.android.shadow. ** Agora que o Chat SDK foi importado, estamos prontos para começar a enviar uma mensagem.
Para usar os recursos do Chat SDK, uma instância SendbirdChat deve ser iniciada por meio da autenticação do usuário com o servidor Sendbird. Essa instância se comunica e interage com o servidor com base em uma conta de usuário autenticada e, então, o aplicativo cliente do usuário pode usar os recursos do Chat SDK.
Aqui estão as etapas para enviar sua primeira mensagem usando o Chat SDK:
Agora, inicialize o SDK do Chat no aplicativo para permitir que o SDK do Chat responda às alterações no status da conexão em aplicativos clientes Android.
Para inicializar a instância SendbirdChat , passe o APP_ID da sua aplicação Sendbird no Sendbird Dashboard como argumento para um parâmetro no método SendbirdChat.init() . Como SendbirdChat.init() só pode ser uma única instância, chame-o apenas uma vez em seu aplicativo cliente Android. Normalmente, a inicialização é implementada na tela de login do usuário.
Observação: é recomendado inicializar o Chat SDK no método
onCreate()da instânciaApplication.
SendbirdChat . init ( InitParams ( APP_ID , applicationContext, useCaching = true )) Após a inicialização usando o método init() , seu aplicativo cliente deve estar sempre conectado ao servidor Sendbird antes de chamar qualquer método. Se você tentar chamar um método sem conectar, um erro ERR_CONNECTION_REQUIRED (800101) retornará.
Conecte um usuário ao servidor Sendbird por meio de um ID de usuário exclusivo ou em combinação com um token de acesso. Sendbird prefere o último método, pois garante a privacidade do usuário. O primeiro é útil durante a fase de desenvolvimento ou se o seu serviço não exigir segurança adicional.
Conecte um usuário ao servidor Sendbird usando seu ID de usuário exclusivo. Por padrão, o servidor Sendbird pode autenticar um usuário por meio de um ID de usuário exclusivo. Mediante solicitação de conexão, o servidor consulta o banco de dados para verificar se há correspondência. Qualquer ID de usuário não obtido é automaticamente registrado como um novo usuário no sistema Sendbird, enquanto um ID existente pode ser registrado indiretamente. O ID deve ser exclusivo em um aplicativo Sendbird, como um endereço de e-mail com hash ou número de telefone em seu serviço.
Isso permite que você comece a trabalhar sem precisar se aprofundar nos detalhes do processo de registro de token; no entanto, certifique-se de ativar a aplicação de tokens antes de iniciar, pois é um risco de segurança iniciar sem isso.
SendbirdChat .connect( USER_ID ) { user, e ->
if (e != null ) { // Error.
return @connect
}
} Sendbird prefere que você passe o APP ID por meio de um token, pois garante privacidade e segurança aos usuários. Crie um usuário junto com seu token de acesso ou emita um token de sessão para passar durante a conexão. Uma comparação entre um token de acesso e um token de sessão pode ser encontrada aqui. Depois que um token é emitido, o usuário é obrigado a fornecer o token emitido no método SendbirdChat.connect() que é usado para fazer login.
SendbirdChat.connect() . SendbirdChat .connect( USER_ID , AUTH_TOKEN ) { user, e ->
if (e != null ) { // Error.
return @connect
}
}Crie um canal aberto usando os seguintes códigos. Canais abertos são onde todos os usuários do seu aplicativo Sendbird podem participar facilmente sem convite.
OpenChannel .createChannel( OpenChannelCreateParams ()) { channel, e ->
if (e != null ) { // Error.
return @createChannel
}
} Nota : Você também pode criar um canal de grupo para enviar uma mensagem. Para saber mais, consulte Criar um canal na página Canal do grupo.
Entre no canal aberto para enviar e receber mensagens.
OpenChannel .getChannel( CHANNEL_URL ) { channel, e ->
if (e != null ) { // Error.
return @getChannel
}
channel?.enter { enterError ->
if (enterError != null ) { // Error.
return @enter
}
}
}Por fim, envie uma mensagem para o canal. Existem três tipos: uma mensagem do usuário, que é um texto simples, uma mensagem de arquivo, que é um arquivo binário, como uma imagem ou PDF, e uma mensagem do administrador, que é um texto simples também enviado através do painel ou plataforma de bate-papo. API.
openChannel.sendUserMessage( MESSAGE ) { message, e ->
if (e != null ) { // Error.
return @sendUserMessage
}
}O tamanho do SDK do Chat é um fator importante a ser considerado ao integrá-lo ao seu aplicativo. O tamanho do SDK do Chat é o seguinte:
Na Sendbird, somos um grupo diversificado de indivíduos humildes, amigáveis e trabalhadores, unidos por um propósito comum de construir a próxima geração de tecnologias móveis e sociais, através de chat, voz e vídeo, que estão mudando a forma como trabalhamos e vivemos. Estamos sempre em busca de ótimas pessoas para se juntarem à nossa equipe. Confira nossa página de carreiras para mais informações.
