Prosody RTP processing: API: sm_vmptx_config_codec_g729ab
Prototype Definition
int sm_vmptx_config_codec_g729ab(struct sm_vmptx_codec_g729ab_parms *codecp)
Parameters
- *codecp
-
a structure of the following type:
typedef struct sm_vmptx_codec_g729ab_parms {
tSMVMPtxId vmptx; /* in */
tSM_INT payload_type; /* in */
enum kSMVMPTxVADMode VADMode; /* in */
tSM_INT ptime; /* in */
} SM_VMPTX_CODEC_G729AB_PARMS;
Description
This requires the module
g729ab
to have been downloaded.
Fields
- vmptx
- The VMP[tx] to which to add the codec
- payload_type
- The payload type identifer to use with this codec (see
IETF RFC 3550
section 13). Supplying a value of
-1 will remove any payload type configuration from the
codec preventing its use.
- VADMode
- The mode of operation for the voice activity detector. The codec will
generate only 'A' frames if the mode is
kSMVMPTxVADModeDisabled,
otherwise both 'A' and 'B' frames may be produced. The codec does not
perform DTX.
One of these values:
- kSMVMPTxVADModeDisabled
- Disable VAD - all data delivered to the VMP[tx] is encoded and sent
- kSMVMPTxVADModeEnabled
- Enable VAD - if the signal is inactive, no data is sent (DTX)
- kSMVMPTxVADModeComfortNoise
- Enable VAD with comfort noise generation - if the signal is inactive,
comfort noise packets are sent. If the main codec does not define
its own comfort noise, it must have been configured by
sm_vmptx_config_codec_comfort_noise().
- ptime
- The length of the RTP media, in milliseconds, to send in each packet.
It is usually desirable to send 20 ms packets. Applications
should specify
ptime
as a multiple of 10 ms.
Returns
0
if call completed successfully, otherwise a standard error such as:
- ERR_SM_DEVERR - device error
This function is part of the Prosody RTP processing API.