# Android app sdk集成說明

相關限制及注意事項

1、Android SDK 新版支持 api17 以上版本,支持豎屏和橫屏。

2、開發工具AS建議升級到3.0以上版本

3、Android SDK 目前僅僅支持超鏈接標簽,其他html標簽和屬性均不識別

4、Android SDK 需要申請存儲、麥克風、拍照危險權限,否則部分功能無法使用

智齒客服SDK具有以下特性

  • 在線咨詢:咨詢人工客服(收發圖片、發送視頻)、發送表情;
  • 高度自定義UI;

# 1 文檔介紹

# 1.1 集成流程示意圖

圖片

# 1.2.文件說明

SDK包含SobotOnlinesobot_app_sdk_demo、和Doc相關說明文檔。

# 2 集成方式

# 2.0 依賴集成

api 'com.sobot.chat:sobot-online:1.0.1'

在build.gradle中如下所示:

dependencies {
      api 'com.sobot.chat:sobot-online:1.0.1'
      implementation 'com.squareup.okhttp3:okhttp:4.4.0'
      implementation 'com.android.support:appcompat-v7:28.0.0'
      implementation 'com.android.support:recyclerview-v7:28.0.0'
      implementation 'com.sobot.chat:sobotsupport-glidev4:1.0.8'
      //目前支持常見的3種圖片加載庫,必須在下面的圖片加載庫中選擇一個添加依賴
      implementation 'com.github.bumptech.glide:glide:4.8.0'
      //implementation 'com.nostra13.universalimageloader:universal-image-loader:1.9.5'
      //implementation 'com.squareup.picasso:picasso:2.5.2'
}

【注意】由于glide v3版本和v4版本的接口完全不同,因此我們為了方便您的使用,采用了特殊的集成方式使sdk可以支持任 意版本的glide。正常情況下,您使用glide 時,直接添加glide依賴和sobot-online的依賴,sdk即 可正常使用。如果報錯,那么把glide 升級到4.4.0版本以上即可。

在使用4.9.0以上版本的glide時,需額外升級依賴

"implementation 'com.sobot.chat:sobotsupport-glidev4:1.0.10"

# 2.1 手動集成

下載鏈接:Android_OnlineSDK_1.0.1

導入Module

解壓下載的智齒Android_OnlineSDK_XXX.zip文件,將 SobotOnline 文件直接復制到您的項目中,

然后 Build-->clean projecty一下,之后在build.gradle添加項目依賴

完成上述步驟之后build.gradle中如下所示:

dependencies {
      //sdk 在線客服
      implementation project(":SobotOnline")
      implementation 'com.squareup.okhttp3:okhttp:4.4.0'
      implementation 'com.android.support:appcompat-v7:28.0.0'
      implementation 'com.android.support:recyclerview-v7:28.0.0'
      implementation 'com.sobot.chat:sobotsupport-glidev4:1.0.8'
      //目前支持常見的3種圖片加載庫,必須在下面的圖片加載庫中選擇一個添加依賴
      implementation 'com.github.bumptech.glide:glide:4.8.0'
      //implementation 'com.nostra13.universalimageloader:universal-image-loader:1.9.5'
      //implementation 'com.squareup.picasso:picasso:2.5.2'
}

【注意】由于glide v3版本和v4版本的接口完全不同,因此我們為了方便您的使用,采用了特殊的集成方式使sdk可以支持任 意版本的glide。正常情況下,您使用glide 時,直接添加glide依賴和sobot-online的依賴,sdk即 可正常使用。如果報錯,那么把glide 升級到4.4.0版本以上即可。

在使用4.9.0以上版本的glide時,需額外升級依賴

"implementation 'com.sobot.chat:sobotsupport-glidev4:1.0.10"

# 3.1 初始化和域名設置

域名說明:

*默認SaaS平臺域名為:https://api.sobot.com

*如果您是騰訊云服務,請設置為:https://ten.sobot.com

*如果您是本地化部署,請使用自己的部署的服務域名


    /**
     * 初始化方法,需要在宿主應用application.onCreate函數中調用
     *
     * @param host  可以為空,默認阿里云服務;如果需要,請設置自己的域名
     */
    SobotOnlineService.initWithHost(Application application, String host);

# 3.2 資源配置

在客戶app中colors.xml中添加同名顏色可覆蓋智齒sdk中的顏色樣式;也可通過在主項目中同一位置放一個同名的圖片資源去替換智齒sdk界面中的圖片;也可通過在主項目中同一位置放一個同名的文字資源去替換智齒sdk界面中的文字;

