Mostly Harmless

UE3:OnlineSubsystem (UT3)

From Unreal Wiki, The Unreal Engine Documentation Site
Jump to: navigation, search
UT3 Object >> OnlineSubsystem
Package: 
Engine
Direct subclass:
OnlineSubsystemCommonImpl
This class in other games:
UDK

This class holds a set of online interfaces that game code uses to talk with the platform layer's services. The set of services are implemented as interface pointers so that we can mix & match services at run time. This also allows licensees the ability to use part of our base services and provide custom implmentations of others.

Properties

AccountInterface

Type: OnlineAccountInterface

The interface to use for creating and/or enumerating account information

ContentInterface

Type: OnlineContentInterface

The interface to use for online content

GameInterface

Type: OnlineGameInterface

The interface to use for creating, searching for, or destroying online games

NewsInterface

Type: OnlineNewsInterface

The interface to use for reading game specific news announcements

PlayerInterface

Type: OnlinePlayerInterface

The interface for accessing online player methods

PlayerInterfaceEx

Type: OnlinePlayerInterfaceEx

The interface for accessing online player extension methods

StatsInterface

Type: OnlineStatsInterface

The interface to use for stats read/write operations

SystemInterface

Type: OnlineSystemInterface

The interface for accessing system wide network functions

VoiceInterface

Type: OnlineVoiceInterface

The interface to use for voice communication

Enums

See OnlineSubsystem enums.

Structs

FriendsQuery

Modifiers: native

Used to bulk query the friends list

UniqueNetId UniqueId 
The unique player id to check friends status for
bool bIsFriend 
Out param indicating whether the player is a friend or not

LocalTalker

Modifiers: native

Information about a local talker

bool bHasVoice 
Whether this talker is currently registered
bool bHasNetworkedVoice 
Whether the talker should send network data
bool bIsRecognizingSpeech 
Whether the player is trying to speak voice commands
bool bWasTalking 
Whether the local talker was speaking last frame

OnlineArbitrationRegistrant

Modifiers: native

Struct holding the information about a single arbitration registrant

Object.qword MachineId 
Unique id of the machine involved in the arbitrated session
UniqueNetId PlayerId 
Unique id of the player involved in the arbitrated session
int Trustworthiness 
Trust level of the machine/player for the arbitrated session

OnlineContent

Modifiers: native

Holds information about a single piece of downloaded content

