如何开发一个带有定期播放信息消息的呼叫队列，使用 C# 改进您的 VoIP PBX

为了使您的呼叫队列更用户友好，您还可以通过实现一些高级功能以及周期性播放信息消息流来改进它。因此，您的呼叫者将获得有关当前预计等待时间的信息。这样，（形象地说）您可以缩短等待时间，保持呼叫者的冷静。这也可以鼓励呼叫者在等待呼叫队列时不要挂断电话。在本节中，我将向您展示如何创建此功能。

我使用了 CallQueueHandlerContainer （**代码示例 7**）和 CallHistory （**代码示例 8**）类，让文本转语音引擎为排队的呼叫者朗读预先写好的消息。这条消息将每 15 秒告知他们预期的等待时间。

**如下所示**，CallQueueHandlerContainer 类将 callQueueCallHandler 对象存储在一个列表中（换句话说：呼叫）并隐藏所有可以执行的操作（例如 Add、Count、GetIndex、Remove 和 Next）。因此，可以轻松识别呼叫在呼叫队列中的排名。您只需要调用 GetIndex 方法。

using System;  
using System.Collections.Generic;  
  
namespace MyPBX.CallQueue  
{  
    class CallQueueHandlerContainer  
    {  
        List<CallQueueCallHandler> callQueueCallHandlers;  
  
        public CallQueueHandlerContainer()  
        {  
            callQueueCallHandlers = new List<CallQueueCallHandler>();      
        }  
  
        public void Add(CallQueueCallHandler callHandler)  
        {  
            callQueueCallHandlers.Add(callHandler);  
        }  
  
        public int Count()  
        {  
            return callQueueCallHandlers.Count;  
        }  
  
        public int GetIndex(CallQueueCallHandler callHandler)  
        {  
            return callQueueCallHandlers.IndexOf(callHandler);  
        }  
  
        public void Remove(CallQueueCallHandler callHandler)  
        {  
            callQueueCallHandlers.Remove(callHandler);  
        }  
  
        public CallQueueCallHandler Next()  
        {  
            if (callQueueCallHandlers.Count == 0)  
                return null;  
            return callQueueCallHandlers[0];  
        }  
    }  
}

代码示例 7： CallQueueHandlerContainer 类

**代码示例 8** 介绍了 CallHistory 类，该类处理内置系统呼叫，并使这些数据可访问。您只需要调用 GetCallHistrory 方法。

using System.Collections.Generic;  
using Ozeki.VoIP.PBX.Services;  
using Ozeki.VoIP.PBX.PhoneCalls.Session;  
  
namespace MyPBX.CallQueue  
{  
    class CallHistory  
    {  
        static Dictionary<string, List<ISession>> callHistoryStatistics = new Dictionary<string, List<ISession>>();  
   
        public static void Init(ICallManager callManager)  
        {  
            callManager.SessionClosed += callManager_SessionClosed;  
        }  
  
        public static List<ISession> GetCallHistory(string userId)  
        {  
            if(!callHistoryStatistics.ContainsKey(userId))  
                return new List<ISession>();  
  
            return callHistoryStatistics[userId];  
        }  
  
        static void callManager_SessionClosed(object sender, Ozeki.VoIP.VoIPEventArgs<Ozeki.VoIP.PBX.PhoneCalls.Session.ISession> e)  
        {  
            var callee = e.Item.CalleeInfo.Owner.Account.UserName;  
  
            UpdateCallStatistics(callee, e.Item);  
  
        }  
  
        private static void UpdateCallStatistics(string party, ISession session)  
        {  
            if (!callHistoryStatistics.ContainsKey(party))  
                callHistoryStatistics[party] = new List<ISession>();  
  
            callHistoryStatistics[party].Add(session);  
        }  
    }  
}

代码示例 8： CallHistory 类

