UE3:OnlineGameSearch (UDK)

Object >> Settings >> OnlineGameSearch

Package: 

Engine

Direct subclass:

UTGameSearchCommon

This class in other games:

UT3

Holds the base settings for an online game search

Properties

AdditionalSearchCriteria

Type: string

String that is tacked onto the end of the search query (GameSpy only)

bIsLanQuery

Type: bool

Modifiers: databinding

Whether the query is intended for LAN matches or not

bIsSearchInProgress

Type: bool

Modifiers: const

Whether the search object in question is in progress or not. This is the union of the other flags

bUsesArbitration

Type: bool

Modifiers: databinding

Whether to use arbitration or not

FilterQuery

Type: OnlineGameSearchQuery

Modifiers: const

Holds the query to use when filtering servers and they require non-predefined queries

GameSettingsClass

Type: class<OnlineGameSettings>

The class to create for each returned result from the search

Default value: Class'Engine.OnlineGameSettings'

ManualSkillOverride

Type: OverrideSkill

Instance of the above to manually specify the players involved in the skill search

MaxSearchResults

Type: int

Max number of queries returned by the matchmaking service

Default value: 25

NamedProperties

Type: array<NamedObjectProperty>

The list of named properties to search on

PingBucketSize

Type: int

Used to sort games into buckets since a the difference in terms of feel for ping in the same bucket is often not a useful comparison and skill is better

Default value: 50

Query

Type: Settings.LocalizedStringSetting

The query to use for finding matching servers

Results

Type: array<OnlineGameSearchResult>

Modifiers: const

The list of servers and their settings that match the search

Enums

EOnlineGameSearchComparisonType

The type of comparison to perform on the search entry

OGSCT_Equals 

OGSCT_NotEquals 

OGSCT_GreaterThan 

OGSCT_GreaterThanEquals 

OGSCT_LessThan 

OGSCT_LessThanEquals 

EOnlineGameSearchEntryType

The type of data to use to fill out an online parameter

OGSET_Property 

A property is used to filter with

OGSET_LocalizedSetting 

A localized setting is used to filter with

OGSET_ObjectProperty 

A property on the game settings object to filter with

EOnlineGameSearchSortType

Used to indicate which way to sort a result set

OGSSO_Ascending 

OGSSO_Descending 

Structs

NamedObjectProperty

Modifiers: native

Used to search for named properties on game setting objects

name ObjectPropertyName 

The name of the property to search with

string ObjectPropertyValue 

The string value to compare against

OnlineGameSearchORClause

Modifiers: native

Matches parameters using a series of OR comparisons

array<OnlineGameSearchParameter> OrParams 

The list of parameters to compare and use as an OR clause

OnlineGameSearchParameter

Modifiers: native

Struct used to describe a search criteria

int EntryId 

The Id of the property or localized string

name ObjectPropertyName 

The name of the property to search with

EOnlineGameSearchEntryType EntryType 

Whether this parameter to compare against comes from a property or a localized setting

EOnlineGameSearchComparisonType ComparisonType 

The type of comparison to perform

OnlineGameSearchQuery

Modifiers: native

Struct used to describe a query

array<OnlineGameSearchORClause> OrClauses 

A set of OR clauses that are ANDed together to filter potential servers

array<OnlineGameSearchSortClause> SortClauses 

A list of sort operations used to order the servers that match the filtering

OnlineGameSearchResult

Modifiers: native

Struct used to return matching servers

OnlineGameSettings GameSettings 

The settings used by this particular server

pointer{void} PlatformData 

Platform/online provider specific data

NOTE: It is imperative that the subsystem be called to clean this data up or the PlatformData will leak memory!

OnlineGameSearchSortClause

Modifiers: native

Struct used to describe the sorting of items

int EntryId 

The Id of the property or localized string

name ObjectPropertyName 

The name of the property to search with

EOnlineGameSearchEntryType EntryType 

Whether this parameter to compare against comes from a property or a localized setting

EOnlineGameSearchSortType SortType 

The type of comparison to perform

OverrideSkill

Modifiers: native

Used to manually specify the skill to use when matchmaking

int LeaderboardId 

The skill leaderboard to read the player skill from

array<OnlineSubsystem.UniqueNetId> Players 

The set of players to read the skill for

array<Object.double> Mus 

The set of skill values to use

array<Object.double> Sigmas 

Functions

Native functions

SortSearchResults

native event SortSearchResults ()

Allows a search object to provide a customized sort routine to order the results in a way that best fits the game type

Other instance functions

SetSkillOverride

function SetSkillOverride (int LeaderboardId, const out array<OnlineSubsystem.UniqueNetId> Players)

Sets the information needed to do a manual specification of the skill to use when searching

Parameters:

• LeaderboardId - the skill leaderboard to read from
• Players - the set of players to use when determining the skill