Fork me on GitHub
 All Data Structures Files Functions Variables Typedefs Enumerations Enumerator Macros Groups Pages
SIPre plugin documentation

This is basically a clone of the original SIP plugin, with the key difference being that it uses libre (http://creytiv.com/re.html) instead of Sofia SIP for its internal stack. As such, it provides an alternative for those who don't want to, or can't, use the Sofia-based SIP plugin. The API it exposes is exactly the same, meaning it should be pretty straightforward to switch from one plugin to another on the client side. The configuration file looks exactly the same as well. As such, you can mostly refer to the SIP plugin documentation for both.

SIPre Plugin API

All requests you can send in the SIPre Plugin API are asynchronous, which means all responses (successes and errors) will be delivered as events with the same transaction.

The supported requests are register , unregister , call , accept, info , message , dtmf_info , recording , hold , unhold and hangup . register can be used, as the name suggests, to register a username at a SIP registrar to call and be called, while unregister unregisters it; call is used to send an INVITE to a different SIP URI through the plugin, while accept is used to accept the call in case one is invited instead of inviting; hold and unhold can be used respectively to put a call on-hold and to resume it; info allows you to send a generic SIP INFO request, while dtmf_info is focused on using INFO for DTMF instead; message is the method you use to send a SIP message to the other peer; recording is used, instead, to record the conversation to one or more .mjr files (depending on the direction you want to record); finally, hangup can be used to terminate the communication at any time, either to hangup (BYE) an ongoing call or to cancel/decline (CANCEL/BYE) a call that hasn't started yet.

Actual API docs: TBD. For the time being, refer to the Sofia SIP plugin documentation, as while some of the features listed there may not be available in the SIPre plugin as of now, all of the messages are supposed to be formatted exactly the same way.