Function

PurpleProtocolinitiate_media

since: 3.0

Declaration [src]

gboolean
purple_protocol_initiate_media (
  PurpleAccount* account,
  const char* who,
  PurpleMediaSessionType type
)

Description [src]

Initiates a media session with the given contact.

Available since: 3.0

Parameters

account

Type: PurpleAccount

The account the user is on.

The data is owned by the caller of the function.
who

Type: const char*

The name of the contact to start a session with.

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

Type: PurpleMediaSessionType

The type of media session to start.

Return value

Type: gboolean

TRUE if the call succeeded else FALSE. (Doesn’t imply the media session or stream will be successfully created)