Agora chat demo

This repository will help you learn how to use Agora chat SDK to implement a simple chat android application, like whatsapp or wechat.

With this sample app, you can:

• Login chat server
• Start a chat
• Manage conversation list
• Add contacts
• Join group chats
• Join chat rooms
• Add your contacts to your blacklist
• Send various types of messages, Such as: text, expression, picture, voice, file and so on
• Logout

Prerequisites

• Make sure you have made the preparations mentioned in the Agora Chat SDK quickstart.
• Prepare the development environment:
  • Java Development Kit (JDK)
  • Android Studio 4.0 or later

Run the sample project

Follow these steps to run the sample project:\

1. Clone the repository to your local machine.

    git clone git@github.com:AgoraIO-Usecase/AgoraChat-android.git

2. Open the Android project with Android Studio.

3. Configure keys.

Set your appid applied from Agora Developer Console before calling ChatClient#init().

ChatOptions options = new ChatOptions();
// Set your appid
options.setAppId("Your appid");
...
//initialization
ChatClient.getInstance().init(applicationContext, options);

For details, see the prerequisites in Agora Chat SDK Guide.

Precautions

1. Set the JDK version to 11 or higher.
2. Add the following fields in local.properties:

   AGORA_CHAT_APPID={Your Agora Chat AppId} // Replace {Your Agora Chat AppId} with your actual AppId
   AGORA_RTC_APPID=”{Your Agora RTC AppId}” // Make sure to include quotation marks, replace {Your Agora RTC AppId} with your actual AppId
   

Contact Us

• You can find full API document at Document Center
• You can file bugs about this demo at issue

License

The MIT License (MIT).