Android 融雲SDK整合單聊
一 、下載 SDK
您可以到融雲官方網站下載融雲 SDK。融雲 SDK 各部分功能以外掛化的形式獨立提供,開發者可以根據自己的需要,自由組合下載。各元件的功能如下:
IMKit – 融雲 IM 介面元件
IMLib – 融雲 IM 通訊能力庫
CallKit – 融雲音視訊介面元件
CallLib – 融雲音視訊核心元件
LocationLib – 融雲位置相關庫
PushLib – 融雲第三方推送庫
RedPacket – 融雲紅包相關元件
二、以 Module 形式匯入各元件
1、開啟你的工程, File -> New -> Import Module
開啟你從官網下載的融雲 SDK,選擇 IMKit 。如圖:
根據你的需要,以同樣的步驟匯入SDK裡的其它元件: IMLib, CallKit, CallLib, RedPacket。
將 PushLib 中的 jar 包 和 pushDaemon -> libs 目錄下應用所支援平臺的 so 拷貝到您應用的 libs 目錄下,另外還需要將 pushDaemon -> executable 目錄下各平臺的可執行檔案 push_daemon 拷貝到您應用 Module 的 assets 目錄下。如圖:
2、開啟應用的 build.gradle,在 dependencies 中新增 compile project(‘:IMKit’)。如圖:
3、將 LocationLib 和 PushLib 裡的 jar 包拷貝到你應用的 libs 目錄下(如果不需要位置功能和小米推送,可跳過此步驟)。
4、開啟 IMLib Module 的 AndroidManifest.xml 檔案,把 meta-data RONG_CLOUD_APP_KEY 的值修改為你自己的 key,並將 AndroidManifest 中所有 host 改為你依賴專案的包名(此處指 app Module 的包名)。如圖:
三、初始化 SDK
在 application 中呼叫 RongIM.init(this);
這步比較簡單,在 app 的 Module 下建立 一個 App 繼承 Application,注意 App 需要 在 AndroidManifest 中配置
public class App extends Application {
@Override
public void onCreate() {
super.onCreate();
/**
* 初始化融雲
*/
RongIM.init(this);
}
}
四、 連線融雲
在 MainActivity 中呼叫RongIM.connect() 連線融雲。注意此處的 Token 為一個測試 Token,你需要換成你自己的 Token,這個 Token 還需要與 RONG_CLOUD_APP_KEY 匹配。
注意,在上線前請確認在 connect 方法 ConnectCallback 中通過 onTokenIncorrect 回撥方法實現重新獲取 Token 的邏輯。
public class MainActivity extends ActionBarActivity {
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_main);
String Token = “d6bCQsXiupB/4OyGkh+TOrI6ZiT8q7s0UEaMPWY0lMxmHdi1v/AAJxOma4aYXyaivfPIJjNHdE+FMH9kV/Jrxg==”;//test
/**
* IMKit SDK呼叫第二步
*
* 建立與伺服器的連線
*/
RongIM.connect(Token, new RongIMClient.ConnectCallback() {
@Override
public void onTokenIncorrect() {
//Connect Token 失效的狀態處理,需要重新獲取 Token
}
@Override
public void onSuccess(String userId) {
Log.e(“MainActivity”, “——onSuccess—-” + userId);
}
@Override
public void onError(RongIMClient.ErrorCode errorCode) {
Log.e(“MainActivity”, “——onError—-” + errorCode);
}
});
}
@Override
public boolean onCreateOptionsMenu(Menu menu) {
getMenuInflater().inflate(R.menu.menu_main, menu);
return true;
}
@Override
public boolean onOptionsItemSelected(MenuItem item) {
return super.onOptionsItemSelected(item);
}
}
五、 整合單聊介面
由於單聊是一個 fragment,需要在 activity 載入的佈局中,新增 fragment,並且在 AndroidManifest 中新增 intent-filter
1、 新增一個 Activity,此處命名為 ConversationActivity。
package rong.io.demo;
import android.annotation.TargetApi;
import android.os.Build;
import android.os.Bundle;
import android.support.v7.app.ActionBarActivity;
import android.view.MenuItem;
public class ConversationActivity extends ActionBarActivity {
private static final String TAG = ConversationActivity.class.getSimpleName();
@TargetApi(Build.VERSION_CODES.LOLLIPOP)
@Override
public void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
//唯一有用的程式碼,載入一個 layout
setContentView(R.layout.conversation);
//繼承的是ActionBarActivity,直接呼叫 自帶的 Actionbar,下面是Actionbar 的配置,如果不用可忽略…
getSupportActionBar().setTitle(“聊天”);
getSupportActionBar().setLogo(R.drawable.de_bar_logo);
getSupportActionBar().setDisplayHomeAsUpEnabled(true);
getSupportActionBar().setHomeAsUpIndicator(R.drawable.de_actionbar_back);
}
@Override
public boolean onOptionsItemSelected(MenuItem item) {
finish();
return super.onOptionsItemSelected(item);
}
}
2、 檢視佈局 conversation.xml,如下: <?xml version=“1.0″ encoding=“utf-8″?>
<LinearLayout xmlns:android=“http://schemas.android.com/apk/res/android”
android:orientation=“vertical” android:layout_width=“match_parent”
android:layout_height=“match_parent”>
<fragment
android:layout_width=“match_parent”
android:layout_height=“match_parent”
android:name=“io.rong.imkit.fragment.ConversationFragment”/>
</LinearLayout>
3、在 AndroidManifest 註冊。注意需修改 host 為自己的包名,其他不需要修改。<activity android:name=“.ConversationActivity”>
<intent-filter>
<action android:name=“android.intent.action.VIEW” />
<category android:name=“android.intent.category.DEFAULT” />
<data
android:host=“rong.io.demo”
android:pathPrefix=“/conversation/”
android:scheme=“rong” />
</intent-filter>
</activity>
4、在 activity 中呼叫 RongIM.getInstance().startPrivateChat(MainActivity.this, “2462″, “hello”); 開啟單聊,如下:package rong.io.demo;
import android.support.v7.app.ActionBarActivity;
import android.os.Bundle;
import android.util.Log;
import android.view.Menu;
import android.view.MenuItem;
import io.rong.imkit.RongIM;
import io.rong.imlib.RongIMClient;
public class MainActivity extends ActionBarActivity {
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_main);
String Token = “d6bCQsXiupB/4OyGkh+TOrI6ZiT8q7s0UEaMPWY0lMxmHdi1v/AAJxOma4aYXyaivfPIJjNHdE+FMH9kV/Jrxg==”;//test
/**
* IMKit SDK呼叫第二步
*
* 建立與伺服器的連線
*
*/
RongIM.connect(Token, new RongIMClient.ConnectCallback() {
@Override
public void onSuccess(String userId) {
Log.e(“MainActivity”, “——onSuccess—-” + userId);
}
@Override
public void onError(RongIMClient.ErrorCode errorCode) {
Log.e(“MainActivity”, “——onError—-” + errorCode);
}
});
}
@Override
public boolean onCreateOptionsMenu(Menu menu) {
getMenuInflater().inflate(R.menu.menu_main, menu);
return true;
}
@Override
public boolean onOptionsItemSelected(MenuItem item) {
/**
* 啟動單聊
* context - 應用上下文。
* targetUserId - 要與之聊天的使用者 Id。
* title - 聊天的標題,如果傳入空值,則預設顯示與之聊天的使用者名稱稱。
*/
if (RongIM.getInstance() != null) {
RongIM.getInstance().startPrivateChat(MainActivity.this, “2462″, “hello”);
}
return super.onOptionsItemSelected(item);
}
}
單聊整合完畢!效果圖:
詳細參考官方文件:http://blog.rongcloud.cn/?p=392
defaultConfig {minSdkVersion 21 targetSdkVersion 23 versionCode 1 versionName "1.0" testInstrumentationRunner "android.support.test.runner.AndroidJUnitRunner" }