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

Audio recording device name

Audio playback device name

Video input (e.g. camera) device name

Video output (e.g. window) device name

Video preview (e.g. window) device name

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.

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.

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

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

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

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

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

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

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

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

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

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

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

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

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.

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.

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

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

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

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

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

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

Set the number of hardware sound buffers to use.

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

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

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.

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

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 Fri Dec 11 06:24:15 2009 for OPAL by  doxygen 1.5.6