# 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卡上寫文件
錄音 錄制聲音通過手機或耳機的麥克
修改聲音設置 修改聲音設置信息
拍照 允許訪問攝像頭進行拍照
獲取任務信息 允許程序獲取當前或最近運行的應用
使用振動 允許振動
喚醒鎖定 允許程序在手機屏幕關閉后后臺進程仍然運行
讀取電話狀態 訪問電話狀態
讀取聯系人 允許應用訪問聯系人通訊錄信息
寫入聯系人 寫入聯系人,但不可讀取
撥打電話 允許程序從非系統撥號器里輸入電話號碼
谷歌相冊 允許選擇谷歌相冊圖片
国色天香社区视频在线观看-草蜢视频在线观看www 火豆电影
得知母亲出事男子在地铁痛哭 尚气与十环传奇 林丹世界排名被正式移除 24岁救人牺牲消防员获批为烈士 长津湖 扫黑风暴 流浪地球 中美元首会谈重点内容 动保组织向上饶信州区申请信息公开 #耿直真香哥黑化卖惨# 许家印为恒大注入超70亿续命资金 斛珠夫人 长津湖 鱿鱼游戏 许家印为恒大注入超70亿续命资金 甄嬛传 中美元首是否达成新共识?中方回应 两个女人 罗永浩吐槽苹果文案没文化 24岁救人牺牲消防员获批为烈士 大连现超级传播者26人在同一传播链 胡锡进谈中美元首会晤 五个扑水的少年 胡锡进谈中美元首会晤 动物世界 大连现超级传播者26人在同一传播链 大连现超级传播者26人在同一传播链 灵媒 周冠宇成为中国首位F1车手 中国共产党第三个历史决议全文发布 外交部回应拜登重申不支持台独 夜色暗涌时 苏宁易购回应破产传闻 胡锡进谈中美元首会晤 嘉南传 浦发银行回应近3亿存款莫名被质押 流浪地球 长津湖 国际人士热议中共十九届六中全会 我要我们在一起 尚气与十环传奇 房价上涨城市创七年新低 拐点来了? 浦发银行回应近3亿存款莫名被质押 胡锡进谈中美元首会晤 扬名立万 #耿直真香哥黑化卖惨# 红色通缉令 入殓师 国足最新出线概率0.08% 花木兰 浦发银行回应近3亿存款莫名被质押 24岁救人牺牲消防员获批为烈士 兰心大剧院 国际人士热议中共十九届六中全会 俄方回应卫星碎片危及国际空间站 周冠宇成为中国首位F1车手 中国共产党第三个历史决议全文发布 大连一密接者擅自点外卖聚餐被调查 安娜贝尔 入殓师 #耿直真香哥黑化卖惨# 浦发银行回应近3亿存款莫名被质押 #耿直真香哥黑化卖惨# 中美元首是否达成新共识?中方回应 长津湖 国足最新出线概率0.08% 鱿鱼游戏 千与千寻 我和我的祖国 嘉南传 房价上涨城市创七年新低 拐点来了?
文登市| 抚宁县| 财经| 正安县| 华宁县| 广南县| 河源市| 昭平县| 常州市| 济源市| 大冶市| 姜堰市| 顺平县| 临沧市| 芜湖县| 都江堰市| 抚州市| 镇赉县| 临汾市| 阿瓦提县| 屏边| 安塞县| 泰兴市| 陆良县|