SIP SIMPLE Client SDK

h1. = Testing

=

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

To test SIP SIMPLE client SDK, you can use the Command Line Tools provided by the *sipclients* '''sipclients''' package. The Command Line Tools are compatible with MacOSX and Linux only.

h2.

== Configuration

==

Manage global and SIP account settings used by middleware and Command Line Tools

* [wiki:sip_settings sip-settings]

* [[sip_settings|sip-settings]]

h2. == Accounts


==

To use the Command Line Tools you need at least one SIP account. By default the Bonjour account is enabled and set as default. Using Bonjour account, you can initiate outbound sessions and receive incoming session on the local LAN. To use the Command Line Tools on the public Internet, you must setup at least a public SIP account. You can register a public SIP account for free at http://sip2sip.info

To add a new SIP account:

<pre>
{{{
sip-settings -a add user@domain pasword
</pre> }}}

If you have multiple accounts, you can set the default as follows:

<pre>
{{{
sip-settings -a default user@domain
</pre> }}}

It is recommended that you set the outbound proxy for the configured account to the SIP server address provided by the SIP service that provided the account. This typically facilitates the NAT traversal for media sessions that go outside of the local domains served by the SIP service provider that issued the account. Example for a sip2sip.info account:

<pre>
{{{
sip-settings -a set xyz@sip2sip.info sip.outbound_proxy=proxy.sipthor.net
</pre>

h2. }}}

== Register

==

You can use this script to Register a SIP end-point with a SIP Registrar or broadcast the local SIP URI using Bonjour mDNS.



* [[sip_register|sip-register]] [wiki:sip_register sip-register] - REGISTER a SIP end-point with a SIP Registrar or detect Bonjour neighbours

h2.

== Audio

==

You can use these script to receive or initiate audio sessions.



* [[sip_audio_session|sip-audio-session]] [wiki:sip_audio_session sip-audio-session] - Setup a single SIP audio session using RTP/sRTP media

* [[sip_session|sip-session]] [wiki:sip_session sip-session] - Setup one or more SIP sessions with Audio (RTP/sRTP), IM and File Transfer (MSRP)

h2.

== Instant Messaging

==

You can use these script to receive or initiate IM sessions or to send and receive Short Messages.



* [[sip_session|sip-session]] [wiki:sip_session sip-session] - Setup one or more SIP sessions with Audio (RTP/sRTP), IM and File Transfer (MSRP)

* [[sip_message|sip-message]] [wiki:sip_message sip-message] - Send and receive short messages in paging mode using SIP MESSAGE method

h2.

== Presence

==

You can use these scripts to Publish, Subscribe and handle incoming Notifies to and from a Presence Agent or manage documents on an XCAP server.



* [[sip_publish_presence|sip-publish-presence]] [wiki:sip_publish_presence sip-publish-presence] - PUBLISH presence to a Presence Agent

* [[sip_subscribe_winfo|sip-subscribe-winfo]] [wiki:sip_subscribe_winfo sip-subscribe-winfo] - SUBSCRIBE to the watcher list for given SIP address on the Presence Agent

* [[sip_subscribe_presence|sip-subscribe-presence]] [wiki:sip_subscribe_presence sip-subscribe-presence] - SUBSCRIBE to Presence Event for a given SIP address

* [[sip_subscribe_rls|sip-subscribe-rls]] [wiki:sip_subscribe_rls sip-subscribe-rls] - SUBSCRIBE for Presence Event to a list managed by a Resource List Server

* [[sip_subscribe_xcap_diff|sip-subscribe-xcap-diff]] [wiki:sip_subscribe_xcap_diff sip-subscribe-xcap-diff] - SUBSCRIBE for xcap-diff Event to monitor changes to XCAP documents

* [[sip_subscribe_mwi|sip-subscribe-mwi]] [wiki:sip_subscribe_mwi sip-subscribe-mwi] - SUBSCRIBE for Message Waiting Indicator

* [[xcap_directory|xcap-directory]] [wiki:xcap_directory xcap-directory] - Show the XCAP documents stored in the XCAP server for the given account

* [[xcap_icon|xcap-icon]] [wiki:xcap_icon xcap-icon] - Stores and retrieves the icon for the given account

* [[xcap_pres_rules|xcap-pres-rules]] [wiki:xcap_pres_rules xcap-pres-rules] - Manage the content of the pres-rules XCAP document

* [[xcap_dialog_rules|xcap-dialog-rules]] [wiki:xcap_dialog_rules xcap-dialog-rules] - Manage the content of the dialog-rules XCAP document

* [[xcap_rls_services|xcap-rls-services]] [wiki:xcap_rls_services xcap-rls-services] - Manage the content of a RLS services XCAP document