2018-04-17 优化智能排队，支持坐席端显示队列用户详细信息

admin

有关AnyChat智能排队可参考：AnyChat提供业务排队整体解决方案

AnyChat提供的智能排队整体解决方案在众多的行业中应用广泛，以功能强大、稳定可靠、灵活可定制等特点深得用户好评，特别是在招商银行、平安银行、浦发银行、民生银行、兴业银行等银行的总行级应用树立了极高的行业标杆。

AnyChat新版本（r7324）优化了智能排队业务逻辑，支持坐席端显示队列用户详细信息，可满足一些特定领域的业务排队需求。

新增功能：
1、坐席可实时查询各队列排队用户列表，并显示排队用户的详细信息

常量定义：
#define ANYCHAT_OBJECT_FLAGS_QUEUEUSERLIST        0x0200        ///< 通知队列用户列表
#define ANYCHAT_QUEUE_INFO_USERINFOLIST                512        ///< 队列用户信息列表
#define ANYCHAT_QUEUE_EVENT_USERINFOLISTCHG        507        ///< 队列用户列表更新

开发指南：
1、坐席的初始化：
坐席端在登录时，需要设置标志位：ANYCHAT_OBJECT_FLAGS_QUEUEUSERLIST；有两种设置方式：
a、通过API接口：BRAC_SetSDKOption 来设置：
DWORD dwAgentFlags = ANYCHAT_OBJECT_FLAGS_AGENT | ANYCHAT_OBJECT_FLAGS_QUEUEUSERLIST;
BRAC_SetSDKOption(BRAC_SO_OBJECT_INITFLAGS, (CHAR*)&dwAgentFlags, sizeof(DWORD));


b、通过LoginEx接口，在登录时最后一个参数（lpStrParam）可通过JSON传递相关参数到服务器，其中："objectflags"表示对象标志。

2、获取队列用户列表：
坐席端进入营业厅成功后，可通过API接口BRAC_ObjectGetValue(dwObjectType, dwObjectId, ANYCHAT_QUEUE_INFO_USERINFOLIST)来获取指定队列的用户列表，为JSON值，类似于：
{
   "errorcode" : 0,
   "queuelength" : 3,
   "useridlist" : [ -3, -4, -5 ],
   "stridlist" : [ "G0001", "G0002", "G0003" ],
   "usernamelist" : [ "user1", "user2", "user3" ],
   "entertimelist" : [ 1523963732, 1523963750, 1523963800 ],
}


其中：
useridlist：userid列表，整形值；
stridlist：struserid列表，字符串值；
usernamelist：用户名列表，字符串值；
entertimelist：用户进入队列的时间列表，为Unix 时间戳。

3、事件通知
当队列用户信息更新后，服务器会主动通知到坐席端，并产生异步事件：ANYCHAT_QUEUE_EVENT_USERINFOLISTCHG。