註冊
首先前往融雲官網註冊一個開發帳號地址在此
下載
隨後下載融雲開發SDK地址在此
Demo源碼爲官方提供的示例demo,無需修改,直接運行即可成功查看融雲的相關功能
SDk分爲兩部分:融雲 IM 界面組件(imkitht)和融雲 IM 通訊能力庫(imlib)
創建應用
前往 融雲開發者平臺創建一個應用,安卓端需要注意的地方有
- 應用標識-Package Name 此處爲安卓項目的包名,如下面代碼的包名即爲io.rong.imkit.demo
<manifest xmlns:android="http://schemas.android.com/apk/res/android"
package="io.rong.imkit.demo">
- AppKey-App Key 此處爲manifest文件中所需要聲明的App Key對應的值,開發階段使用開發環境(測試環境),開發完成後應切換爲生產環境(線上環境),簡單的示例如下
<meta-data android:name="RONG_CLOUD_APP_KEY" android:value="e7x8xycsx6flq" />
項目配置
添加對APP_KEY的聲明
如使用imkit進行開發,將其所有android:host的值修改爲開發應用的包名
如使用Android Studio開發,記得添加對so文件的引用
編寫代碼
- 初始化,建議放在Application的onCreate放法中進行
RongIM.init(this);
得到Token,此處需要開發者Server端的支持,如果只是爲了測試開發,可以前往融雲開發者平臺選擇API 調試-用戶服務-獲取Token進行調試開發
連接融雲器,得到Token後即可連接融雲的服務器了
// 此處直接 hardcode 給 token 賦值,請替換爲您自己的 Token。
String token = "mKmyKqTSf7aNDinwAFMnz7NXKILeV3X0+CCRBOxmtOApmvQjMathViWrePIfq0GuTu9jEL123ckv4AhfjCAKgQ==";
// 連接融雲服務器。
RongIM.connect(token, new RongIMClient.ConnectCallback() {
@Override
public void onSuccess(String s) {
// 此處處理連接成功。
Log.d("Connect:", "Login successfully.");
}
@Override
public void onError(ErrorCode errorCode) {
// 此處處理連接錯誤。
Log.d("Connect:", "Login failed.");
}
});
- 當服務器連接成功後,即可調用融雲的各類聊天接口了