Home Page - World of Warcraft Programming: A Guide and Reference for Creating WoW Addons

Returns information about a particular online toon tied to a RealID friend

Signature:

hasFocus, toonName, client, realmName, realmId, faction, race, class, unknown, zoneName, level, gameText, broadcastText, broadcastTime = BNGetFriendToonInfo(friendIndex, toonIndex)

Arguments:

friendIndex - Index (between 1 and BNGetNumFriends()) (number)
toonIndex - Index (between 1 and BNGetNumFriendToons(friendIndex)) (number)

Returns:

hasFocus - Whether or not this toon is the one currently being displayed in Blizzard's FriendFrame. (boolean)
toonName - The toon's name (string)
client - The name of the game the friend is currently playing, if any; Returns initialism for World of Warcraft ('WoW') (string)
realmName - The toon's realm name (string)
realmId - The toon's realm ID (number)
faction - The toon's faction. Returns -1 for offline, 0 for Horde, 1 for Alliance (number)
race - The toon's race (string)
class - The toon's class (string)
unknown - (string)
zoneName - The toon's zone (location) (string)
level - The toon's character level (string)
gameText - The zone and server of the active toon separated by a hyphen (string)
broadcastText - The user's RealID broadcast message (string)
broadcastTime - The time the broadcast message was first set (string)