安卓-5分鐘內建線上客服[蘿蔔絲]

5分鐘內建線上客服

• Demo

準備工作

• 到蘿蔔絲官網注冊管理者賬号，并登入管理背景。
• 到 所有設定->應用管理->App 添加應用，填寫相關資訊之後點選确定，在生成記錄中可見appkey，後面會用到。
• 到 所有設定->客服管理->客服賬号 添加客服賬号。注意：生成記錄中有一列 ‘唯一ID(uid)’ 會在指定客服接口中使用
• 到 所有設定->客服管理->技能組 添加技能組，并可将客服賬号添加到相關技能組。注意：生成記錄中有一列 ‘唯一ID（wId）’ 會在工作組會話中用到

開始內建

第一步：在項目build.gradle的 allprojects -> repositories 添加

maven {
    url  "https://dl.bintray.com/jackning/maven"
}
           

修改完後，效果如下：

allprojects {
    repositories {
        jcenter()
        google()
        maven {
            url  "https://dl.bintray.com/jackning/maven"
        }
    }
}
           

第二步：在module的build.gradle android{}添加

android {
    ...
    compileOptions {
        sourceCompatibility JavaVersion.VERSION_1_8
        targetCompatibility JavaVersion.VERSION_1_8
    }
    ...
}
           

第三步：在module的build.gradle dependencies{}添加

// 蘿蔔絲第三步
// 加載蘿蔔絲核心庫
implementation 'com.bytedesk:core:2.0.2'
// 加載蘿蔔絲預設UI庫
implementation 'com.bytedesk:ui:2.0.2'

// 騰訊QMUI界面庫
// http://qmuiteam.com/android/page/start.html
// https://bintray.com/chanthuang/qmuirepo
implementation 'com.qmuiteam:qmui:1.4.0'
           

第四步：AndroidManifest.xml添權重限

<!--添加蘿蔔絲權限-->
<uses-permission android:name="android.permission.WAKE_LOCK" />
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
<uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" />
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
<uses-permission android:name="android.permission.INTERNET" />
           

第五步：AndroidManifest.xml添加Activity和Service

<!--蘿蔔絲bytedesk.com代碼 開始-->
<!--對話頁面-->
<activity
    android:name="com.bytedesk.ui.activity.ChatKFActivity"
    android:screenOrientation="portrait"
    android:theme="@style/AppTheme.ByteDesk"/>
<!--長連接配接service-->
<service android:name="com.bytedesk.paho.android.service.MqttService"/>
<!--下載下傳錄音-->
<service android:name="com.bytedesk.core.service.BDDownloadService"/>
<!--錄音以及播放-->
<service android:name="com.bytedesk.ui.recorder.KFRecorderService"/>
<!--./蘿蔔絲bytedesk.com代碼 結束-->
           

第六步：在樣式檔案styles.xml中添加

<!--添加蘿蔔絲樣式 開始-->
<style name="AppTheme.ByteDesk" parent="QMUI.Compat.NoActionBar">
    <!--導航欄樣式-->
    <item name="QMUITopBarStyle">@style/ByteDeskTopBar</item>
</style>
<style name="ByteDeskTopBar" parent="QMUI.TopBar">
    <!--導航欄背景顔色-->
    <item name="qmui_topbar_bg_color">@color/app_color_blue</item>
    <!--導航欄字型顔色-->
    <item name="qmui_topbar_title_color">@color/qmui_config_color_white</item>
    <item name="qmui_topbar_subtitle_color">@color/qmui_config_color_white</item>
    <item name="qmui_topbar_text_btn_color_state_list">@color/qmui_config_color_white</item>
    <!--導航欄高度-->
    <item name="qmui_topbar_height">48dp</item>
    <item name="qmui_topbar_image_btn_height">48dp</item>
</style>
<!--添加蘿蔔絲樣式 結束-->
           

第七部：初始化UI和建立長連接配接

參考demo中MainActivity.java

// 初始化蘿蔔絲UI界面庫
BDUiApi.init(this);
// 具體代碼請參考MainActivity.java
anonymousLogin();
           

第八步：開始客服會話

// 打開客服對話界面
BDUiApi.startWorkGroupChatActivity(context, wId, "工作組客服");
           

內建完畢