網(wǎng)易七魚(yú)Android SDK4.8.0 正版

網(wǎng)易七魚(yú) Android SDK 是一個(gè) Android 端客服系統(tǒng)訪客解決方案，既包含了客服聊天邏輯管理，也提供了聊天界面，開(kāi)發(fā)者可方便的將客服功能集成到自己的 App 中。

網(wǎng)易七魚(yú)Android SDK使用方法

只需簡(jiǎn)單 3 步，即可將客服功能加入你的 App：

添加 SDK 到項(xiàng)目中。

Android Studio： 在工程 build.gradle 文件中添加依賴即可。

// 最新版本可參考 Download 徽章后對(duì)應(yīng)的數(shù)值
compile 'com.qiyukf.unicorn:unicorn:+'

Eclipse： 先下載 SDK，然后解壓縮，將得到的 unicorn 文件夾作為庫(kù)工程模塊導(dǎo)入到你的工程中，并添加模塊依賴。然后將 assets 文件夾的內(nèi)容拷貝你的主工程的 assets 目錄中，將 AndroidManifest 文件中的內(nèi)容拷貝到你的主工程的 manifest 文件中，并將 manifest 中的 ${applicationId} 替換為你的包名。

在你的 Application 類的 onCreate 函數(shù)中，加入以下初始化代碼：

public class YourApplication extends Application {
  public void onCreate() {
      // ... your codes
      // appKey 可以在七魚(yú)管理系統(tǒng)->設(shè)置->App 接入 頁(yè)面找到
      Unicorn.init(this, "appKey", options(), new UnicornImageLoader());
      // ... your codes
  }

  // 如果返回值為null，則全部使用默認(rèn)參數(shù)。
  private YSFOptions options() {
      YSFOptions options = new YSFOptions();
      options.statusBarNotificationConfig = new StatusBarNotificationConfig();
      return options;}

上面代碼中，UnicornImageLoader 可根據(jù)你 App 中圖片加載模塊做自定義實(shí)現(xiàn)，以免 SDK 中引入第三方圖片管理庫(kù)后造成與 App 的沖突或者浪費(fèi)。在 demo 中，實(shí)現(xiàn)了依賴于 UniversalImageLoader 的 UILImageLoader。其代碼以及依賴于 fresco、Glide、Picasso 的實(shí)現(xiàn)代碼可參考 圖片加載 一節(jié)。

在你的 App 的合適頁(yè)面添加客服入口按鈕，并在響應(yīng)函數(shù)中加入如下代碼：

String title = "聊天窗口的標(biāo)題";/**
* 設(shè)置訪客來(lái)源，標(biāo)識(shí)訪客是從哪個(gè)頁(yè)面發(fā)起咨詢的，用于客服了解用戶是從什么頁(yè)面進(jìn)入。
* 三個(gè)參數(shù)分別為：來(lái)源頁(yè)面的url，來(lái)源頁(yè)面標(biāo)題，來(lái)源頁(yè)面額外信息（保留字段，暫時(shí)無(wú)用）。
* 設(shè)置來(lái)源后，在客服會(huì)話界面的"用戶資料"欄的頁(yè)面項(xiàng)，可以看到這里設(shè)置的值。
*/ConsultSource source = new ConsultSource(sourceUrl, sourceTitle, "custom information string");/**
* 請(qǐng)注意： 調(diào)用該接口前，應(yīng)先檢查Unicorn.isServiceAvailable()，
* 如果返回為false，該接口不會(huì)有任何動(dòng)作
*
* @param context 上下文
* @param title   聊天窗口的標(biāo)題
* @param source  咨詢的發(fā)起來(lái)源，包括發(fā)起咨詢的url，title，描述信息等
*/Unicorn.openServiceActivity(context, title, source);

在打開(kāi)的頁(yè)面中，用戶就可以咨詢客服了。

由于開(kāi)發(fā)環(huán)境的不同，很多情況下會(huì)出現(xiàn)集成報(bào)錯(cuò)或者配置無(wú)效的問(wèn)題。我們官網(wǎng)提供了demo源碼，開(kāi)發(fā)者可以參考源碼；更多的時(shí)候是需要開(kāi)發(fā)者自己本地調(diào)試代碼，可以通過(guò)斷點(diǎn)跟蹤等基本且有效的方法來(lái)定位和排查問(wèn)題。