会话管理

public static boolean closeSession(final String exchange, String closeSessionMsg)

EventService.closeSession(UnicornMessageBuilder.getSessionId(), "结束会话");

public static void requestStaff(boolean humanOnly, RequestStaffCallback callback)
public static void requestStaff(String exchange, boolean humanOnly, long staffId, long groupId, int requestStaffScenes, RequestStaffCallback callback)
public static void requestStaff(String exchange, boolean humanOnly, long staffId, long groupId, int requestStaffScenes, boolean isEnableVideo, RequestStaffCallback callback)

EventService.requestStaff(false, new RequestStaffCallback() {
                    @Override
                    public void onSuccess() {
									// 请求客服成功
                    }

                    @Override
                    public void onFailed(int errorCode) {

                    }
                });

String exchange = UnicornMessageBuilder.getSessionId();
long groupId = 123456L;
long staffId = 0L;

EventService.requestStaff(exchange, true, staffId, groupId, RequestConstant.SCENES_NORMAL,
        new RequestStaffCallback() {
            @Override
            public void onSuccess() {
                // 请求人工客服成功
            }

            @Override
            public void onFailed(int errorCode) {
                // 根据 errorCode 处理失败场景
            }
        });

String exchange = shopId;
EventService.requestStaff(exchange, true, 0L, groupId, RequestConstant.SCENES_NORMAL, callback);

public static void transferStaff(String exchange, long staffId, long groupId, String closeSessionMsg, boolean isHuman, TransferCloseResultCallback transferCloseResultCallback, TransferRequestCallback transferRequestCallback)

public static boolean quitQueue(final String exchange)

EventService.quitQueue(UnicornMessageBuilder.getSessionId());

public class DemoRequestStaffEvent implements UnicornEventBase<RequestStaffEntry> {

    /**
     * 当事件发生的时候，会回调这个方法，在这个方法中，事件是处于等待的状态的只有调用了
     * callback 中的方法，事件才会继续
     *
     * @param entry    请求客服事件的一些参数
     * @param context  当前界面的 context 对象，使用之前请判断是否为 null
     * @param callback sdk 的回调对象 具体请查看 EventCallback
     */
    @Override
    public void onEvent(final RequestStaffEntry entry, Context context, final EventCallback<RequestStaffEntry> callback) {
        if (context == null) {
            Toast.makeText(context, "请求客服的信息为：" + entry.toString(), Toast.LENGTH_LONG).show();
        } else {
            //当处理成功之后可以调用 onProcessEventSuccess 通知 sdk 可以请求客服了
            AlertDialog dialog = new AlertDialog.Builder(context).setMessage("请求客服的信息为" + entry.toString() + "是否拦截")
                    .setPositiveButton("是", new DialogInterface.OnClickListener() {
                        @Override
                        public void onClick(DialogInterface dialog, int which) {
                            callback.onInterceptEvent();
                            //以下是示例调用EventService.requestStaff的方法，用户在这里可以走自己的逻辑
                            //在这里将拦截器置为null，否则会死循环
                            DemoCache.ysfOptions.sdkEvents = null;
                            //拦截掉，自己发起请求
                            EventService.requestStaff(true, new RequestStaffCallback() {
                                @Override
                                public void onSuccess() {
                                    Toast.makeText(context, "请求成功", Toast.LENGTH_LONG).show();
                                }

                                @Override
                                public void onFailed(int errorCode) {
                                    /**
                                     * 请求客服失败回调
                                     *
                                     * @param errorCode 201：没有客服
                                     *                  202：其它错误
                                     *                  203：需要排队
                                     *                  204：长连接失效
                                     *                  205：没有客服在线，留言关闭
                                     *                  -1： 数据返回错误
                                     *                  -2:  正在请求客服
                                     */
                                    Toast.makeText(context, "请求失败：" + errorCode, Toast.LENGTH_LONG).show();
                                }
                            });
                        }
                    })
                    .setNegativeButton("否", new DialogInterface.OnClickListener() {
                        @Override
                        public void onClick(DialogInterface dialog, int which) {
                            //不拦截，直接请求客服
                            callback.onNotPorcessEvent();
                        }
                    }).create();
            dialog.show();
        }
    }
}

public static void addUnreadCountChangeListener(UnreadCountChangeListener listener, final boolean add)

private UnreadCountChangeListener mUnreadCountListener = new UnreadCountChangeListener() {
    @Override
    public void onUnreadCountChange(int count) {
        updateUnreadCount(count);
        if (count > 0) {
            IMMessage message = Unicorn.queryLastMessage();
            if (message != null) {
                Log.d("queryLastMessage", "getFromAccount: " + message.getFromAccount());
                // 获取消息附件
                if (message.getAttachment() != null) {
                    if (message.getAttachment() instanceof YsfAttachment) {
                        Log.d("queryLastMessage", "message：" + ((YsfAttachment) message.getAttachment()).getContent());
                    } else {
                        Log.d("queryLastMessage", "message：" + message.getAttachStr());
                    }
                } else {
                    // 获取文本消息
                    Log.d("queryLastMessage", "message：" + message.getContent());
                }
            }
        }
    }
};
Unicorn.addUnreadCountChangeListener(mUnreadCountListener, true)

