Method
PurpleMediaManagercreate_private_media
since: 2.6
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.
Available since: 2.6
Parameters
account-
Type:
PurpleAccountThe account to create the session on.
The data is owned by the caller of the function. conference_type-
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-
Type:
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-
Type:
gbooleanTRUE if the local user is the initiator of this media call, FALSE otherwise.
Return value
Type: PurpleMedia
A newly created media session.
| The caller of the method takes ownership of the data, and is responsible for freeing it. |