Function

PurpleProtocolinitiate_media

Declaration [src]

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

Description [src]

Initiates a media session with the given contact.

Parameters

account PurpleAccount
 

The account the user is on.

 The data is owned by the caller of the function.
who 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 PurpleMediaSessionType
 

The type of media session to start.

Return value

Returns: gboolean
 

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