int UserIndex 
Optional user index that content is downloaded for (-1 means it's not associated with any user)
string FriendlyName 
Displayable name of the content
string ContentPath 
File system usable reference to the content
array<string> ContentPackages 
List of packages in the content
array<string> ContentFiles 
List of all non-package files in the content

OnlineFriend

Modifiers: native

Holds information about a player in a friends list

UniqueNetId UniqueId 
Unique identifier of the friend
string NickName 
Player's nick as published to the online service
string PresenceInfo 
String holding information about the player's game state (cap-ed flag, etc.)
bool bIsOnline 
Whether the friend is online or not
bool bIsPlaying 
Whether the friend is playing a game or not
bool bIsPlayingThisGame 
Whether the friend is playing the same game or not
bool bIsJoinable 
Whether the game the friend is in is joinable or not
bool bHasVoiceSupport 
Whether the friend can chat via voice or not

OnlineFriendMessage

Modifiers: native

Holds the data used in a friend message

UniqueNetId SendingPlayerId 
The player that is sending the message
string SendingPlayerNick 
The nick name of the player that sent the message
bool bIsFriendInvite 
Whether this is a friend invite or just a generic message
bool bIsGameInvite 
Whether this message is a game invite or not
bool bWasAccepted 
Whether the invite has been accepted or not
bool bWasDenied 
Whether the invite has been denied or not
string Message 
The corresponding message that was sent

OnlinePlayerScore

Modifiers: native

Struct holding information used when writing scoring information that is used to determine a player's skill rating

UniqueNetId PlayerId 
The player that this score is for
int TeamId 
The team that the player is on
int Score 
The score for this player

RemoteTalker

Modifiers: native

Information about a remote talker

UniqueNetId TalkerId 
The unique id for this talker
bool bWasTalking 
Whether the remote talker was speaking last frame

SpeechRecognizedWord

Holds a word/phrase that was recognized by the speech analyzer

Note: See VoiceInterface.h to change the native layout of this struct

int WordId 
The id of the word in the vocabulary
string WordText 
the actual word
float Confidence 
How confident the analyzer was in the recognition

UniqueNetId

Modifiers: native

Struct that holds a transient, unique identifier for a player

byte Uid[8]  
The id used by the network to uniquely identify a player

Functions

Static native functions

CanAutoLogin

native static final noexport function bool CanAutoLogin ()

Returns true if auto-login credentials are set on the commandline

StringToUniqueNetId

static final native noexport function bool StringToUniqueNetId (string UniqueNetIdString, out UniqueNetId out_UniqueId)

Converts a string representing a UniqueNetId into a UniqueNetId struct.

Parameters:

  • UniqueNetIdString - the string containing the text representation of the unique id.
  • out_UniqueId - will receive the UniqueNetId generated from the string.

Returns:

TRUE if the string was successfully converted into a UniqueNetId; FALSE if the string was not a valid UniqueNetId.

UniqueNetIdToString

static final native noexport function string UniqueNetIdToString (const out UniqueNetId IdToConvert)

Generates a string representation of a UniqueNetId struct.

Parameters:

  • IdToConvert - the unique net id that should be converted to a string.

Returns:

the specified UniqueNetId represented as a string.

Events

Init

event bool Init ()

Called from engine start up code to allow the subsystem to initialize

Returns:

TRUE if the initialization was successful, FALSE otherwise

SetAccountInterface

event bool SetAccountInterface (Object NewInterface)

Called from native code to assign the account interface

Parameters:

  • NewInterface - the object to assign as providing the account interface

Returns:

TRUE if the interface is valid, FALSE otherwise

SetContentInterface

event bool SetContentInterface (Object NewInterface)

Called from native code to assign the content interface

Parameters:

  • NewInterface - the object to assign as providing the content interface

Returns:

TRUE if the interface is valid, FALSE otherwise

SetGameInterface

event bool SetGameInterface (Object NewInterface)

Called from native code to assign the game interface

Parameters:

  • NewInterface - the object to assign as providing the game interface

Returns:

TRUE if the interface is valid, FALSE otherwise

SetNewsInterface

event bool SetNewsInterface (Object NewInterface)

Called from native code to assign the news interface

Parameters:

  • NewInterface - the object to assign as providing the news interface

Returns:

TRUE if the interface is valid, FALSE otherwise

SetPlayerInterface

event bool SetPlayerInterface (Object NewInterface)

Called from native code to assign the player interface

Parameters:

  • NewInterface - the object to assign as providing the player interface

Returns:

TRUE if the interface is valid, FALSE otherwise

SetPlayerInterfaceEx

event bool SetPlayerInterfaceEx (Object NewInterface)

Called from native code to assign the extended player interface

Parameters:

  • NewInterface - the object to assign as providing the player interface

Returns:

TRUE if the interface is valid, FALSE otherwise

SetStatsInterface

event bool SetStatsInterface (Object NewInterface)

Called from native code to assign the stats interface

Parameters:

  • NewInterface - the object to assign as providing the stats interface

Returns:

TRUE if the interface is valid, FALSE otherwise

SetSystemInterface

event bool SetSystemInterface (Object NewInterface)

Called from native code to assign the system interface

Parameters:

  • NewInterface - the object to assign as providing the system interface

Returns:

TRUE if the interface is valid, FALSE otherwise

SetVoiceInterface

event bool SetVoiceInterface (Object NewInterface)

Called from native code to assign the voice interface

Parameters:

  • NewInterface - the object to assign as providing the voice interface

Returns:

TRUE if the interface is valid, FALSE otherwise