SFSBuddyEvent

This example sends a request to add a buddy.

function someMethod()
{
	sfs.addEventListener(SFS2X.SFSBuddyEvent.BUDDY_ADD, onBuddyAdded, this);
	sfs.addEventListener(SFS2X.SFSBuddyEvent.BUDDY_ERROR, onBuddyError, this);

	// Add Jack as a new buddy to my buddies list
	sfs.send(new SFS2X.AddBuddyRequest("Jack"));
}

function onBuddyAdded(evtParams)
{
	console.log("This buddy was added: " + evtParams.buddy.name);
}

function onBuddyError(evtParams)
{
	console.log("The following error occurred while executing a buddy-related request: " + evtParams.errorMessage);
}

This example handles the possible events caused by a request to block a buddy.

function someMethod()
{
	sfs.addEventListener(SFS2X.SFSBuddyEvent.BUDDY_BLOCK, onBuddyBlock, this);
	sfs.addEventListener(SFS2X.SFSBuddyEvent.BUDDY_ERROR, onBuddyError, this);

	// Block user "Jack" in my buddies list
	smartFox.send(new SFS2X.BlockBuddyRequest("Jack", true));
}

function onBuddyBlock(evtParams)
{
	var isBlocked = evtParams.buddy.isBlocked;
	console.log("Buddy " + evtParams.buddy.name + " is now " + (isBlocked ? "blocked" : "unblocked"));
}

function onBuddyError(evtParams)
{
	console.log("The following error occurred while executing a buddy-related request: " + evtParams.errorMessage);
}

This example initializes the Buddy List system.

function someMethod()
{
	sfs.addEventListener(SFS2X.SFSBuddyEvent.BUDDY_LIST_INIT, onBuddyListInitialized, this);
	sfs.addEventListener(SFS2X.SFSBuddyEvent.BUDDY_ERROR, onBuddyError, this)

	// Initialize the Buddy List system
	sfs.send(new SFS2X.InitBuddyListRequest());
}

function onBuddyListInitialized(evtParams)
{
	console.log("Buddy List system initialized successfully");

	// Retrieve my buddies list
	var buddies = evtParams.buddyList;

	// Display the online buddies in a list component in the application interface
	...
}

function onBuddyError(evtParams)
{
	console.log("The following error occurred while executing a buddy-related request: " + evtParams.errorMessage);
}

This example sends a message to a buddy and handles the related event.

function someMethod()
{
	sfs.addEventListener(SFS2X.SFSBuddyEvent.BUDDY_MESSAGE, onBuddyMessage, this);

	// Get the recipient of the message, in this case my buddy Jack
	var buddy = sfs.buddyManager.getBuddyByName("Jack");

	// Send a message to Jack
	sfs.send(new SFS2X.BuddyMessageRequest("Hello Jack!", buddy));
}

function onBuddyMessage(evtParams)
{
	// As messages are forwarded to the sender too,
	// I have to check if I am the sender

	var isItMe = evtParams.isItMe;
	var sender = evtParams.buddy;

	if (isItMe)
		console.log("I said: " + evtParams.message);
	else
		console.log("My buddy " + sender.name + " said: " + evtParams.message);
}

This example changes the online state of the user in the Buddy List system.

function someMethod()
{
	sfs.addEventListener(SFS2X.SFSBuddyEvent.BUDDY_ONLINE_STATE_CHANGE, onBuddyOnlineStateChanged, this);

	// Put myself offline in the Buddy List system
	sfs.send(new SFS2X.GoOnlineRequest(false));
}

function onBuddyOnlineStateChanged(evtParams)
{
	// As the state change event is dispatched to me too,
	// I have to check if I am the one who changed his state

	var isItMe = evtParams.isItMe;

	if (isItMe)
		console.log("I'm now " + (sfs.buddyManager.getMyOnlineState() ? "online" : "offline"));
	else
		console.log("My buddy " + evtParams.buddy.name + " is now " + (evtParams.buddy.isOnline ? "online" : "offline"));
}

This example sends a request to remove a buddy.

function someMethod()
{
	sfs.addEventListener(SFS2X.SFSBuddyEvent.BUDDY_REMOVE, onBuddyRemoved, this);
	sfs.addEventListener(SFS2X.SFSBuddyEvent.BUDDY_ERROR, onBuddyError, this);

	// Remove Jack from my buddies list
	sfs.send(new SFS2X.RemoveBuddyRequest("Jack"));
}

function onBuddyRemoved(evtParams)
{
	console.log("This buddy was removed: " + evtParams.buddy.name);
}

function onBuddyError(evtParams)
{
	console.log("The following error occurred while executing a buddy-related request: " + evtParams.errorMessage);
}

This example sets some Buddy Variables for the current user, one of which is persistent and another one is the reserved variable used to set the nickname; the example also handles changes made by the user or by his buddies.

function someMethod()
{
	sfs.addEventListener(SFS2X.SFSBuddyEvent.BUDDY_VARIABLES_UPDATE, onBuddyVarsUpdate, this);

	// Create two Buddy Variables containing the title and artist of the song I'm listening to
	var songTitle = new SFS2X.SFSBuddyVariable("songTitle", "Ascension");
	var songAuthor = new SFS2X.SFSBuddyVariable("songAuthor", "Mike Oldfield");

	// Create a persistent Buddy Variable containing my mood message
	var mood = new SFS2X.SFSBuddyVariable(SFS2X.SFSBuddyVariable.OFFLINE_PREFIX + "mood", "SFS2X rocks!");

	// Set my nickname
	var nick = new SFS2X.SFSBuddyVariable(SFS2X.ReservedBuddyVariables.BV_NICKNAME, "Bax");

	// Set my Buddy Variables
	var vars = [songTitle, songAuthor, mood, nick];
	sfs.send(new SFS2X.SetBuddyVariablesRequest(vars));
}

function onBuddyVarsUpdate(evtParams)
{
	// As the update event is dispatched to me too,
	// I have to check if I am the one who changed his Buddy Variables

	var isItMe = evtParams.isItMe;

	if (isItMe)
	{
		console.log("I've updated the following Buddy Variables:");

		for (var i = 0; i < evtParams.changedVars.length; i++)
		{
			var bVarName = evtParams.changedVars[i];
			console.log(bVarName + " -->; " + sfs.buddyManager.getMyVariable(bVarName).value);
		}
	}
	else
	{
		var buddyName = evtParams.buddy.name;

		console.log("My buddy " + buddyName + " updated the following Buddy Variables:");

		for (var i = 0; i < evtParams.changedVars.length; i++)
		{
			var bVarName = evtParams.changedVars[i];
			console.log(bVarName + " --> " + sfs.buddyManager.getBuddyByName(buddyName).getVariable(bVarName).value);
		}
	}
}