My program doesn't have bugs. It just develops random features.

UE3:UIDataStore_OnlineStats (UDK)

From Unreal Wiki, The Unreal Engine Documentation Site
Revision as of 05:50, 17 January 2010 by Wormbo (Talk | contribs) (1 revision: class descriptions for UDK January update (part 6))

(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to: navigation, search
UDK Object >> UIRoot >> UIDataProvider >> UIDataStore >> UIDataStore_Remote >> UIDataStore_OnlineStats
Package: 
Engine
Implemented interfaces
UIListElementCellProvider, UIListElementProvider
Direct subclass:
UTDataStore_OnlineStats
This class in other games:
UT3

This class is responsible for mapping properties in an OnlineStatsRead class to the UI. It maintains a set of different read objects that are switched between at run time. This allows you to show leaderboards by age (one week, month, year, etc.) from the same UI by having this data store just use different query objects

NOTE: Each game needs to derive at least one class from this one in order to expose the game's specific stats class(es)

Properties

CurrentReadType

Type: EStatsFetchType

The current type to read

PlayerInterface

Type: OnlinePlayerInterface

The player interface to use for performing player specific functions

PlayerNickData

Type: PlayerNickMetaData

Modifiers: const


Default value:

Member Value
PlayerNickColumnName "Player Nick"
PlayerNickName 'Player Nick'

RankNameMetaData

Type: RankMetaData

Modifiers: const

Cached FName for faster compares

Default value:

Member Value
RankColumnName "Rank"
RankName 'Rank'

StatsInterface

Type: OnlineStatsInterface

The stats interface to use for reading stats data

StatsRead

Type: OnlineStatsRead

The OnlineStatsRead object that will be exposed to the UI. One of the objects from the array above. The game specific version of this class needs to change the current setting based on its rules

StatsReadClasses

Type: array<class<OnlineStatsRead> >

The OnlineStatsRead derived classes to load and populate the UI with

StatsReadName

Type: name

Modifiers: const

Cached FName for faster compares

Default value: 'StatsReadResults'

StatsReadObjects

Type: array<OnlineStatsRead>

The set of stats read objects that will be used for display purposes

TotalRowsName

Type: name

Modifiers: const

Cached FName for faster compares

Default value: 'TotalRows'

Default values

Property Value
Tag 'OnlineStats'

Enums

EStatsFetchType

The types of stats to fetch

SFT_Player 
The player's stats
SFT_CenteredOnPlayer 
The player and people above/below them
SFT_Friends 
The player's frinds list and them
SFT_TopRankings 
The top n ranked players

Structs

PlayerNickMetaData

Modifiers: native

name PlayerNickName 
Cached FName for faster compares
string PlayerNickColumnName 
The name displayed in column headings in the UI

RankMetaData

Modifiers: native

name RankName 
Cached FName for faster compares
string RankColumnName 
The name displayed in column headings in the UI

Functions

Native functions

SortResultsByRank

native function SortResultsByRank ()

Sorts the returned results by their rank (lowest to highest)

Events

Init

event Init ()

Grabs the interface pointers and sets the read delegate

RefreshStats

event bool RefreshStats (byte ControllerIndex)

Tells the online subsystem to re-read the stats data using the current read mode and the current object to add the results to

ShowGamercard

event bool ShowGamercard (byte ConrollerIndex, int ListIndex)

Displays the gamercard for the specified list index

Parameters:

  • ConrollerIndex - the ControllerId for the player displaying the gamercard
  • ListIndex - the item in the list to display the gamercard for

Other instance functions

OnReadComplete

function OnReadComplete (bool bWasSuccessful)

Called by the online subsystem when the stats read has completed

Parameters:

  • bWasSuccessful - whether the stats read was successful or not

SetStatsReadInfo

function SetStatsReadInfo ()

This function should be overloaded with a game specific version. It is used to determine which search class to use and in which mode