No Custom Parameters
Establishes both Rx and Tx RTP streams for a new or reserved connection on a media engine.
CreateConnection can be used to either create an entirely new connection on the media engine, or establish transmit properties
on a connection previously created by
To cause the audio stream to send to a multicast IP address, specify a multicast IP address in the
MediaTxIP parameter. Note that the Cisco Unified Media Engine
A connection established with
CreateConnection should always be deleted by using
Media connections are a limited resource, and so must be managed carefully.
CreateConnection is implicitly invoked by
with the transmit and receive properties automatically set correctly based on the media negotiation for the call.
A connection created in this manner is also automatically disconnected when the call is hung up or transferred.
For the lifetime of a connection created via
ReserveConnection, one RTP resource is used. If a low bitrate codec is used for this connection, then one Enhanced RTP resource is also used in conjuction with the RTP resource for the lifetime of the connection.
|Parameter Name||.NET Type||Default||Description|
|MediaTxCodec||The codec to use for the RTP stream outbound from the media engine. Valid values are |
|MediaTxIP *||The IP address that the Tx RTP stream will transmit audio to.|
|MediaTxPort *||The port that the Tx RTP stream will transmit audio to.|
|MmsId||The ID of the media engine to create the connection on.
This field is only relevant if |
|MediaTxControlIP||The RTCP IP address of the remote endpoint.|
|MediaTxControlPort||The RTCP port of the remote endpoint.|
|MediaRxCodec||The codec to use for the RTP stream inbound to the media engine. Valid values are |
|MediaRxFramesize||The framesize (in milliseconds) to use for the RTP stream inbound to the media engine. If not specified, the media engine configuration file defines the framesize to use, which by default is 20ms.|
|MediaTxFramesize||The framesize (in milliseconds) to use for the RTP stream outbound from the media engine. If not specified, the media engine configuration file defines the framesize to use, which by default is 20ms.|
|Parameter Name||.NET Type||Description|
|MmsId||Unique identifier used to identify the media engine in control of this connection. A common use for this ID is to ensure that other connections which will ultimately be conferenced with this connection are all created on the same media engine. This correlation is necessary because all connections in a single conference must all reside on the same media engine.|
|ConnectionId||Unique identifier used to identify this connection in all subsequent Media Control operations.|
|MediaRxPort||The port that the Rx RTP stream must be sent to for this connection.|
|MediaRxControlIP||The RTCP IP address of the media engine which is in control of this connection.|
|MediaRxControlPort||The RTCP port of the connection.|
|ResultCode||A numeric code indicating the result status of the operation. A '0' indicates success; a positive number indicates an error. Please reference the Media Control Error Codes table for descriptions on specific error codes.|
|MediaRxIP||The IP address that the Rx RTP stream must be sent to for this connection.|