Method

PurpleMediaManagercreate_private_media

Declaration [src]

PurpleMedia*
purple_media_manager_create_private_media (
  PurpleMediaManager* manager,
  PurpleAccount* account,
  const char* conference_type,
  const char* remote_user,
  gboolean initiator
)

Description [src]

Creates a private media session. A private media session is a media session which is private to the caller. It is meant to be used by plugins to create a media session that the front-end does not get notified about. It is useful especially for sessions with a type of PURPLE_MEDIA_APPLICATION which the front-end wouldn’t know how to handle.

Parameters

account PurpleAccount
 

The account to create the session on.

 The data is owned by the caller of the function.
conference_type const char*
 

The conference type to feed into Farstream.

 The data is owned by the caller of the function.
 The value is a NUL terminated UTF-8 string.
remote_user const char*
 

The remote user to initiate the session with.

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

TRUE if the local user is the initiator of this media call, FALSE otherwise.

Return value

Returns: PurpleMedia
 

A newly created media session.

 The caller of the method takes ownership of the data, and is responsible for freeing it.