With Sendbird Chat SDK for Android, you can efficiently integrate real-time chat into a client app. On the client-side implementation, you can initialize and configure the chat with minimal effort. On the server-side, Sendbird ensures reliable infra-management services for your chat within the app.
This page demonstrates how to install the Chat SDK in your app so that you can send your first message in just a few simple steps.
Note: The fastest way to see Sendbird Chat SDK in action is to build your app on top of our sample app. Download the sample app to jumpstart your build.
The minimum requirements for Chat SDK for Android are:
Android 4.1 (API level 16) or higher
Java 7 or higher
Android Gradle plugin 3.4.0 or higher
Note: Sendbird server supports Transport Layer Security (TLS) from versions 1.0 up to 1.3. For example, in the server regions where TLS 1.3 isn’t available, lower versions from 1.0 to 1.2 will be sequentially supported for secure data transmission.
Before installing Sendbird Chat SDK, you need to create a Sendbird application on the Sendbird Dashboard, which comprises everything required in a chat service including users, messages, and channels. You will need the
App ID of your Sendbird application when initializing the Chat SDK.
Note: Each Sendbird application can be integrated with a single client app. Within the same application, users can communicate with each other across all platforms, whether they are on mobile devices or on the web.
UIKit is a Sendbird Chat SDK add-on with user interfaces that enable an easy and fast integration of standard chat features into new or existing client apps.
If you would like a sample app with embedded UI, see UIKit Quickstart for Android.
To send a message in a client app, you should build and configure an in-app chat using Sendbird Chat SDK. Sendbird Chat SDK can be installed through
Installing the Chat SDK is simple if you're familiar with using external libraries or SDKs. First, add the following code to your root
Note: Make sure the above code block isn't added to your module
Then, add the dependency to your module
Note: Chat SDK versions
3.0.160or lower can be downloaded from JCenter until February 1, 2022. SDK versions higher than
3.0.160will be available on Sendbird's remote repository.
Alternatively, you can download the
.aar file. Copy this file into your
libs/ folder, and make sure you include the library in your
build.gradle file as well.
The Chat SDK requires system permissions. These permissions allow the Chat SDK to communicate with Sendbird server and read from and write on a user device’s storage. To request system permissions, add the following lines to your
When you build your APK with
minifyEnabled true, add the following line to the module's
ProGuard rules file.
Now, initialize the Chat SDK in the app to allow the Chat SDK to respond to changes in the connection status of Android client apps. Initialization requires the
App ID, which can be found in the which can be found on the Sendbird Dashboard.
Note: The methods in the following steps are all asynchronous. This means that when using asynchronous methods, your client app must receive success callbacks from Sendbird server through their callback handlers in order to proceed to the next step. A good way to do this is the nesting of methods: Go to Step 7: Enter the channel to learn more about how you can nest the
With local caching, two new parameters have been added to the
SendBird.init() method, which are
InitResultHandler(). The following will show how you can initialize the Chat SDK with or without local caching.
useLocalCaching determines whether the client app will use the local storage through Sendbird Chat SDK or not. If you want to build a client app with our local caching functionalities, set the
useLocalCaching to true.
InitResultHandler() gets the initialization status through different event handlers. The
onMigrationStarted() is called when there's an upgrade in the local database. Meanwhile, the
onInitSucceeded() informs the client app whether the initialization is completed.
Note: If you are not using local caching, the
InitResultHandler()won't be called.
onInitFailed() is called when you set the
useLocalCaching to true, the SDK will operate normally and change the value of the
useLocalCaching to false. If you still wish to use the local caching, clear the database using the
SendBird.clearCachedData(getApplicationContext(), CompletionHandler); and try the
SendBird.init() again with the
useLocalCaching set to true.
SendBird.init()method must be called across a client app at least once. It is recommended to initialize the Chat SDK with the
onCreate()method of the
You will need a user in order to send a message to a channel. You can either create a user on our dashboard or you can use a unique ID that hasn’t been taken by any of your Sendbird application users. In the latter case, a new user will be automatically created in your Sendbird application before being connected.
For those who use the Chat SDK with local caching, refer to the sample codes on the first tab. If not, refer to the second tab.
Note: To learn more about authenticating with an access token, go to Authentication.
Note: You must receive the result of the
InitResultHandler()before calling the
connect(). Any methods can be called once the user is connected to Sendbird server.
Create an open channel using the following codes. Open channels are where all users in your Sendbird application easily participate without an invitation.
Note: You can also create a group channel to send a message. To learn more, see Create a channel in the Group channel page.
Enter the channel to send and receive messages.
Finally, send a message to the channel. To learn more about the message type you can send, see Messages.
onMessageReceived() channel event handler using the
Sendbird.addChannelHandler() method so that you can receive the message you just sent to the channel. You can also see the message in our dashboard.