访客 Android SDK

到佳信官网下载页面下载SDK

将目标jar文件（lib_jx_im_alone.jar）引入到工程中，置于libs/ 目录下，如下图：

在项目配置文件AndroidManifest.xml中添加如下权限：

<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
<uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" />
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />
<uses-permission android:name="com.android.alarm.permission.SET_ALARM" />
<uses-permission android:name="android.permission.VIBRATE" />
<uses-permission android:name="android.permission.WAKE_LOCK" />
<!-- 录音权限 -->
<uses-permission android:name="android.permission.RECORD_AUDIO" />
<!-- 多媒体权限 -->
<uses-permission android:name="android.permission.CAMERA" />
<uses-permission android:name="android.permission.MODIFY_AUDIO_SETTINGS" />
<uses-permission android:name="android.permission.RECORD_AUDIO" />
<uses-permission android:name="android.permission.WRITE_SETTINGS" />
<uses-permission android:name="android.permission.RECORD_VIDEO"/>

添加service、receiver 配置信息：

<!-- service -->
<service>
android:name="com.jxccp.im.chat.JXCoreService"
android:enabled="true">
    <intent-filter>
   <actionandroid:name="com.jxccp.im.chat.JXCoreService"/>
    </intent-filter>
</service>

需要在Application的onCreate方法中调用，即应用启动时进行SDK初始化。

• 调试功能开启或关闭影响SDK输出日志信息。
• 开启调试模式输出的日志级别:verbose/debug/info/warn/error。
• 关闭调试模式只输出日志级别:warn/error。

每次请求客服前，app层必须调用该接口进行初始化，该接口会为访客创建账号并登陆。该接口从之前的SDK层移到了UI模板层，开发者通过依赖UI模板工程可直接调用。

• 示例代码：

AccountHelper.getInstance().initMcsRequest(getApplicationContext(), new OnInitMcsRequestCallback() {

            @Override
            public void onInitMcsResult(final int code) {
                runOnUiThread(new Runnable() {
                    public void run() {
                        if (code == Mcs.MCS_USER_INIT_SUCCESS) {
                            JXWorkgroup workgroup = JXImManager.McsUser.getInstance().isNeedRequest();
                            if(workgroup == null){
                                fetchWorkgroupFromServer();
                            }else{
                                requestCustomerService(workgroup.getMcsId(), workgroup.getDisplayName());
                            }
                        } else if (code == JXErrorCode.APPKEY_NOT_EXIST) {
                            CommonUtils.showToast(getApplicationContext(),
                                    getString(R.string.appkey_not_exist));
                            finish();
                        } else {
                            CommonUtils.showToast(getApplicationContext(),
                                    getString(R.string.request_customerFailed));
                            finish();
                        }
                    }
                });
            }
        });
    }

请求客服前必须确认8.1步骤中initMcsRequest的初始化是否成功。

JXMcsStatusListener监听器说明:

     /**
     * 客服处于离线
     */
    public void onMcsOffline(String skillsId);

• JXUserSelfQueueListener 监听器说明：

 /**
     * @author xugs
     * @Description: 用户自身在队列中位置
     * @param skillsId 技能组ID
     * @param currentPosition 当前队列的位置
     * @date 2015-9-6 下午1:56:48
     */
    public void onUserSelfQueueUpdate(String skillsId, int currentPosition);

    /**
     * @author xugs
     * @Description: 用户状态
     * @param skillsId 技能组ID
     * @param status 用户状态
     * @see
     * <li>{@link JXUserSelfQueueListener#USER_STATUS_DEPARTQUEUE}</li>
     * <li>{@link JXUserSelfQueueListener#USER_STATUS_INQUEUE}</li>
     * <li>{@link JXUserSelfQueueListener#USER_STATUS_INSERVICE}</li>
     * <li>{@link JXUserSelfQueueListener#USER_STATUS_ENTER_SESSION_EXCEPTION}</li>
     * <li>{@link JXUserSelfQueueListener#USER_STATUS_ENTER_SESSION}</li>
     * @date 2015-9-8 下午3:30:46
     */
    public void onUserSelfStatus(String skillsId, int status, String nickName);

    /**
     * 会话结束
     * @param skillsId
     * @param reasonCode
     */
    public void onEnded(String skillsId, int reasonCode);

• 用户自身的几种状态：

/**
     * 用户正在请求客服
     */
    public static final int USER_STATUS_PENDING = 1;

    /**
     * 用户进入到会话
     */
    public static final int USER_STATUS_WAITING= 2;

    /**
     * 用户进入机器人服务
     */
    public static final int USER_STATUS_ROBOT= 3;

    /**
     * 用户处于被服务的状态
     */
    public static final int USER_STATUS_INSERVICE = 4;

    /**
     * 用户进入回呼的状态
     */
    public static final int USER_STATUS_RECALL= 5;

    /**
     * 会话已被结束
     */
    public static final int USER_STATUS_ENDED = 6;

判断是否需要重新请求，若无需重新请求则返回上一个技能组的ID,反之返回null。

访客主动结束与客服的会话。

发送访客正在编辑的消息时，发送预知消息给客服。

• 输入状态取值如下：

public static class JXChatState {
        /**
         * 输入中
         */
        public static final String composing = "composing";

        /**
         * GONE
         */
        public static final String gone = "gone";
}

获取在线留言wap网页URL

在访客登录时，SDK内部已从服务器获取了满意度配置，通过JXConversation对象即可获取满意度评价配置。JXSatisfication对象配置包括：评价邀请语、评价反馈语、评价类型（评满意度、评分、评星级、自定义）、评价选项。

访客提交满意度评价同样是通过JXConversation对象来操作。

访客提交满意度评价后，需要收到反馈信息，此接口用于保存反馈消息。

在开发者中心配置了快捷提问问题后，可通过此接口来获取快捷提问问题列表。需要注意的是SDK内部在登录时已从网络获取了问题列表并存入缓存，所以问题列表不会随开发者中心的修改而实时修改，需重新登录才会重新获取。

获取在开发中心配置的自定义头像的URL，如未设置过则为默认头像URL。

获取开发者中心配置中，访客是否可以主动评价

获取开发者中心配置中，是否发送预知消息。

获取开发者中心配置中，访客是否可以发送表情

打包时需要keep以下：

-keep class com.alibaba.sdk.android.** {*;}
-keep class de.measite.minidns.** {*;}
-keep class org.jivesoftware.smack.** {*;}
-keep class org.jivesoftware.smackx.** {*;}
-keep class org.jxmpp.** {*;}
-keep class com.jxccp.** {*;}