用户反馈专业版SDK 1.0 Android端集成

更新时间:2016/11/07 访问次数:39853

写在前面:如果您在接入中有任何疑问,请参照文档“接入指南-服务模式”加入钉钉群和我们交流。

前置准备

1、如果您单纯是想体验反馈的功能,建议直接跳过这一步。直接查看快速集成。

2、在这个集成教程中,我们使用已创建的Demo应用,向您展示如何快速地集成反馈sdk(Android)。

3、您需要入驻开发者并且创建应用后,才能集成反馈并且发布您的App。

4、您需要在完成快速集成后,将一些内容替换为您申请到的特定内容,才能发布您的App。对于这些需要替换的内容,会在教程中以注意点的形式标识出。

快速集成

Step1 下载SDK包

如果您单纯是想体验反馈的功能,建议直接跳过这一步。直接下载Demo。如果您已经有了百川appkey,请先下载SDK

Step2 通用配置

从百川后台下载sdk,获取安全图片yw_1222.jpg文件并拷贝到你自己主工程下的对应目录下(即res/drawable)。

注意:这个文件和生成时候包的keystore有关,如果你的测试包和正是包使用的是不同的keystore,那么需要在生成不同包的时候更换这个文件。
注意:目录中包含的安全图片yw_1222.jpg不能被重命名。

混淆配置如下:

-keepattributes Signature
-keep class sun.misc.Unsafe { *; }
-keep class com.taobao.** {*;} 
-keep class com.alibaba.** {*;} 
-keep class com.alipay.** {*;} 
-dontwarn com.taobao.**
-dontwarn com.alibaba.**
-dontwarn com.alipay.**
-keep class com.ut.** {*;} 
-dontwarn com.ut.** 
-keep class com.ta.** {*;} 
-dontwarn com.ta.**
-keep class com.alibaba.sdk.android.feedback.** {*;}

Step3 反馈初始化

由于用户反馈在初始化时会向服务器请求数据,所以初始化方法是异步化网络操作。因此调用建议放在Application onCreate方法中,以保证用户在进入反馈页面之前,相关数据在后台已经初始化完成。有两种针对不同使用场景的初始化方式,注意Application要在manifest里配置增加过:

3.1 匿名反馈初始化方式

//第二个参数是appkey,就是百川应用创建时候的appkey
FeedbackAPI.initAnnoy(Context context, String appKey)

3.2 openim账号初始化方式

//第三和第四个参数是openim账号和密码
FeedbackAPI.initOpenImAccount(Context context, String appKey,String uid, String pw)

Step4 打开反馈页面

//如果发生错误,请查看logcat日志
FeedbackAPI.openFeedbackActivity(Context context)
//如果希望使用Fragment方式打开请调用一下API
FeedbackAPI.getFeedbackFragment()

Step5 获取反馈未读数

//可选功能,第二个参数是当前登录的openim账号,如果是匿名账号方式使用,则可以传空的。返回的未读数在onsuccess接口数组中第一个元素,直接转成Integer就可以。
FeedbackAPI.getFeedbackUnreadCount(Context context, String uid, final IWxCallback callback)

Step6 自定义设置

//可以设置UI自定义参数,如主题色等,map的key值具体为:
 //enableAudio(是否开启语音 1:开启 0:关闭)
 //bgColor(消息气泡背景色 "#ffffff"),
 //color(消息内容文字颜色 "#ffffff"),
 //avatar(当前登录账号的头像),string,为http url
 //toAvatar(客服账号的头像),string,为http url
 //themeColor(标题栏自定义颜色 "#ffffff")
 //profilePlaceholder: (顶部联系方式),string
 //profileTitle: (顶部联系方式左侧提示内容), String
 //chatInputPlaceholder: (输入框里面的内容),string
 //profileUpdateTitle:(更新联系方式标题), string
 //profileUpdateDesc:(更新联系方式文字描述), string
 //profileUpdatePlaceholder:(更新联系方式), string
 //profileUpdateCancelBtnText: (取消更新), string
 //profileUpdateConfirmBtnText: (确定更新),string
 //sendBtnText: (发消息),string
 //sendBtnTextColor: ("white"),string
 //sendBtnBgColor: ('red'),string
 //hideLoginSuccess: true  隐藏登录成功的toast
 //pageTitle: (Web容器标题), string
 //photoFromCamera: (拍摄一张照片),String
 //photoFromAlbum: (从相册选取), String
 //voiceContent:(点击这里录制语音), String
 //voiceCancelContent: (滑到这里取消录音), String
 //voiceReleaseContent: (松开取消录音), String

FeedbackAPI. setUICustomInfo(Map<String, String> map)

//可以设置反馈消息自定义参数,方便在反馈后台查看自定义数据,参数是json对象,里面所有的数据都可以由开发者自定义

FeedbackAPI. setAppExtInfo(JSONObject extInfo)

 //设置自定义联系方式
 //@param customContact  自定义联系方式
 //@param hideContactView 是否隐藏联系人设置界面

FeedbackAPI.setCustomContact(String customContact, boolean hideContactView)

FAQ

关于此文档暂时还没有FAQ
返回
顶部