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.