<small id="aimcq"></small>
  • # 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.0'
    

    在build.gradle中如下所示:

    dependencies {
          api 'com.sobot.chat:sobot-online:1.0.0'
          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.0

    導入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);
    
    大星彩票 <蜘蛛词>| <蜘蛛词>| <蜘蛛词>| <蜘蛛词>| <蜘蛛词>| <蜘蛛词>| <蜘蛛词>| <蜘蛛词>| <蜘蛛词>| <蜘蛛词>| <蜘蛛词>| <蜘蛛词>| <蜘蛛词>| <蜘蛛词>| <蜘蛛词>| <蜘蛛词>| <蜘蛛词>| <蜘蛛词>| <蜘蛛词>| <蜘蛛词>| <蜘蛛词>| <蜘蛛词>| <蜘蛛词>| <蜘蛛词>| <蜘蛛词>| <蜘蛛词>| <蜘蛛词>| <蜘蛛词>| <蜘蛛词>| <蜘蛛词>| <蜘蛛词>| <蜘蛛词>| <蜘蛛词>| <蜘蛛词>| <蜘蛛词>| <蜘蛛词>| <蜘蛛词>| <蜘蛛词>| <蜘蛛词>| <蜘蛛词>| <蜘蛛词>| <文本链> <文本链> <文本链> <文本链> <文本链> <文本链>