OpalParamGeneral Struct Reference

#include <opal.h>

List of all members.

Public Attributes

const char * m_audioRecordDevice
const char * m_audioPlayerDevice
const char * m_videoInputDevice
const char * m_videoOutputDevice
const char * m_videoPreviewDevice
const char * m_mediaOrder
const char * m_mediaMask
const char * m_autoRxMedia
const char * m_autoTxMedia
const char * m_natRouter
const char * m_stunServer
unsigned m_tcpPortBase
unsigned m_tcpPortMax
unsigned m_udpPortBase
unsigned m_udpPortMax
unsigned m_rtpPortBase
unsigned m_rtpPortMax
unsigned m_rtpTypeOfService
unsigned m_rtpMaxPayloadSize
unsigned m_minAudioJitter
unsigned m_maxAudioJitter
OpalSilenceDetectMode m_silenceDetectMode
unsigned m_silenceThreshold
unsigned m_signalDeadband
unsigned m_silenceDeadband
unsigned m_silenceAdaptPeriod
OpalEchoCancelMode m_echoCancellation
unsigned m_audioBuffers
OpalMediaDataFunction m_mediaReadData
OpalMediaDataFunction m_mediaWriteData
OpalMediaDataType m_mediaDataHeader
OpalMessageAvailableFunction m_messageAvailable
const char * m_mediaOptions


Detailed Description

General parameters for the OpalCmdSetGeneralParameters command. This is only passed to and returned from the OpalSendMessage() function.

Example: OpalMessage command; OpalMessage * response;

memset(&command, 0, sizeof(command)); command.m_type = OpalCmdSetGeneralParameters; command.m_param.m_general.m_stunServer = "stun.voxgratia.org"; command.m_param.m_general.m_mediaMask = "RFC4175*"; response = OpalSendMessage(hOPAL, &command);


Member Data Documentation

const char* OpalParamGeneral::m_audioRecordDevice

Audio recording device name

const char* OpalParamGeneral::m_audioPlayerDevice

Audio playback device name

const char* OpalParamGeneral::m_videoInputDevice

Video input (e.g. camera) device name

const char* OpalParamGeneral::m_videoOutputDevice

Video output (e.g. window) device name

const char* OpalParamGeneral::m_videoPreviewDevice

Video preview (e.g. window) device name

const char* OpalParamGeneral::m_mediaOrder

List of media format names to set the preference order for media. This list of names (e.g. "G.723.1") is separated by the '
' character.

const char* OpalParamGeneral::m_mediaMask

List of media format names to set media to be excluded. This list of names (e.g. "G.723.1") is separated by the '
' character.

const char* OpalParamGeneral::m_autoRxMedia

List of media types (e.g. audio, video) separated by spaces which may automatically be received automatically.

const char* OpalParamGeneral::m_autoTxMedia

List of media types (e.g. audio, video) separated by spaces which may automatically be transmitted automatically.

const char* OpalParamGeneral::m_natRouter

The host name or IP address of the Network Address Translation router which may be between the endpoint and the Internet.

const char* OpalParamGeneral::m_stunServer

The host name or IP address of the STUN server which may be used to determine the NAT router characteristics automatically.

unsigned OpalParamGeneral::m_tcpPortBase

Base of range of ports to use for TCP communications. This may be required by some firewalls.

unsigned OpalParamGeneral::m_tcpPortMax

Max of range of ports to use for TCP communications. This may be required by some firewalls.

unsigned OpalParamGeneral::m_udpPortBase

Base of range of ports to use for UDP communications. This may be required by some firewalls.

unsigned OpalParamGeneral::m_udpPortMax

Max of range of ports to use for UDP communications. This may be required by some firewalls.

unsigned OpalParamGeneral::m_rtpPortBase

Base of range of ports to use for RTP/UDP communications. This may be required by some firewalls.

unsigned OpalParamGeneral::m_rtpPortMax

Max of range of ports to use for RTP/UDP communications. This may be required by some firewalls.

unsigned OpalParamGeneral::m_rtpTypeOfService

Value for the Type Of Service byte with UDP/IP packets which may be used by some routers for simple Quality of Service control.

unsigned OpalParamGeneral::m_rtpMaxPayloadSize

Maximum payload size for RTP packets. This may sometimes need to be set according to the MTU or the underlying network.

unsigned OpalParamGeneral::m_minAudioJitter

Minimum jitter time in milliseconds. For audio RTP data being received this sets the minimum time of the adaptive jitter buffer which smooths out irregularities in the transmission of audio data over the Internet.

unsigned OpalParamGeneral::m_maxAudioJitter

Maximum jitter time in milliseconds. For audio RTP data being received this sets the maximum time of the adaptive jitter buffer which smooths out irregularities in the transmission of audio data over the Internet.

OpalSilenceDetectMode OpalParamGeneral::m_silenceDetectMode

Silence detection mode. This controls the silence detection algorithm for audio transmission: 0=no change, 1=disabled, 2=fixed, 3=adaptive.

unsigned OpalParamGeneral::m_silenceThreshold

Silence detection threshold value. This applies if m_silenceDetectMode is fixed (2) and is a PCM-16 value.

unsigned OpalParamGeneral::m_signalDeadband

Time signal is required before audio is transmitted. This is is RTP timestamp units (8000Hz).

unsigned OpalParamGeneral::m_silenceDeadband

Time silence is required before audio is transmission is stopped. This is is RTP timestamp units (8000Hz).

unsigned OpalParamGeneral::m_silenceAdaptPeriod

Window for adapting the silence threashold. This applies if m_silenceDetectMode is adaptive (3). This is is RTP timestamp units (8000Hz).

OpalEchoCancelMode OpalParamGeneral::m_echoCancellation

Accoustic Echo Cancellation control. 0=no change, 1=disabled, 2=enabled.

unsigned OpalParamGeneral::m_audioBuffers

Set the number of hardware sound buffers to use.

OpalMediaDataFunction OpalParamGeneral::m_mediaReadData

Callback function for reading raw media data. See OpalMediaDataFunction for more information.

OpalMediaDataFunction OpalParamGeneral::m_mediaWriteData

Callback function for writing raw media data. See OpalMediaDataFunction for more information.

OpalMediaDataType OpalParamGeneral::m_mediaDataHeader

Indicate that the media read/write callback function is passed the full RTP header or just the payload. 0=no change, 1=payload only, 2=with RTP header.

OpalMessageAvailableFunction OpalParamGeneral::m_messageAvailable

If non-null then this function is called before the message is queued for return in the GetMessage(). See the OpalMessageAvailableFunction for more details.

const char* OpalParamGeneral::m_mediaOptions

List of media format options to be set. This is a '
' separated list of entries of the form "codec:option=value". Codec is either a media type (e.g. "Audio" or "Video") or a specific media format, for example: "G.723.1:Tx Frames Per Packet=2\nH.263:Annex T=0\n" "Video:Max Rx Frame Width=176\nVideo:Max Rx Frame Height=144"


The documentation for this struct was generated from the following file:
Generated on Mon Feb 23 02:02:01 2009 for OPAL by  doxygen 1.5.1