Sip session

Version 35 (Adrian Georgescu, 01/24/2010 03:38 pm)

1 34 Adrian Georgescu
== sip-session ==
2 1 Adrian Georgescu
3 2 Adrian Georgescu
[[TOC(SipTesting*, sip_*, depth=2)]]
4 2 Adrian Georgescu
5 35 Adrian Georgescu
> This script is available in ''sipclients'' package that must be installed separately from SIP SIMPLe client SDK package.
6 35 Adrian Georgescu
7 4 Adrian Georgescu
=== Description ===
8 5 Adrian Georgescu
9 34 Adrian Georgescu
'''sip-session''' command line script is a show-case for the powerful features of SIP SIMPLE development kit related to establishing, modifying and terminating SIP sessions with multiple media types like VoIP, Instant Messaging and File Transfer.
10 28 Adrian Georgescu
11 31 Adrian Georgescu
The script has the following features:
12 1 Adrian Georgescu
13 1 Adrian Georgescu
 1. Registers with a SIP registrar and is available for incoming sessions
14 1 Adrian Georgescu
 1. Switches between multiple sessions and provides in-call controls like Hold and Mute
15 32 Adrian Georgescu
 1. Handles outgoing SIP sessions with combinations of media types based on RTP and MSRP protocols
16 32 Adrian Georgescu
 1. Performs NAT traversal using ICE and MSRP relay extension
17 31 Adrian Georgescu
 1. Provides control for the input, output and alert audio devices
18 31 Adrian Georgescu
 1. Records the RTP audio streams (input, output or combined) 
19 31 Adrian Georgescu
 1. Enable text input and output for Instant Messaging sessions
20 31 Adrian Georgescu
 1. Provides File Transfer capability with progress indicator
21 31 Adrian Georgescu
 1. Gives access to real-time traces of involved protocols (DNS, SIP and MSRP)
22 31 Adrian Georgescu
23 31 Adrian Georgescu
24 27 Adrian Georgescu
=== Example ===
25 27 Adrian Georgescu
26 27 Adrian Georgescu
{{{
27 34 Adrian Georgescu
adigeo@ag-imac3:~$sip-session 
28 31 Adrian Georgescu
Using account adi@umts.ro
29 31 Adrian Georgescu
adi@umts.ro> /help
30 27 Adrian Georgescu
General commands:
31 27 Adrian Georgescu
  /call {user[@domain]}: call the specified user using audio and chat
32 1 Adrian Georgescu
  /audio {user[@domain]} [+chat]: call the specified user using audio and possibly chat
33 27 Adrian Georgescu
  /chat {user[@domain]} [+audio]: call the specified user using chat and possibly audio
34 31 Adrian Georgescu
  /send {user[@domain]} {file}: initiate a file transfer with the specified user
35 27 Adrian Georgescu
  /next: select the next connected session
36 1 Adrian Georgescu
  /prev: select the previous connected session
37 1 Adrian Georgescu
  /sessions: show the list of connected sessions
38 31 Adrian Georgescu
  /trace [[+|-]sip] [[+|-]msrp] [[+|-]pjsip] [[+|-]notifications]: toggle/set tracing on the console (ctrl-x s | ctrl-x m | ctrl-x j | ctrl-x n)
39 1 Adrian Georgescu
  /rtp [on|off]: toggle/set printing RTP statistics on the console (ctrl-x p)
40 31 Adrian Georgescu
  /mute [on|off]: mute the microphone (ctrl-x u)
41 1 Adrian Georgescu
  /input [device]: change audio input device (ctrl-x i)
42 1 Adrian Georgescu
  /output [device]: change audio output device (ctrl-x o)
43 1 Adrian Georgescu
  /alert [device]: change audio alert device (ctrl-x a)
44 1 Adrian Georgescu
  /echo [+|-][value]: adjust echo cancellation (ctrl-x < | ctrl-x >)
45 27 Adrian Georgescu
  /quit: quit the program (ctrl-x q)
46 1 Adrian Georgescu
  /help: display this help message (ctrl-x ?)
47 27 Adrian Georgescu
In call commands:
48 27 Adrian Georgescu
  /hangup: hang-up the active session (ctrl-x h)
49 27 Adrian Georgescu
  /record [on|off]: toggle/set audio recording (ctrl-x r)
50 31 Adrian Georgescu
  /srecord [on|off]: toggle/set audio recording to separate files for input and output
51 27 Adrian Georgescu
  /hold [on|off]: hold/unhold (ctrl-x SPACE)
52 27 Adrian Georgescu
  /add {chat|audio}: add a stream to the current session
53 27 Adrian Georgescu
  /remove {chat|audio}: remove a stream from the current session
54 31 Adrian Georgescu
Available audio input devices: None, system_default, Built-in Input, Built-in Microphone
55 31 Adrian Georgescu
Available audio output devices: None, system_default, Built-in Output
56 31 Adrian Georgescu
Using audio input device: Built-in Microphone (system default device)
57 31 Adrian Georgescu
Using audio output device: Built-in Output (system default device)
58 31 Adrian Georgescu
Using audio alert device: Built-in Output
59 31 Adrian Georgescu
Type /help to see a list of available commands.
60 31 Adrian Georgescu
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).
61 31 Adrian Georgescu
Other registered contacts:
62 31 Adrian Georgescu
  sip:jiozqyud@192.168.1.124:49569 (expires in 423 seconds)
63 27 Adrian Georgescu
Detected NAT type: Port Restricted
64 31 Adrian Georgescu
adi@umts.ro> 
65 1 Adrian Georgescu
}}}