以下是常用的顏色配置,更多顏色、圖片資源可到手動集成模塊中下載源碼包中去查找;

    <!--在線客服 主題色 默認綠色 -->
    <color name="sobot_online_color">#0DAEAF</color>
    <!--在線客服 通用頭部 背景顏色-->
    <color name="sobot_online_base_header_bg_color">#FFFFFF</color>
    <!-- 狀態欄顏色-->
    <color name="sobot_app_status_bar_color">@color/sobot_online_base_header_bg_color</color>

    <!--在線客服 聊天主頁面  -->
    <!-- 聊天頁狀態欄顏色 -->
    <color name="sobot_chat_status_bar_color">#F6F8FC</color>
    <!-- 文件消息氣泡顏色 -->
    <color name="sobot_chat_file_bgColor">@color/sobot_online_color</color>
    <!-- 消息氣泡左側背景默認顏色 -->
    <color name="sobot_chat_left_bgColor">@color/sobot_online_white_color</color>
    <!-- 消息氣泡右側背景默認顏色 -->
    <color name="sobot_chat_right_bgColor">@color/sobot_online_color</color>
    <!--文本消息氣泡 左側文字 顏色 -->
    <color name="sobot_left_msg_text_color">@color/sobot_online_common_gray1</color>
    <!--文本消息氣泡 右側文字 顏色 -->
    <color name="sobot_right_msg_text_color">@color/sobot_online_white_color</color>
    <!-- 超鏈接顏色 左邊 -->
    <color name="sobot_color_link">@color/sobot_online_blue_color</color>
    <!-- 超鏈接顏色 右邊 -->
    <color name="sobot_color_rlink">@color/sobot_online_yellow_color</color>
    <!-- 聊天界面提醒背景顏色-->
    <color name="sobot_chat_remind_bg">#59FFFFFF</color>
    <!-- 聊天界面提醒的字體顏色-->
    <color name="sobot_chat_remind_text_color">@color/sobot_online_common_gray3</color>
    <!-- 聊天界面提醒的超鏈接文字顏色-->
    <color name="sobot_chat_remind_link_color">@color/sobot_online_blue_color</color>

# 3.3 啟動頁面

【說明:appid, app_key 請聯系智齒售后人員獲取;如果使用token方式接入,請參考接口文檔獲取token

方式一:以appid和appkey方式啟動

    /**
     * 啟動客服認證頁面
     *
     * @param context
     * @param appid       公司appid
     * @param appkey      商戶appkey
     * @param account     客服賬戶(郵箱)
     * @param loginStatus 登錄狀態0:忙碌,1:在線, -1使用默認值
     */
 SobotOnlineService.startAuthWithAcount(Context context, String appid, String appkey, String account, int loginStatus);

方式二:直接以token方式啟動

  /**
     * 通過設置token方式啟動客服認證頁面
     *
     * @param context
     * @param account     客服賬戶(郵箱)
     * @param loginToken     登錄客服token
     * @param loginStatus 1:在線,2:忙碌,-1等待客服設置,0:離線,直接返回
     */
    public static void startAuthWithToken(Context context, String account, String loginToken, int loginStatus) {

# 3.4 接口說明

# 3.4.1登錄

 /**
     * 僅登錄客服,不執行頁面邏輯
     *
     * @param account     客服賬戶(郵箱)
     * @param loginStatus 登錄狀態 0:忙碌,1:在線,-1使用默認值
     */
 SobotOnlineService.doLoginWithAccount( Context context, final String account,  int loginStatus);

# 3.4.2退出登錄

 SobotOnlineService.outAdmin(Context context;

# 3.4.3獲取未讀消息數

int unReadNum=SobotOnlineService.getUnReadNumber(Context context);

# 3.4.4 注冊廣播、獲取新收到的信息

注冊廣播后,當消息通道連通時,可以獲取到新接收到的消息。

1 注冊廣播

/**
* action:SobotSocketConstant.BROADCAST_SOBOT_NEW_MSG
*/
IntentFilter filter = new IntentFilter();
filter.addAction(SobotSocketConstant.BROADCAST_SOBOT_NEW_MSG);
registerReceiver(receiver, filter);

2 接收新信息和未讀消息數 在BroadcastReceiver的onReceive方法中接收信息。

//設置廣播獲取新收到的信息和未讀消息數
    class MyReceiver extends BroadcastReceiver {

        @Override
        public void onReceive(Context context, Intent intent) {
            if (SobotSocketConstant.BROADCAST_SOBOT_NEW_MSG.equals(intent.getAction())) {
                //新消息內容
                String content = intent.getStringExtra("msgContent");
                //完整內容json
                String contentJson = intent.getStringExtra("msgContentJson");
                SobotLogUtils.i( " 新消息內容:" + content + "   完整內容:" + contentJson);
            }
        }
    }

# 3.4.5設置是否開啟消息提醒

  /**
     * 設置是否開啟消息提醒   默認不開啟
     *
     * @param context
     * @param flag      true 開啟 ; false 關閉
     * @param smallIcon 小圖標的id 設置通知欄中的小圖片
     */
  SobotOnlineService.setNotificationFlag(Context context, false, R.drawable.sobot_logo_small_icon);

# 4 智齒客服App權限列表

獲取權限 獲取權限的目的
訪問網絡 訪問網絡連接,可能產生GPRS流量
獲取網絡狀態 獲取網絡信息狀態,如當前的網絡連接是否有效
獲取WiFi狀態 獲取當前WiFi接入的狀態以及WLAN熱點的信息
獲取錯略位置 通過WiFi或移動基站的方式獲取用戶錯略的經緯度信息,定位精度大概誤差在30~1500米
獲取精確位置 通過GPS芯片接收衛星的定位信息,定位精度達10米以內
改變WiFi狀態 改變WiFi狀態
寫入外部存儲 允許程序寫入外部存儲,如SD卡上寫文件
錄音 錄制聲音通過手機或耳機的麥克
修改聲音設置 修改聲音設置信息
拍照 允許訪問攝像頭進行拍照
獲取任務信息 允許程序獲取當前或最近運行的應用
使用振動 允許振動
喚醒鎖定 允許程序在手機屏幕關閉后后臺進程仍然運行
讀取電話狀態 訪問電話狀態
讀取聯系人 允許應用訪問聯系人通訊錄信息
寫入聯系人 寫入聯系人,但不可讀取
撥打電話 允許程序從非系統撥號器里輸入電話號碼
谷歌相冊 允許選擇谷歌相冊圖片
桃花源_桃花源视频_桃花源视频大全_播视网在线观看