public static int getUnreadCount()

// 获取未读消息数
int unreadCount = Unicorn.getUnreadCount();

public static void clearUnreadCount(String shopId)

POPManager.clearUnreadCount(UnicornMessageBuilder.getSessionId());

public static void clearUnreadCount(String shopId)

POPManager.clearUnreadCount(shopId);

public static IMMessage queryLastMessage()

IMMessage message = Unicorn.queryLastMessage();
if (message != null) {
	// 获取消息附件
	if (message.getAttachment() != null) {
		if (message.getAttachment() instanceof YsfAttachment) {
			Log.d("queryLastMessage", "message：" + ((YsfAttachment) message.getAttachment()).getContent());
		} else {
			Log.d("queryLastMessage", "message：" + message.getAttachStr());
		}
	} else {
		// 获取文本消息
		Log.d("queryLastMessage", "message：" +message.getContent());
   }
 }

public static void openEvaluation(final Activity activity, final String exchange, final RequestCallbackWrapper callbackWrapper)

public static void cancelEvaluation(String exchange)

public class EvaluationApi {


    private OnEvaluationEventListener onEvaluationEventListener;

    /**
     * 评价事件监听类,用户可以通过调用 setOnEvaluationEventListener
     * 方法去设置自己实现的 OnEvaluationEventListener ，当用户设置了 OnEvaluationEventListener
     * 那么当用户触发了评价事件就会交给 App 方处理
     */
    public static abstract class OnEvaluationEventListener {
        /**
         * 评价状态改变
         *
         * @param state 0:不可评价,1:可评价,2:评价完成
         */
        public void onEvaluationStateChange(int state) {
        }

        /**
         * 邀评消息被点击，App 方可以在此方法启动自己的评价界面
         * @param entry 评价的相关数据
         */
        public void onEvaluationMessageClick(EvaluationOpenEntry entry, Context context) {
        }
    }

    private static class SingletonHolder {
        private static final EvaluationApi sInstance = new EvaluationApi();
    }

    public static EvaluationApi getInstance() {
        return SingletonHolder.sInstance;
    }


    public OnEvaluationEventListener getOnEvaluationEventListener() {
        return onEvaluationEventListener;
    }

    public void setOnEvaluationEventListener(OnEvaluationEventListener onEvaluationEventListener) {
        this.onEvaluationEventListener = onEvaluationEventListener;
    }

    /**
     * 评价
     *
     * @param shopCode 商家ID， 在 EvaluationOpenEntry 里面有这个值，只需要回传就可以了
     * @param sessionId 会话 ID ，在 EvaluationOpenEntry 里面有这个值，只需要回传就可以了
     * @param score    评分
     * @param remark   评价内容
     * @param tagList  标签
     * @param name     评价结果的文案，例如非常满意、满意、不满意等
     * @param callback 回调
     */
    public void evaluate(String shopCode, long sessionId, int score, String remark, List<String> tagList, String name, RequestCallbackWrapper<String> callback) {
        SessionManager.getInstance().getEvaluationManager().doEvaluate(shopCode, sessionId, score, remark, tagList, name, callback);
    }
}

EvaluationApi.getInstance().setOnEvaluationEventListener(new EvaluationApi.OnEvaluationEventListener() {
                @Override
                public void onEvaluationStateChange(int state) {
                    //当评价状态改变的时候，会调用该方法，所以当有需求的时候可以在改方法中做一些操作
                }

                @Override
                public void onEvaluationMessageClick(EvaluationOpenEntry entry, Context context) {
                    if (context == null)
                        return;
                    Intent intent = new Intent(context, DemoEvaluationActivity.class);
                    intent.putExtra(ENTRYTAG, entry);
                    context.startActivity(intent);
                }
            });

Unicorn.setLocalLanguage(String language, String area)

public static void clearCache()

Unicorn.clearCache();

// 异步执行，结果通过工作线程回调
public static void traceRoute(String hostname, Diagnosis.TraceRouteCallback callback)

// 同步执行，会阻塞当前线程
public static Diagnosis.TraceRouteResult traceRoute(String hostname)

Diagnosis.traceRoute("www.example.com", new Diagnosis.TraceRouteCallback() {
    @Override
    public void onComplete(Diagnosis.TraceRouteResult result) {
        Log.i("QiyuDiagnosis", "code=" + result.getCode()
                + ", message=" + result.getMessage());
    }
});