5. 注册事件回调
5.1 添加事件监听
接口名称:CallCenter.addEventListener (event,fun)
功能:增加事件的监听
参数:
参数名 | 类型 | 说明 | |
event | string | 事件名称 | |
fun | function | 监听函数 |
返回值:事件ID,通过该事件ID可以移除监听的事件
示例:
- // 添加事件监听
- CallCenter.addEventListener("after",function(json){
- // json 响应数据
- });
注意:
多次添加同一事件会依次执行,不会覆盖
添加事件时记录事件ID,该ID在移除事件时提供,否则无法移除事件
5.2 移除事件监听
接口名称:CallCenter.removeEventListener (event,uuid)
功能:移除指定事件的监听函数
参数:
参数名 | 类型 | 说明 |
event | string | 事件名称 |
uuid | string | 事件ID,添加事件时的返回值,不能通过其它方式获取 |
返回值:0失败或事件未注册,非0成功
示例:
- // 移除事件监听
- CallCenter.removeEventListener("answer","1254");
注意:无
5.3 查看事件监听绑定数量
接口名称:getEventListenerCount (event)
功能:返回指定事件绑定监听函数个数
参数:
参数名 | 类型 | 说明 |
event | string | 事件名称 |
返回值:绑定数量
示例:
- CallCenter. getEventListenerCount (“answer”)
注意:无
说明 | SDK提供一系列事件供集成时自定义事件行为,如:集成方可以根据自己需要注册登录事件回调(logon),当座席登录时,SDK调用回调,响应自定义事件行为。 所有的事件回调必须注册到CallCenter对象(语法如下),回调函数调用时会传入事件数据,供集成时使用。 | |
示例 | // 注册outringing事件 CallCenter.addEventListener(‘outringing’,function(json){ //TODO: 此处为事件回调代码 //json为outringing事件触发时传入的事件数据 }) //注册answer事件 CallCenter.addEventListener(‘answer’,function(json){ //TODO: 此处为事件回调代码 //json为answer事件触发时传入的事件数据 }) //注册after事件 CallCenter.addEventListener(‘after’,function(json){ //TODO: 此处为事件回调代码 //json为after事件触发时传入的事件数据 }) | |
注意 | 不同的事件接收的事件数据不同,根据业务需要区分处理 | |
手动外呼被叫正常振铃接听事件顺序: | ||
logon(登录)àagentidle(座席空闲)àmakecall(外呼)àoutringing(座席端振铃)àoutcall(座席摘机)àcalledringing(被叫振铃)àanswer(被叫应答)àafter(话后)àagentidle(座席空闲) | ||
预测外呼正常转接座席事件顺序: | ||
logon(登录)àinringing(座席端振铃)àincall(座席端摘机)àagentidle(座席空闲) à outringing(座席端振铃)àoutboundcall(接通被叫)àafter(话后)àagentidle(座席空闲) | ||
呼入座席接听事件顺序: | ||
logon(登录)àagentidle(座席空闲)àinringing(呼入振铃)[àplaytts(播放TTS)开通后存在]àincall(座席端摘机)àafter(话后)àagentidle(座席空闲) |