DTMF detector. More...

#include "apr.h"
#include "apr_pools.h"
#include "apt.h"
#include "mpf_frame.h"
#include "mpf_stream.h"

Typedefs
typedef APT_BEGIN_EXTERN_C enum mpf_dtmf_detector_band_e	mpf_dtmf_detector_band_e

typedef struct mpf_dtmf_detector_t	mpf_dtmf_detector_t

Enumerations
enum	mpf_dtmf_detector_band_e { MPF_DTMF_DETECTOR_INBAND = 0x1, MPF_DTMF_DETECTOR_OUTBAND = 0x2, MPF_DTMF_DETECTOR_BOTH = MPF_DTMF_DETECTOR_INBAND \| MPF_DTMF_DETECTOR_OUTBAND }

Functions
struct mpf_dtmf_detector_t *	mpf_dtmf_detector_create_ex (const struct mpf_audio_stream_t stream, enum mpf_dtmf_detector_band_e band, struct apr_pool_t pool)

char	mpf_dtmf_detector_digit_get (struct mpf_dtmf_detector_t *detector)

apr_size_t	mpf_dtmf_detector_digits_lost (const struct mpf_dtmf_detector_t *detector)

void	mpf_dtmf_detector_reset (struct mpf_dtmf_detector_t *detector)

void	mpf_dtmf_detector_get_frame (struct mpf_dtmf_detector_t detector, const struct mpf_frame_t frame)

void	mpf_dtmf_detector_destroy (struct mpf_dtmf_detector_t *detector)

Detailed Description

DTMF detector.

Detector of DTMF tones sent both out-of-band (RFC4733) and in-band (audio).

Typedef Documentation

typedef APT_BEGIN_EXTERN_C enum mpf_dtmf_detector_band_e mpf_dtmf_detector_band_e

DTMF detector band

typedef struct mpf_dtmf_detector_t mpf_dtmf_detector_t

Opaque MPF DTMF detector structure definition

Enumeration Type Documentation

enum mpf_dtmf_detector_band_e

DTMF detector band

Enumerator
MPF_DTMF_DETECTOR_INBAND	Detect tones in-band
MPF_DTMF_DETECTOR_OUTBAND	Detect named events out-of-band
MPF_DTMF_DETECTOR_BOTH	Detect both in-band and out-of-band digits

Function Documentation

struct mpf_dtmf_detector_t* mpf_dtmf_detector_create_ex	(	const struct mpf_audio_stream_t *	stream,
		enum mpf_dtmf_detector_band_e	band,
		struct apr_pool_t *	pool
	)

read

Create MPF DTMF detector (advanced).

Parameters

stream	A stream to get digits from.
band	One of: MPF_DTMF_DETECTOR_INBAND: detect audible tones only MPF_DTMF_DETECTOR_OUTBAND: detect out-of-band named-events only MPF_DTMF_DETECTOR_BOTH: detect digits in both bands if supported by stream. When out-of-band digit arrives, in-band detection is turned off.
pool	Memory pool to allocate DTMF detector from.

Returns: The object or NULL on error.

See Also: mpf_dtmf_detector_create

void mpf_dtmf_detector_destroy ( struct mpf_dtmf_detector_t * detector )

Free all resources associated with the detector.

Parameters

detector The detector.

char mpf_dtmf_detector_digit_get ( struct mpf_dtmf_detector_t * detector )

Get DTMF digit from buffer of digits detected so far and remove it.

Parameters

detector The detector.

Returns: DTMF character [0-9*#A-D] or NUL if the buffer is empty.

apr_size_t mpf_dtmf_detector_digits_lost ( const struct mpf_dtmf_detector_t * detector )

Retrieve how many digits was lost due to full buffer.

Parameters

detector The detector.

Returns: Number of lost digits.

void mpf_dtmf_detector_get_frame	(	struct mpf_dtmf_detector_t *	detector,
		const struct mpf_frame_t *	frame
	)

Detect DTMF digits in the frame.

Parameters

detector	The detector.
frame	Frame object passed in stream_write().

void mpf_dtmf_detector_reset ( struct mpf_dtmf_detector_t * detector )

Empty the buffer and reset detection states.

Parameters

detector The detector.

Typedefs

Enumerations

Functions

Detailed Description

Typedef Documentation

Enumeration Type Documentation

Function Documentation