网易七鱼 Android SDK 是面向安卓设备的客服系统访客端方案,它一方面处理客服对话的逻辑,另一方面也带有现成的聊天窗口,开发人员可以轻松地把客服模块嵌入自己的应用里。
将 SDK 引入工程。
对于 Android Studio,只需在工程的 build.gradle 里加入相应依赖。
// 最新版本号请查看 Download 徽章上的数字
在项目构建文件中加入依赖声明:compile 'com.qiyukf.unicorn:unicorn:+'
Eclipse:先获取 SDK,解压后把里面的 unicorn 目录作为库工程模块引入你的项目,并设置模块依赖。接着把 assets 文件夹中的内容复制到主工程的 assets 目录下,把 AndroidManifest 文件里的内容合并到主工程的 manifest 文件里,同时把 manifest 中的 ${applicationId} 改成你自己的包名。
于 Application 类的 onCreate 方法内,添加如下初始化语句:
一个名为 YourApplication 的公共类,它继承自 Application 类。
在 onCreate() 方法内执行初始化操作。
软件版本:7.3.1.0,发布于 2024 年 12 月 25 日。这是一款高效的 MP3 音频编辑工具,支持剪切、复制、粘贴、混音、音量调整以及多种音频特效。它能够处理 MP3、WAV、WMA、OGG 等常见格式,并可将结果保存为 MP3、WAV、WMA、OGG 或 FLAC。主要功能包括:无限制的撤销与重做操作,精确到毫秒的剪切、复制和粘贴,可调整播放速度与音调,支持 MP3 和 WAV 的混音,以及为音轨添加特效,例如延迟、回声、合唱、混响、淡入淡出、反转、颤音等。软件界面支持多语言,并提供皮肤更换选项。
appKey 能够在七鱼管理控制台的“设置”里“App 接入”栏目中查看。
调用 Unicorn 的初始化方法,需要传入四个参数:当前上下文 this、字符串 "appKey"、一个选项对象(由 options() 返回)以及一个新的 UnicornImageLoader 实例。
本程序可显示即时气温和未来两天的天气状况预报。
此函数可接受 null 作为返回值,当传入 null 时所有参数均按默认值处理。
私有方法 options() 创建并返回 YSFOptions 实例。
创建一个新的 YSFOptions 实例,并将其赋值给变量 options。
代码中给 options 的 statusBarNotificationConfig 属性分配了一个新创建的 StatusBarNotificationConfig 实例。
软件适合日常使用,可定时关电脑、重启或注销,支持指定日期。支持一次性、每天、每周、每月等模式,倒计时可暂停,有热键立即执行。能同时计时多项任务,各自独立运作。可设定关机前自动断网或结束程序。倒计时小于 30 秒时无法退出,最后一次提醒在 10 秒前出现。选项能记住上次设置。官方绿色版无需安装。
上述程序里的 UnicornImageLoader 允许按 App 现有的图片加载组件进行个性化适配,目的是防止 SDK 内嵌其他图片管理库后与 App 产生冲突或多余开销。示例工程中提供了基于 UniversalImageLoader 的 UILImageLoader 实现。该实现以及依赖 fresco、Glide、Picasso 的对应版本可以在“图片加载”部分查阅。
聊天窗口的标题
* 设置访客来源,标识访客从哪个页面发起咨询,方便客服了解用户进入的页面。
* 三个参数:来源页 URL、来源页标题、来源页附加信息(保留字段,暂未使用)。
* 设置后,客服会话界面“用户资料”栏的页面项会显示这里设置的值。
创建一个 ConsultSource 对象时,需要提供来源网址、来源标题以及一段自定义信息字符串。
调用接口前,需先确认 Unicorn.isServiceAvailable() 的返回值。
若返回值为 false,此接口将不执行任何操作。
上下文参数:context
此参数用于指定聊天界面的标题。
参数 source 表示咨询请求的来源,里面含有发起咨询的页面地址、标题以及描述内容等。
Unicorn.openServiceActivity 方法用于开启服务活动界面,接收上下文、标题和来源三个参数。
打开页面后,用户即可咨询客服。
由于开发环境不同,集成报错或配置无效的情况常见。官网提供了 demo 源码供参考;更多时候需要开发者本地调试,通过断点跟踪等方法定位解决问题。