要实现自动信息播放，您需要在 CallQueueCallHandler 类中创建一个 textToSpeech 对象。因此，您的呼叫者将获得有关他们在队列中的位置和预计等待时间的信息。考虑到在信息消息之前和之后可以听到 mp3 音乐，您需要使用 AudioMixesMediaHandler 将它们与呼叫链接起来。

**代码示例 9** 显示了 timer_Elapsed 方法，可用于计算预计等待时间。

void timer_Elapsed(object sender, ElapsedEventArgs e)  
        {  
            if (!call.CallState.IsInCall())  
                return;  
  
            var memb = new List<string>(members);  
              
            foreach (var activeSession in callManager.ActiveSessions)  
            {  
                var callee = activeSession.CalleeInfo.Owner.Account.UserName;  
                var caller = activeSession.CallerInfo.Owner.Account.UserName;  
  
                memb.Remove(callee);  
                memb.Remove(caller);  
  
                double sum = 0;  
                var callCounter = 0;  
                  
                foreach (var m in memb)  
                {  
                    List<ISession> historyResult = CallHistory.GetCallHistory(m);  
  
                    foreach (var session in historyResult)  
                    {  
                        ++callCounter;  
                        sum += session.TalkDuration.TotalSeconds;  
                    }  
                }  
  
                if (sum != 0)  
                {  
                    waitingTime = sum / callCounter;  
                }  
            }  
  
            if(!blindTransferEnabled)  
                return;  
  
            foreach (var member in memb)  
            {  
                if (extensionContainer.GetExtension(member) != null)  
                {  
                    call.BlindTransfer(member);  
                }  
            }  
        }

代码示例 9： timer_Elapsed 方法

为了确定预计的等待时间，程序将遍历座席的通话记录以计算平均通话时长。（请注意，在此项目中仅使用了一个座席。）

为了能够持续为呼叫者提供信息，您需要创建一个新的计时器。它将在每 15 秒后触发，然后调用 timerAgent_Elapsed 方法（**代码示例 10**）。此方法将暂停 mp3 流，直到 textToSpeech 方法朗读完客户的位置和预计等待时间。（如果没有活动的呼叫，程序将不会计算等待时间，也不会播放信息消息，因为呼叫者将被直接转接给座席。）需要使用 Clear 方法清除 textToSpeech 。

void timerAgent_Elapsed(object sender, ElapsedEventArgs e)  
        {  
            mp3Player.PauseStreaming();  
            textToSpeech.Clear();  
  
            if (waitingTime == 0)  
            {  
                textToSpeech.AddAndStartText(string.Format("{0} more customers are waiting in line before you. Please be patient.",  
                                                           callQueueHandlerContainer.GetIndex(this)));  
            }  
            else  
            {  
                textToSpeech.AddAndStartText(string.Format("{0} more customers are waiting in line before you. " +  
                                                           "Your estimated wait time is approximately {1} seconds. Please be patient.",  
                                                           callQueueHandlerContainer.GetIndex(this),  
                                                           (int)waitingTime));  
            }  
        }

代码示例 10： timerAgent_Elapsed 方法

**如下所示**，当 textToSpeech 方法完成时（即，它已注册到 TextToSpeechCompleted 方法），它将被执行。在这里，您可以重置 mp3 音乐的流。

void TextToSpeechCompleted(object sender, EventArgs e)  
        {  
            mp3Player.StartStreaming();  
            textToSpeech.Clear();  
        }

代码示例 11： TextToSpeechCompleted 方法

摘要

总而言之，由于 VoIP 技术，您现有的 VoIP PBX 可以通过实现一些有用的附加功能轻松得到改进。可能的特性中一个重要的就是呼叫排队。在本文中，我描述了如何创建一个虚拟呼叫队列分机来接受同时呼入的电话。我试图通过实现 mp3 音乐流和周期性信息消息播放来使我的呼叫队列更用户友好。我的解决方案是用 C# 编写的，我使用了 Microsoft Visual Studio 和 Ozeki VoIP SIP SDK。