/// <summary>
        /// Disposes the softphone engine. Hangs up calls, unregisters phone lines and disposes the media handlers.
        /// </summary>
        public void Dispose()
        {
            lock (_sync)
            {
                PhoneCalls.Clear();

                // unregister phone lines
                foreach (IPhoneLine line in PhoneLines)
                {
                    if (line.RegState == RegState.RegistrationSucceeded)
                    {
                        softPhone.UnregisterPhoneLine(line);
                    }

                    UnsubscribeFromLineEvents(line);
                    line.Dispose();
                }
                PhoneLines.Clear();

                // dispose media
                MediaHandlers.Dispose();

                // close softphone
                softPhone.Close();
            }
        }
        public SoftphoneEngine()
        {
            _sync = new object();


            // set license here

            PhoneLines      = new ObservableList <IPhoneLine>();
            PhoneCalls      = new ObservableList <IPhoneCall>();
            LogEntries      = new ObservableList <LogEntry>();
            InstantMessages = new ObservableList <string>();
            CallHistory     = new CallHistory();
            CallTypes       = new List <CallType> {
                CallType.Audio, CallType.AudioVideo
            };

            _subs = new ConcurrentDictionary <IPhoneLine, ISIPSubscription>();

            // enable file logging
            //InitLogger(); TODO : Uncomment Later

            // create softphone
            MinPort = 20000;
            MaxPort = 20500;
            //LocalIP = SoftPhoneFactory.GetLocalIP();
            InitSoftphone(false);

            // create media
            MediaHandlers = new MediaHandlers();
            MediaHandlers.Init();
        }
        /// <summary>
        /// Stops the DTMF singalling.
        /// </summary>
        internal void StopDtmfSignal(DtmfNamedEvents signal)
        {
            lock (_sync)
            {
                MediaHandlers.StopDtmf(signal);

                if (SelectedCall == null)
                {
                    return;
                }

                SelectedCall.StopDTMFSignal(signal);
            }
        }
        private void CheckStopRingtone()
        {
            lock (_sync)
            {
                bool stopRinging = true;
                foreach (var phoneCall in PhoneCalls)
                {
                    if (phoneCall.IsIncoming && phoneCall.CallState.IsRinging())
                    {
                        stopRinging = false;
                        break;
                    }
                }

                if (stopRinging)
                {
                    MediaHandlers.StopRingtone();
                }
            }
        }
        /// <summary>
        /// This will be called when the state of a call has changed.
        /// </summary>
        private void Call_CallStateChanged(object sender, CallStateChangedArgs e)
        {
            IPhoneCall call = sender as IPhoneCall;

            if (call == null)
            {
                return;
            }

            CallState state = e.State;

            //Get the call state
            callState = state;

            OnPhoneCallStateChanged(call);
            CheckStopRingback();
            CheckStopRingtone();

            lock (_sync)
            {
                // start ringtones
                if (state.IsRinging())
                {
                    if (call.IsIncoming)
                    {
                        MediaHandlers.StartRingtone();
                    }
                    else
                    {
                        MediaHandlers.StartRingback();
                    }

                    return;
                }

                // call has been answered
                if (state == CallState.Answered)
                {
                    return;
                }

                // attach media to the selected call when the remote party sends media data
                if (state.IsRemoteMediaCommunication())
                {
                    if (SelectedCall.Equals(call))
                    {
                        MediaHandlers.AttachAudio(call);
                        //MediaHandlers.AttachVideo(call);
                    }
                    return;
                }

                // detach media from the selected call in hold state or when the call has ended
                if (state == CallState.LocalHeld || state == CallState.InactiveHeld || state.IsCallEnded())
                {
                    if (SelectedCall != null && SelectedCall.Equals(call))
                    {
                        MediaHandlers.DetachAudio();
                        //MediaHandlers.DetachVideo();
                    }
                }

                // call has ended, clean up
                if (state.IsCallEnded())
                {
                    DisposeCall(call);

                    CallHistory.Add(call);
                    PhoneCalls.Remove(call);
                }
            }
        }
        /// <summary>
        /// This will be called when the other party stopped DTMF signaling.
        /// </summary>
        private void Call_DtmfReceived(object sender, VoIPEventArgs <DtmfInfo> e)
        {
            DtmfSignal signal = e.Item.Signal;

            MediaHandlers.StopDtmf(signal.Signal);
        }
        /// <summary>
        /// This will be called when the other party started DTMF signaling.
        /// </summary>
        private void Call_DtmfStarted(object sender, VoIPEventArgs <DtmfInfo> e)
        {
            int signal = e.Item.Signal.Signal;

            MediaHandlers.StartDtmf(signal);
        }