API BNGetFriendInfoByID

Returns information about the specified RealID friend presenceID, accountName, battleTag, isBattleTagPresence, characterName, bnetIDGameAccount, client, isOnline, lastOnline, isAFK, isDND, messageText, noteText, isRIDFriend, messageTime, canSoR, isReferAFriend, canSummonFriend = BNGetFriendInfoByID(presenceID)

Arguments

 * presenceID: number - A unique numeric identifier for this friend's battle.net account for the current session

Returns

 * presenceID: Number - A unique numeric identifier for the friend's battle.net account during this session.
 * accountName : String - An escape sequence (starting with |K) representing the friend's full name or BattleTag name.
 * battleTag : String - A nickname and number that when combined, form a unique string that identifies the friend (e.g., "Nickname#0001").
 * isBattleTagPresence : Boolean - Whether or not the friend is known by their BattleTag.
 * characterName : String - The name of the logged in character.
 * bnetIDGameAccount : Number - A unique numeric identifier for the friend's game account during this session.
 * client : String - See below "Client list"
 * isOnline : Boolean - Whether or not the friend is online.
 * lastOnline : Number - The number of seconds elapsed since this friend was last online (from the epoch date of January 1, 1970). Returns nil if currently online.
 * isAFK : Boolean - Whether or not the friend is flagged as Away.
 * isDND : Boolean - Whether or not the friend is flagged as Busy.
 * messageText : String - The friend's Battle.Net broadcast message.
 * noteText : String - The contents of the player's note about this friend.
 * isRIDFriend : Boolean - Returns true for RealID friends and false for BattleTag friends.
 * messageTime : Number - The number of seconds elapsed since the current broadcast message was sent.
 * canSoR : Boolean - Whether or not this friend can receive a Scroll of Resurrection.
 * isReferAFriend : Boolean
 * canSummonFriend : Boolean

Details

 * The client names can be accessed via the globals BNET_CLIENT_WOW, BNET_CLIENT_SC2 and BNET_CLIENT_D3.
 * Even though the bnetIDAccount was passed as an argument, it's still the first item to be returned.