You can download ChatCenter SDK from here Example project is included.
Please add the following to build.gradle of the application.
repositories {
・・・
↓ add
maven { url "http://tokbox.bintray.com/maven" }
}
dependencies {
・・・
↓ add
compile 'ly.appsocial:chatcenter-android-sdk:1.0.+';
}
ChatCenter SDK sometimes uses the user's information when sending each widget. Therefore, please set up permission on AndroidManifest. Permission necessary are mentioned below.
<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.WAKE_LOCK" />
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
Next, describe AppToken in <application> </ application> as done in Sample.
<meta-data
android:name="ly.appsocial.chatcenter.AppToken"
android:value="[YOUR_APP_TOKEN_HERE]"/>
Next, We are using Google Maps SDK in the Location Widget. Please create Google API Key in dashboard of Google API and set it in <application> </ application> as done in Sample.
<meta-data
android:name="com.google.android.geo.API_KEY"
android:value="[YOUR_GOOGLE_API_KEY]"/>
Please confirm both Google Maps and Google Places API for Android are enable in dashboard of Google API.
Call ChatView to display chat.
Please insert the following code in a convenient place.
ChatCenter.showChat(final Context context,
final String orgUid,
final String firstName,
final String familyName,
final String email,
final String provider,
final String providerToken,
final String providerTokenSecret,
final String providerRefreshToken,
final Long providerCreatedAt,
final Long providerExpiresAt,
final String deviceToken,
final Map<String, String> channelInformations)
The following are the parameters. Bold is mandatory. If other parameters are not required, please specify null.
Note: In case of no authentication, user will be logged out automatically 30 days after login. Also, we do not currently support to link authentication processing afterwards
| Parameter name | Anonymous | ||
|---|---|---|---|
| context(Activity) | Please specify the original Activity | ||
| orgUid(String) | Please specify team ID based on Chat | ||
| firstName(String) | Please specify the family name of the user to be generated. If null is specified, the family name of the user registered on Facebook / Twitter will be used. | Please specify the first name of the user to be generated | |
| familyName(String) | Please specify the last name of the user to be generated. If null is specified, the family name of the user registered on Facebook / Twitter will be used. | Please specify the last name of the user to be generated | |
| email(String) | Please specify the Email address of the user to be generated. If null is specified, the Email address of the user registered on Facebook / Twitter will be used. (Need to request permission at Facebook authentication)。 | Please specify the Email address of the user to be generated | |
| provider(String) | @Please specify "facebook" | @Please specify "twitter" | Please specify null |
| providerToken(String) | Please specify token of authentication result | Please specify null | |
| providerTokenSecret(String) | Please specify null | Please specify Access token secret | Please specify null |
| providerRefreshToken(String) | Please specify null | ||
| providerCreatedAt(long) | Please specify null | ||
| providerExpiresAt(long) | Please specify the expiration date(expirationDate) of authentication | Please specify NULL | |
| deviceToken(String) | Please specify the deviceToken obtained from Google Clould Service | ||
| channelInformations(Map) | Please specify url related to creating channel as below ``Ex) {"url":"https://app.asana.com"}`` | ||
Call history view to display chat history list.
Please insert the following code in a convenient place.
ChatCenter.showMessages(final Context context,
final String provider,
final String providerToken,
final String providerTokenSecret,
final String providerRefreshToken,
final int providerCreatedAt,
final Date providerExpiresAt);
Note: In case of no authentication, user will be logged out automatically 30 days after login. Also, we do not currently support to link authentication processing afterwards
Please insert the following code in a convenient place.
The following are the parameters. Bold is mandatory. If other parameters are not required, please specify nil.
| Name of parameter | Anonymous | ||
|---|---|---|---|
| provider(String) | Please specify @"facebook" | Please specify @"twitter" | Please specify null |
| providerToken(String) | Please specify token of authentication result | Please specify null | |
| providerTokenSecret(String) | Please specify null | Please specify Access token secret | Please specify null |
| providerRefreshToken(String) | Please specify null | ||
| providerCreatedAt(int) | Time stamp (in seconds). | ||
| providerExpiresAt(Date) | Please specify the expiration date(expirationDate) of authentication | Please specify null | Please specify null |
Delete the data stored in the terminal and call the following when logging out.
ChatCenter.signOut(context, SignOutCallback)
To change color of ChatCenter views, please copy file colors.xml in /res/values folder in Sample and override color value.
<color tools:override="true" name="color_chatcenter_base">YOUR_BASE_COLOR</color>
You can set the base color of the design. Mainly applied to:
- (Chat View) Background color of chat bubble sent by you
- (Chat View) Widget Menu Icon Colors
- (Chat View) Widget menu color
Change background color of all activities:
<color tools:override="true" name="color_chatcenter_background">YOUR_BACKGROUND_COLOR</color>
Setting background color of ActionBar:
<color tools:override="true" name="color_chatcenter_title_background">YOUR_ACTIONBAR_BACKGROUND</color>
Setting text color of title on ActionBar:
<color tools:override="true" name="color_chatcenter_title_text">YOUR_TITLE_TEXT_COLOR</color>
Setting color of ImageButton on ActionBar (voice / video chat icon, back / close button):
<color tools:override="true" name="color_chatcenter_title_button_image">YOUR_BUTTON_COLOR</color>
Setting text color of Button on ActionBar (Next/Done/Send Button):
<color tools:override="true" name="color_chatcenter_title_button_text">YOUR_BUTTON_TEXT_COLOR</color>
Go to Google Dashboard copy Server API Key of your project and sets it to ChatCenter Server with following simple steps:
- Log into ChatCenter web dashboard, select Settings > Manage Mobile Push Endpoints and then click New button.
- On next Screen, please select Android for device_type, sets your Server API key and then click Create button to finish.
When device token is retrieved from Google please share your token with ChatCenter SDK with following simple line of code. The token will be sent to ChatCenter sever when opening Chat/History view.
// SET UP YOUR TOKEN TO CHAT-CENTER SDK FOR PUSHING NOTIFICATION
CCAuthUtil.saveDeviceToken(Context context,String token);
| Name of parameter | Value |
|---|---|
| context (Context) | Application Context |
| token (String) | Your device token |
When calling chat view, set the device token acquired from Google to deviceToken param. Push notification is enabled at the time of registration.
Please call the following at the timing when you want to invalidate Push notification, such as sign-out.
public void signOutDeviceToken(String deviceToken);
Parameter The following are the parameters. Bold is mandatory. If other parameters are not required, please specify nil.
| Name of parameter | Value |
|---|---|
| deviceToken(String) | Please specify the deviceToken obtained from Google for using Push notification |
Please retrieve org_uid from the payload at reception and perform Display chat view. The following payload will be sent.
{
data: {
alert: "app_name You have a message from ChatCenter",
badge: unread_count,
app_name: "ChatCenter App name",
app_token: "ChatCenter App token",
org_uid: "Team ID(Company/Store ID)",
channel_uid: "Channel UID",
message: message_content,
category: 'chat message'
},
notification: {
body: body,
title: 'ChatCenter iO'
}
}
Variable
- app_name -> App name
- app_token -> ChatCenter App token
- unread_count -> Number of unread channel
- org_uid -> Team ID(Company/Store ID)
- channel_uid -> Channel UID