Method

PurpleMediasend_dtmf

since: 2.11

Declaration [src]

gboolean
purple_media_send_dtmf (
  PurpleMedia* media,
  const gchar* session_id,
  gchar dtmf,
  guint8 volume,
  guint16 duration
)

Description [src]

Sends a DTMF signal out-of-band.

Available since: 2.11

Parameters

session_id

Type: const gchar*

The session id of the session to send the DTMF signal on.

The data is owned by the caller of the function.
The value is a NUL terminated UTF-8 string.
dtmf

Type: gchar

The character representing the DTMF in the range [0-9#*A-D].

volume

Type: guint8

The power level expressed in dBm0 after dropping the sign in the range of 0 to 63. A larger value represents a lower volume.

duration

Type: guint16

The duration of the tone in milliseconds.

Return value

Type: gboolean

TRUE DTMF sent successfully, or FALSE otherwise.