网易七鱼Android SDK4.8.0 正版

网易七鱼AndroidSDK使用方法

只需简单3步，即可将客服功能加入你的App：足球大小球

添加SDK到项目中。

AndroidStudio：在工程build.gradle文件中添加依赖即可。

//最新版本可参考Download徽章后对应的数值
compile'com.qiyukf.unicorn:unicorn:+'

Eclipse：先下载SDK，然后解压缩，将得到的unicorn文件夹作为库工程模块导入到你的工程中，并添加模块依赖。然后将assets文件夹的内容拷贝你的主工程的assets目录中，将AndroidManifest文件中的内容拷贝到你的主工程的manifest文件中，并将manifest中的 ${applicationId} 替换为你的包名。

在你的Application类的 onCreate 函数中，加入以下初始化代码：

publicclassYourApplicationextendsApplication{
 publicvoidonCreate(){
   //...yourcodes
   //appKey可以在七鱼管理系统->设置->App接入页面找到
   Unicorn.init(this,"appKey",options(),newUnicornImageLoader());
   //...yourcodes
 }

 //如果返回值为null，则全部使用默认参数。
 privateYSFOptionsoptions(){
   YSFOptionsoptions=newYSFOptions();
   options.statusBarNotificationConfig=newStatusBarNotificationConfig();
   returnoptions;}

上面代码中，UnicornImageLoader可根据你App中图片加载模块做自定义实现，以免SDK中引入第三方图片管理库后造成与App的冲突或者浪费。在demo中，实现了依赖于UniversalImageLoader的UILImageLoader。其代码以及依赖于fresco、Glide、Picasso的实现代码可参考 图片加载 一节。

在你的App的合适页面添加客服入口按钮，并在响应函数中加入如下代码：

Stringtitle="聊天窗口的标题";/**
*设置访客来源，标识访客是从哪个页面发起咨询的，用于客服了解用户是从什么页面进入。
*三个参数分别为：来源页面的url，来源页面标题，来源页面额外信息（保留字段，暂时无用）。
*设置来源后，在客服会话界面的"用户资料"栏的页面项，可以看到这里设置的值。
*/ConsultSourcesource=newConsultSource(sourceUrl,sourceTitle,"custominformationstring");/**
*请注意：调用该接口前，应先检查Unicorn.isServiceAvailable()，
*如果返回为false，该接口不会有任何动作
*
*@paramcontext上下文
*@paramtitle 聊天窗口的标题
*@paramsource 咨询的发起来源，包括发起咨询的url，title，描述信息等
*/Unicorn.openServiceActivity(context,title,source);

在打开的页面中，用户就可以咨询客服了。

由于开发环境的不同，很多情况下会出现集成报错或者配置无效的问题。我们官网提供了demo源码，开发者可以参考源码；更多的时候是需要开发者自己本地调试代码，可以通过断点跟踪等基本且有效的方法来定位和排查问题。

网易七鱼AndroidSDK是一个Android端客服系统访客解决方案，既包含了客服聊天逻辑管理，也提供了聊天界面，开发者可方便的将客服功能集成到自己的App中。