GoOnlineRequest

new GoOnlineRequest(online)

Creates a new GoOnlineRequest instance. The instance must be passed to the SmartFox.send() method for the request to be executed.

All clients who have the current user as buddy in their buddy list will receive the buddyOnlineStateChange event and see the SFSBuddy.isOnline property return its value accordingly. The same event is also dispatched to the current user, who sent the request, so that the application interface can be updated accordingly. Going online/offline as buddy doesn't affect the user connection, the currently joined Zone and Rooms, etc.

The online state of a user in a buddy list is handled by means of a reserved and persistent Buddy Variable.

NOTE: this request can be sent if the Buddy List system was previously initialized only (see the InitBuddyListRequest request description).

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"));
}

See also

SmartFox#send

SFSBuddyManager#getMyOnlineState

SFSBuddy#isOnline

SFSBuddyEvent.BUDDY_ONLINE_STATE_CHANGE