comparison libpurple/prpl.h @ 26190:d6e23439b77c

Change purple_prpl_can_do_media to purple_prpl_get_media_caps. This allows for it to only be called once. From the caps returned you can then tell which media capabilities a buddy has without having to call the function for each different type.

26189:76104100cb87

	/**
	 * Checks to see if the given contact supports the given type of media session.
	 *
	 * @param conn The connection the contact is on.
	 * @param who The remote user to check for media capability with.
	 * @param type The type of media session to check for.
	 * @return @c TRUE The contact supports the given media type, or @c FALSE otherwise.
	 */
	gboolean (*can_do_media)(PurpleConnection *gc, const char *who,
				 PurpleMediaSessionType type);
};

#define PURPLE_PROTOCOL_PLUGIN_HAS_FUNC(prpl, member) \
	(((G_STRUCT_OFFSET(PurplePluginProtocolInfo, member) < G_STRUCT_OFFSET(PurplePluginProtocolInfo, struct_size)) \
	  || (G_STRUCT_OFFSET(PurplePluginProtocolInfo, member) < prpl->struct_size)) && \

/**
 * Determines if the contact supports the given media session type.
 *
 * @param account The account the user is on.
 * @param who The name of the contact to check capabilities for.
 * @param type The type of media session to check for.
 *
 * @return @c TRUE if the contact supports the session type, else @c FALSE.
 */
gboolean purple_prpl_can_do_media(PurpleAccount *account,
				  const char *who, 
				  PurpleMediaSessionType type);

/**
 * Initiates a media session with the given contact.
 *
 * @param account The account the user is on.

26190:d6e23439b77c

	/**
	 * Checks to see if the given contact supports the given type of media session.
	 *
	 * @param conn The connection the contact is on.
	 * @param who The remote user to check for media capability with.
	 * @return The media caps the contact supports.
	 */
	PurpleMediaCaps (*get_media_caps)(PurpleConnection *gc,
					  const char *who);
};

#define PURPLE_PROTOCOL_PLUGIN_HAS_FUNC(prpl, member) \
	(((G_STRUCT_OFFSET(PurplePluginProtocolInfo, member) < G_STRUCT_OFFSET(PurplePluginProtocolInfo, struct_size)) \
	  || (G_STRUCT_OFFSET(PurplePluginProtocolInfo, member) < prpl->struct_size)) && \

/**
 * Determines if the contact supports the given media session type.
 *
 * @param account The account the user is on.
 * @param who The name of the contact to check capabilities for.
 *
 * @return The media caps the contact supports.
 */
PurpleMediaCaps purple_prpl_get_media_caps(PurpleAccount *account,
				  const char *who);

/**
 * Initiates a media session with the given contact.
 *
 * @param account The account the user is on.