FreeSWITCH在session上执行定时挂机与取消

一、实验场景环境描述

FreeSWITCH测试机:192.168.137.32
会议室: test1
分机: 1000

模拟的场景:
1)会议室test1邀请分机1000加入会议室
在邀请时,添加定时挂机任务。
2)分机1000接通后,需要按数字1加入会议;
3)如果分机1000在特定时间内按数字1键,则正常入会
同时,取消定时挂机任务。
4)如果分机1000未在特定时间内按数字1键,则执行超时挂机操作。

二、定时挂机描述

FreeSWITCH提供了个定时挂机的工具,工具名称: sched_hangup

sched_hangup是dptools模块提供的工具,该工具会创建一个任务,用于执行定时挂机操作,该任务的信息存储在FreeSWITCH数据库的tasks表中进行持久化,这里进行简单描述。

1)函数调用链

调用链如下:

sched_hangup_function 
    => switch_ivr_schedule_hangup 
        => switch_scheduler_add_task 
            => switch_scheduler_add_task_ex

sched_hangup_function函数如下:

FreeSWITCH在session上执行定时挂机与取消_第1张图片

 switch_ivr_schedule_hangup函数如下:

FreeSWITCH在session上执行定时挂机与取消_第2张图片

 switch_scheduler_add_task函数和switch_scheduler_add_task_ex函数如下:

FreeSWITCH在session上执行定时挂机与取消_第3张图片

 数据库写入操作:

FreeSWITCH在session上执行定时挂机与取消_第4张图片

 2)任务执行

函数调用链如下:

复制代码

main
  => switch_core_init_and_modload
    => switch_core_init
      => switch_scheduler_task_thread_start
        => switch_scheduler_task_thread 
          => task_thread_loop
              => switch_scheduler_execute

复制代码

switch_scheduler_task_thread_start 函数:

FreeSWITCH在session上执行定时挂机与取消_第5张图片

 switch_scheduler_task_thread函数:

FreeSWITCH在session上执行定时挂机与取消_第6张图片

 task_thread_loop函数:

FreeSWITCH在session上执行定时挂机与取消_第7张图片

 switch_scheduler_execute函数:

FreeSWITCH在session上执行定时挂机与取消_第8张图片

 也可以使用其它工具来实现定时挂机,原理是一样的,如何使用可参考场景实现部分。

三、如何使用定时挂机

FreeSWITCH自身提供的有定时挂机应用,可在拨号方案里面作为app使用,也可以在控制台作为api使用。

拨号方案中使用格式:

控制台中使用格式:

sched_hangup [+]

更多信息请参考官网wiki:

mod_dptools: sched hangup | FreeSWITCH Documentation

FreeSWITCH在session上执行定时挂机与取消_第9张图片

比如创建如下任务:

sched_hangup +600 2efce360-2ce2-4470-8e92-01adb048892a

可在数据库和控制台看到,其中在控制台使用如下命令查询:

show tasks

具体效果如下:

FreeSWITCH在session上执行定时挂机与取消_第10张图片

四、如何取消定时挂机

可在控制台使用如下命令进行任务删除,进而取消定时挂机:

sched_del 

FreeSWITCH在session上执行定时挂机与取消_第11张图片

五、场景实现

这里以lua脚本为例来实现定时挂机和取消挂机。

1、外呼分机时添加lua脚本回调

可通过 execute_on_answer 来实现,具体如下:

bgapi originate {execute_on_answer='lua inviteToConf.lua'}user/1000 &bridge(loopback/wait)

originate​的使用可参考我之前写的文章:

https://www.cnblogs.com/MikeZhang/p/originate20230402.html

2、获取任务id

sched_hangup 在创建任务时,会将任务id存放在数据库里面,如果要取消挂机任务,需要获取该id值。可通过如下方式获取:
1)根据session的uuid查询数据库获取任务id值;
2)使用"show tasks"解析获取任务id值;

在lua脚本里面如果想直接通过 executeString 的返回值获取,是无法办到的,因为 sched_hangup 给控制台的返回值只有 "+OK" 这个信息。

获取任务id值的方式,可从如下渠道获取:

关注微信公众号(聊聊博文,文末可扫码)后回复 20240213 获取。

3、添加拨号方案

添加转接会议室的拨号方案:

复制代码


    
        
        
    

你可能感兴趣的:(oracle,数据库,jvm)