annotate libpurple/protocols/jabber/usertune.h @ 17593:759cd72bd2ff

Replaced a clean and simple API with a very weird hack due to vivid request on #pidgin by multiple devs. This avoids the change in PurplePluginProtocolInfo, but requires complicated change tracking in every prpl. The others prpl should add this change tracking, too (since otherwise the status gets changed even though nothing they care about changed), but that's not up to me.

/*
 * purple - Jabber Protocol Plugin
 *
 * Copyright (C) 2007, Andreas Monitzer <[e-mail]>
 *
 * This program is free software; you can redistribute it and/or modify
 * it under the terms of the GNU General Public License as published by
 * the Free Software Foundation; either version 2 of the License, or
 * (at your option) any later version.
 *
 * This program is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.	 See the
 * GNU General Public License for more details.
 *
 * You should have received a copy of the GNU General Public License
 * along with this program; if not, write to the Free Software
 * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA	 02111-1307	 USA
 *
 */

#ifndef _PURPLE_JABBER_USERTUNE_H_
#define _PURPLE_JABBER_USERTUNE_H_

#include "jabber.h"

/* Implementation of XEP-0118 */

typedef struct _PurpleJabberTuneInfo PurpleJabberTuneInfo;
struct _PurpleJabberTuneInfo {
	char *artist;
	char *title;
	char *album;
	char *track; /* either the index of the track in the album or the URL for a stream */
	int time; /* in seconds, -1 for unknown */
	char *url;
};

void jabber_tune_init(void);

void jabber_tune_set(PurpleConnection *gc, const PurpleJabberTuneInfo *tuneinfo);

#endif /* _PURPLE_JABBER_USERTUNE_H_ */