網(wǎng)易七魚 Android SDK 是一個(gè) Android 端客服系統(tǒng)訪客解決方案,既包含了客服聊天邏輯管理,也提供了聊天界面,開發(fā)者可方便的將客服功能集成到自己的 App 中。
網(wǎng)易七魚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 可以在七魚管理系統(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);
在打開的頁(yè)面中,用戶就可以咨詢客服了。
由于開發(fā)環(huán)境的不同,很多情況下會(huì)出現(xiàn)集成報(bào)錯(cuò)或者配置無(wú)效的問題。我們官網(wǎng)提供了demo源碼,開發(fā)者可以參考源碼;更多的時(shí)候是需要開發(fā)者自己本地調(diào)試代碼,可以通過斷點(diǎn)跟蹤等基本且有效的方法來(lái)定位和排查問題。
- PC官方版
- 安卓官方手機(jī)版
- IOS官方手機(jī)版