|
@@ -86,9 +86,9 @@ Chapter 1. Admin Guide
|
|
payloads of SIP messages.
|
|
payloads of SIP messages.
|
|
|
|
|
|
Examples of functions this module offers: remove codecs from SDP, check
|
|
Examples of functions this module offers: remove codecs from SDP, check
|
|
- the media stream types, return attributes of SDP document. For the full
|
|
|
|
- list of the features provided by this module and the implementation
|
|
|
|
- state, read the list of exported functions.
|
|
|
|
|
|
+ the media stream types and return attributes of SDP document. For the
|
|
|
|
+ full list of the features provided by this module and the
|
|
|
|
+ implementation state, please read the list of exported functions.
|
|
|
|
|
|
2. Dependencies
|
|
2. Dependencies
|
|
|
|
|
|
@@ -125,11 +125,11 @@ Chapter 1. Admin Guide
|
|
4.11. sdp_get(avpvar)
|
|
4.11. sdp_get(avpvar)
|
|
4.12. sdp_content()
|
|
4.12. sdp_content()
|
|
|
|
|
|
-4.1. sdp_remove_codecs_by_id(list)
|
|
|
|
|
|
+4.1. sdp_remove_codecs_by_id(list)
|
|
|
|
|
|
Remove the codecs provided in the parameter 'list' from all media
|
|
Remove the codecs provided in the parameter 'list' from all media
|
|
- streams found in SDP payload. The parameter 'list' must be one or a
|
|
|
|
- comma separated list of numeric codec IDs. The parameter can be a
|
|
|
|
|
|
+ streams found in SDP payload. The parameter 'list' must be one item or
|
|
|
|
+ a comma separated list of numeric codec IDs. The parameter can be a
|
|
static string or a variable holding the list of numeric codec IDs.
|
|
static string or a variable holding the list of numeric codec IDs.
|
|
|
|
|
|
This function can be used from ANY_ROUTE.
|
|
This function can be used from ANY_ROUTE.
|
|
@@ -142,11 +142,11 @@ sdp_remove_codecs_by_id("0");
|
|
sdp_remove_codecs_by_id("0,8,3");
|
|
sdp_remove_codecs_by_id("0,8,3");
|
|
...
|
|
...
|
|
|
|
|
|
-4.2. sdp_remove_codecs_by_name(list)
|
|
|
|
|
|
+4.2. sdp_remove_codecs_by_name(list)
|
|
|
|
|
|
Remove the codecs provided in the parameter 'list' from all media
|
|
Remove the codecs provided in the parameter 'list' from all media
|
|
- streams found in SDP payload. The parameter 'list' must be one or a
|
|
|
|
- comma separated list of codec names. The parameter can be a static
|
|
|
|
|
|
+ streams found in SDP payload. The parameter 'list' must be one item or
|
|
|
|
+ a comma separated list of codec names. The parameter can be a static
|
|
string or a variable holding the list of codec names.
|
|
string or a variable holding the list of codec names.
|
|
|
|
|
|
This function can be used from ANY_ROUTE.
|
|
This function can be used from ANY_ROUTE.
|
|
@@ -159,15 +159,16 @@ sdp_remove_codecs_by_name("PCMU");
|
|
sdp_remove_codecs_by_name("PCMU,PCMA,GSM");
|
|
sdp_remove_codecs_by_name("PCMU,PCMA,GSM");
|
|
...
|
|
...
|
|
|
|
|
|
-4.3. sdp_remove_line_by_prefix(string)
|
|
|
|
|
|
+4.3. sdp_remove_line_by_prefix(string)
|
|
|
|
|
|
- Remove all SDP attribute lines beginning with 'string'.
|
|
|
|
|
|
+ Remove all SDP attribute lines beginning with 'string' in all media
|
|
|
|
+ streams.
|
|
|
|
|
|
This function can be used from ANY_ROUTE.
|
|
This function can be used from ANY_ROUTE.
|
|
|
|
|
|
Example 1.3. sdp_remove_line_by_prefix usage
|
|
Example 1.3. sdp_remove_line_by_prefix usage
|
|
...
|
|
...
|
|
-if ($si == "1080::8:800:200C:417A"
|
|
|
|
|
|
+if ($si == "2001:DB8::8:800:200C:417A"
|
|
and ( has_body("application/sdp") or has_body("multipart/mixed")))
|
|
and ( has_body("application/sdp") or has_body("multipart/mixed")))
|
|
{
|
|
{
|
|
xlog("L_INFO", "Cleaning ugly SDP from $si\n");
|
|
xlog("L_INFO", "Cleaning ugly SDP from $si\n");
|
|
@@ -177,11 +178,11 @@ if ($si == "1080::8:800:200C:417A"
|
|
|
|
|
|
...
|
|
...
|
|
|
|
|
|
-4.4. sdp_keep_codecs_by_id(list [, mtype])
|
|
|
|
|
|
+4.4. sdp_keep_codecs_by_id(list [, mtype])
|
|
|
|
|
|
Keep only the codecs provided in the parameter 'list' from all media
|
|
Keep only the codecs provided in the parameter 'list' from all media
|
|
- streams found in SDP payload. The parameter 'list' must be one or a
|
|
|
|
- comma separated list of numeric codec IDs. The parameter can be a
|
|
|
|
|
|
+ streams found in SDP payload. The parameter 'list' must be one item or
|
|
|
|
+ a comma separated list of numeric codec IDs. The parameter can be a
|
|
static string or a variable holding the list of numeric codec IDs.
|
|
static string or a variable holding the list of numeric codec IDs.
|
|
|
|
|
|
Optional parameter mtype can be provided to apply the operations only
|
|
Optional parameter mtype can be provided to apply the operations only
|
|
@@ -197,7 +198,7 @@ sdp_keep_codecs_by_id("0");
|
|
sdp_keep_codecs_by_id("0,8,3", "audio");
|
|
sdp_keep_codecs_by_id("0,8,3", "audio");
|
|
...
|
|
...
|
|
|
|
|
|
-4.5. sdp_keep_codecs_by_name(list [, mtype])
|
|
|
|
|
|
+4.5. sdp_keep_codecs_by_name(list [, mtype])
|
|
|
|
|
|
Keep only the codecs provided in the parameter 'list' from all media
|
|
Keep only the codecs provided in the parameter 'list' from all media
|
|
streams found in SDP payload. The parameter 'list' must be one or a
|
|
streams found in SDP payload. The parameter 'list' must be one or a
|
|
@@ -217,7 +218,7 @@ sdp_keep_codecs_by_name("PCMU");
|
|
sdp_keep_codecs_by_name("PCMU,PCMA,GSM");
|
|
sdp_keep_codecs_by_name("PCMU,PCMA,GSM");
|
|
...
|
|
...
|
|
|
|
|
|
-4.6. sdp_with_media(type)
|
|
|
|
|
|
+4.6. sdp_with_media(type)
|
|
|
|
|
|
Return true of the SDP has 'media=type ...' line. Useful to check the
|
|
Return true of the SDP has 'media=type ...' line. Useful to check the
|
|
content of the RTP sessions, such as 'audio' or 'video'. The parameter
|
|
content of the RTP sessions, such as 'audio' or 'video'. The parameter
|
|
@@ -234,7 +235,7 @@ if(sdp_with_media("video"))
|
|
}
|
|
}
|
|
...
|
|
...
|
|
|
|
|
|
-4.7. sdp_remove_media(type)
|
|
|
|
|
|
+4.7. sdp_remove_media(type)
|
|
|
|
|
|
Remove the streams that match on 'm=type ...' line. The parameter can
|
|
Remove the streams that match on 'm=type ...' line. The parameter can
|
|
be static string or variable holding the media type.
|
|
be static string or variable holding the media type.
|
|
@@ -247,7 +248,7 @@ if(sdp_with_media("video"))
|
|
sdp_remove_media("video");
|
|
sdp_remove_media("video");
|
|
...
|
|
...
|
|
|
|
|
|
-4.8. sdp_with_codecs_by_id(list)
|
|
|
|
|
|
+4.8. sdp_with_codecs_by_id(list)
|
|
|
|
|
|
Returns true if any of the codecs provided in the parameter 'list' from
|
|
Returns true if any of the codecs provided in the parameter 'list' from
|
|
all media streams is found in SDP payload. The parameter 'list' must be
|
|
all media streams is found in SDP payload. The parameter 'list' must be
|
|
@@ -264,24 +265,24 @@ if(sdp_with_codecs_by_id("0")) { ... }
|
|
if(sdp_with_codecs_by_id("0,8,3")) { ... }
|
|
if(sdp_with_codecs_by_id("0,8,3")) { ... }
|
|
...
|
|
...
|
|
|
|
|
|
-4.9. sdp_with_codecs_by_name(list)
|
|
|
|
|
|
+4.9. sdp_with_codecs_by_name(list)
|
|
|
|
|
|
Returns true if any of the codecs provided in the parameter 'list' from
|
|
Returns true if any of the codecs provided in the parameter 'list' from
|
|
all media streams is found in SDP payload. The parameter 'list' must be
|
|
all media streams is found in SDP payload. The parameter 'list' must be
|
|
- one or a comma separated list of codec names. The parameter can be a
|
|
|
|
- static string or a variable holding the list of codec names.
|
|
|
|
|
|
+ one item or a comma separated list of codec names. The parameter can be
|
|
|
|
+ a static string or a variable holding the list of codec names.
|
|
|
|
|
|
This function can be used from ANY_ROUTE.
|
|
This function can be used from ANY_ROUTE.
|
|
|
|
|
|
Example 1.9. sdp_with_codecs_by_name usage
|
|
Example 1.9. sdp_with_codecs_by_name usage
|
|
...
|
|
...
|
|
# test for PCMU
|
|
# test for PCMU
|
|
-if(sdp_with_codecs_by_id("PCMU")) { ... }
|
|
|
|
|
|
+if(sdp_with_codecs_by_name("PCMU")) { ... }
|
|
# test for PCMU, PCMA or GSM
|
|
# test for PCMU, PCMA or GSM
|
|
-if(sdp_with_codecs_by_id("PCMU,PCMA,GSM")) { ... }
|
|
|
|
|
|
+if(sdp_with_codecs_by_name("PCMU,PCMA,GSM")) { ... }
|
|
...
|
|
...
|
|
|
|
|
|
-4.10. sdp_print(level)
|
|
|
|
|
|
+4.10. sdp_print(level)
|
|
|
|
|
|
Print the SDP internal structure to log 'level'. The parameter can be
|
|
Print the SDP internal structure to log 'level'. The parameter can be
|
|
static integer or variable holding the integer value of the log level.
|
|
static integer or variable holding the integer value of the log level.
|
|
@@ -294,7 +295,7 @@ if(sdp_with_codecs_by_id("PCMU,PCMA,GSM")) { ... }
|
|
sdp_print("1");
|
|
sdp_print("1");
|
|
...
|
|
...
|
|
|
|
|
|
-4.11. sdp_get(avpvar)
|
|
|
|
|
|
+4.11. sdp_get(avpvar)
|
|
|
|
|
|
Store the SDP part of message body in an AVP. Return 1 if SDP is found,
|
|
Store the SDP part of message body in an AVP. Return 1 if SDP is found,
|
|
-1 on error and -2 if there is no SDP part in the message body.
|
|
-1 on error and -2 if there is no SDP part in the message body.
|
|
@@ -306,7 +307,7 @@ sdp_print("1");
|
|
sdp_get("$avp(sdp)");
|
|
sdp_get("$avp(sdp)");
|
|
...
|
|
...
|
|
|
|
|
|
-4.12. sdp_content()
|
|
|
|
|
|
+4.12. sdp_content()
|
|
|
|
|
|
Return true if the SIP message has SDP body or a SDP part in body.
|
|
Return true if the SIP message has SDP body or a SDP part in body.
|
|
|
|
|