 |
Automated updating of API pages at this location, to reflect patch changes, has ceased from 10.1.7 onwards. |
Returns information about the specified RealID friend
presenceID, givenName, surname, toonName, toonID, client, isOnline, lastOnline, isAFK, isDND, broadcastText, noteText, isFriend, broadcastTime = BNGetFriendInfoByID(presenceID)
Arguments
- friendIndex
- number - The index on the friends list for this RealID friend
Returns
- presenceID, givenName, surname, toonName, toonID, client, isOnline, lastOnline, isAFK, isDND, broadcastText, noteText, isFriend, broadcastTime
- presenceID
- Number - a unique numeric identifier for this friend for this session
- givenName
- String - a |K Escape Sequence representing the friend's first/given name (As of 4.0)
- surname
- String - a |K Escape Sequence representing the friend's Surname/family name (As of 4.0)
- toonName
- String - the name of the friend's currently logged in character
- toonID
- Number - a unique numeric identifier for this friend's character for this session
- client
- String - Either "WoW" or "S2", for World of Warcraft or Starcraft2
- isOnline
- Boolean - true if the friend is online
- lastOnline
- Number - the number of seconds since this friend was last online since last Epoch, January 1, 1970, nil if currently online
- isAFK
- Boolean - true if the friend is flagged as Away
- isDND
- Boolean - true if the friend is flagged as Busy
- broadcastText
- String - the contents of the friend's broadcast message
- noteText
- String - the contents of the player's note about this friend
- isFriend
- Boolean - unknown
- broadcastTime
- Number - the number of seconds since the friend send the current broadcast
Details
The client names can be accessed via the globals BNET_CLIENT_WOW and BNET_CLIENT_SC2 Even though the presenceID was passed as an argument, it's still the first item to be returned