Sip session

Version 30 (Adrian Georgescu, 09/08/2009 11:02 pm) → Version 31/44 (Adrian Georgescu, 10/29/2009 10:47 pm)

== sip_session ==

[[TOC(SipTesting*, sip_*, depth=2)]]

=== Description ===

'''sip_session''' script is a show-case for the powerful features of SIP SIMPLE software development kit related to establishing, modifying and terminating SIP sessions with multiple media types like VoIP, IM and File Transfer.

types.

The script has the following features:

1. Registers
registers with a SIP registrar and is available for registrar, handles multiple parallel incoming sessions
1. Handles
or outgoing SIP sessions with combinations of media types based on RTP and MSRP protocols including protocols, handles NAT traversal using ICE and MSRP relay extension
1. Switches
extension, switches between multiple sessions and sessions, provides in-call controls like Hold and Mute
1. Provides
control for the input, output and alert audio devices
1. Records the
devices, in-call controls like Hold, Mute and Recording of RTP audio streams (input, output or combined)
1. Enable
streams, enable text input and output for Instant Messaging sessions
1. Provides File Transfer capability with progress indicator
1. Gives access to
and delivers real-time traces trace both on console or save in a file of all involved protocols (DNS, SIP and MSRP)

protocols.

=== Example ===

{{{
adigeo@ag-imac3:~$sip_session
Using account adi@umts.ro 31208005169@ag-projects.com
adi@umts.ro> Logging SIP trace to file "/Users/adigeo/Desktop/FileTransfers/sip_trace.txt"
Logging notifications trace to file "/Users/adigeo/Desktop/FileTransfers/notifications_trace.txt"
Available audio input devices: None, system_default, Built-in Input, Built-in Microphone, Logitech Wireless Headset
Available audio output devices: None, system_default, Built-in Output, Logitech Wireless Headset
Using audio input device: Logitech Wireless Headset
Using audio output device: Built-in Output
Using audio alert device: Built-in Output
Type
/help to see a list of available commands.
2009-09-07 09:20:48 Registered contact "sip:koincezd@192.168.1.6:54441" for sip:31208005169@ag-projects.com at 81.23.228.150:5060;transport=udp (expires in 600 seconds).
Other registered contacts:
sip:31208005169@192.168.1.123:5060 (expires in 176 seconds)
sip:31208005169@192.168.1.1;uniq=5B2860C44383A3D6705629A7E1FB8 (expires in 526 seconds)
31208005169@ag-projects.com> /help
General commands:
/call {user[@domain]}: call the specified user using audio and chat
/audio {user[@domain]} [+chat]: call the specified user using audio and possibly chat
/chat {user[@domain]} [+audio]: call the specified user using chat and possibly audio
/send {user[@domain]} {file}: initiate a file transfer with the specified user
/next: select the next connected session
/prev: select the previous connected session
/sessions: show the list of connected sessions
/trace [[+|-]sip] [[+|-]msrp] [[+|-]pjsip] [[+|-]notifications]: toggle/set tracing SIP trace on the console (ctrl-x s | ctrl-x m | ctrl-x j | ctrl-x n)
/rtp [on|off]: toggle/set printing RTP statistics on the console (ctrl-x p)
/mute [on|off]: mute the microphone (ctrl-x u) m)
/input [device]: change audio input device (ctrl-x i)
/output [device]: change audio output device (ctrl-x o)
/alert [device]: change audio alert device (ctrl-x a)
/echo [+|-][value]: adjust echo cancellation (ctrl-x < | ctrl-x >)
/quit: quit the program (ctrl-x q)
/help: display this help message (ctrl-x ?)
In call commands:
/hangup: hang-up the active session (ctrl-x h)
/record [on|off]: toggle/set audio recording (ctrl-x r)
/srecord [on|off]: toggle/set audio recording to separate files for input and output
/hold [on|off]: hold/unhold (ctrl-x SPACE)
/add {chat|audio}: add a stream to the current session
/remove {chat|audio}: remove a stream from the current session
Available audio input devices: None, system_default, Built-in Input, Built-in Microphone
Available audio output devices: None, system_default, Built-in Output
Using audio input device: Built-in Microphone (system default device)
Using audio output device: Built-in Output (system default device)
Using audio alert device: Built-in Output
Type /help to see a list of available commands.
2009-10-29 22:42:14 Registered contact "sip:puioxbqy@192.168.1.124:50150" for sip:adi@umts.ro at 81.23.228.150:5060;transport=udp (expires in 600 seconds).
Other registered contacts:
sip:jiozqyud@192.168.1.124:49569 (expires in 423 seconds)
Detected NAT type: Port Restricted
adi@umts.ro>
}}}