Overview Package Class Source Class tree Glossary
previous class      next class frames      no frames

Engine.OnlineSubsystem

Extends
Object
Modifiers
native abstract inherits ( FTickableObject )

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.

Core.Object
|   
+-- Engine.OnlineSubsystem

Direct Known Subclasses:

OnlineSubsystemCommonImpl

Constants Summary
Inherited Contants from Core.Object
DegToRad, INDEX_NONE, MaxInt, Pi, RadToDeg

Variables Summary
OnlineAccountInterfaceAccountInterface
OnlineContentInterfaceContentInterface
OnlineGameInterfaceGameInterface
OnlineNewsInterfaceNewsInterface
OnlinePlayerInterfacePlayerInterface
OnlinePlayerInterfaceExPlayerInterfaceEx
OnlineStatsInterfaceStatsInterface
OnlineSystemInterfaceSystemInterface
OnlineVoiceInterfaceVoiceInterface
Inherited Variables from Core.Object
Class, HashNext, HashOuterNext, Linker, LinkerIndex, Name, NetIndex, ObjectArchetype, ObjectFlags, ObjectInternalInteger, Outer, StateFrame, VfTableObject

Enumerations Summary
EFeaturePrivilegeLevel
FPL_Disabled, FPL_EnabledFriendsOnly, FPL_Enabled
ELanBeaconState
LANB_NotUsingLanBeacon, LANB_Hosting, LANB_Searching
ELoginStatus
LS_NotLoggedIn, LS_UsingLocalProfile, LS_LoggedIn
ENATType
NAT_Unknown, NAT_Open, NAT_Moderate, NAT_Strict
ENetworkNotificationPosition
NNP_TopLeft, NNP_TopCenter, NNP_TopRight, NNP_CenterLeft, NNP_Center, NNP_CenterRight, NNP_BottomLeft, NNP_BottomCenter, NNP_BottomRight
EOnlineAccountCreateStatus
OACS_CreateSuccessful, OACS_UnknownError, OACS_InvalidUserName, OACS_InvalidPassword, OACS_InvalidUniqueUserName, OACS_UniqueUserNameInUse, OACS_ServiceUnavailable
EOnlineEnumerationReadState
OERS_NotStarted, OERS_InProgress, OERS_Done, OERS_Failed
EOnlineGameState
OGS_NoSession, OGS_Pending, OGS_InProgress, OGS_Ending, OGS_Ended
EOnlineServerConnectionStatus
OSCS_NotConnected, OSCS_Connected, OSCS_ConnectionDropped, OSCS_NoNetworkConnection, OSCS_ServiceUnavailable, OSCS_UpdateRequired, OSCS_ServersTooBusy, OSCS_DuplicateLoginDetected, OSCS_InvalidUser
Inherited Enumerations from Core.Object
EAxis, EInputEvent, EInterpCurveMode, EInterpMethodType, ETickingGroup

Structures Summary
FriendsQuery
UniqueId, bIsFriend
LocalTalker
bHasVoice, bHasNetworkedVoice, bIsRecognizingSpeech, bWasTalking
OnlineArbitrationRegistrant
MachineId, PlayerId, Trustworthiness
OnlineContent
UserIndex, FriendlyName, ContentPath, ContentPackages, ContentFiles
OnlineFriend
UniqueId, NickName, PresenceInfo, bIsOnline, bIsPlaying, bIsPlayingThisGame, bIsJoinable, bHasVoiceSupport
OnlineFriendMessage
SendingPlayerId, SendingPlayerNick, bIsFriendInvite, bIsGameInvite, bWasAccepted, bWasDenied, Message
OnlinePlayerScore
PlayerId, TeamId, Score
RemoteTalker
TalkerId, bWasTalking
SpeechRecognizedWord
WordId, WordText, Confidence
UniqueNetId
Uid[8]
Inherited Structures from Core.Object
Box, BoxSphereBounds, Color, Cylinder, double, DynamicMap_Mirror, Guid, IndirectArray_Mirror, InterpCurveFloat, InterpCurvePointFloat, InterpCurvePointQuat, InterpCurvePointTwoVectors, InterpCurvePointVector, InterpCurvePointVector2D, InterpCurveQuat, InterpCurveTwoVectors, InterpCurveVector, InterpCurveVector2D, IntPoint, LinearColor, Map_Mirror, Matrix, MultiMap_Mirror, Plane, pointer, Quat, qword, RawDistribution, RenderCommandFence, Rotator, TextureMipBulkData_Mirror, ThreadSafeCounter, TPOV, TwoVectors, UntypedBulkData_Mirror, Vector, Vector2D, Vector4

Functions Summary
functionbool CanAutoLogin ()
eventbool Init ()
eventbool SetAccountInterface (Object NewInterface))
eventbool SetContentInterface (Object NewInterface))
eventbool SetGameInterface (Object NewInterface))
eventbool SetNewsInterface (Object NewInterface))
eventbool SetPlayerInterface (Object NewInterface))
eventbool SetPlayerInterfaceEx (Object NewInterface))
eventbool SetStatsInterface (Object NewInterface))
eventbool SetSystemInterface (Object NewInterface))
eventbool SetVoiceInterface (Object NewInterface))
functionbool StringToUniqueNetId (string UniqueNetIdString, out UniqueNetId out_UniqueId)
functionstring UniqueNetIdToString (const out UniqueNetId IdToConvert)
Inherited Functions from Core.Object
!, !=, $, $=, %, &, &&, *, **, *=, +, ++, +=, -, --, -=, / , /=, <, <<, <=, ==, >, >=, >>, >>>, @, @=, Abs, Acos, Asc, Asin, Atan, BeginState, ByteToFloat, Caps, Chr, Clamp, ClampLength, ClampRotAxis, ClassIsChildOf, ClearConfig, ClockwiseFrom, ColorToLinearColor, ContinuedState, Cos, Cross, Disable, Dot, DumpStateStack, DynamicLoadObject, Enable, EndState, Exp, FClamp, FCubicInterp, FindDeltaAngle, FindObject, FInterpEaseIn, FInterpEaseInOut, FInterpEaseOut, FInterpTo, FloatToByte, FMax, FMin, FPctByRange, FRand, GetAngularDegreesFromRadians, GetAngularDistance, GetAngularFromDotDist, GetAxes, GetDotDistance, GetEnum, GetFuncName, GetHeadingAngle, GetNetFuncName, GetPackageName, GetPerObjectConfigSections, GetRangePctByValue, GetRangeValueByPct, GetSpecialValue, GetStateName, GetUnAxes, GotoState, InStr, IsA, IsChildState, IsInState, IsNetScript, IsPendingKill, IsUTracing, IsZero, JoinArray, Left, Len, Lerp, Localize, Locs, Loge, LogInternal, MakeColor, MakeLinearColor, Max, Mid, Min, MirrorVectorByNormal, Normal, Normalize, NormalizeRotAxis, OrthoRotation, ParseStringIntoArray, PathName, PausedState, PointDistToLine, PointDistToPlane, PointInBox, PoppedState, PopState, ProjectOnTo, PushedState, PushState, QuatDot, QuatFindBetween, QuatFromAxisAndAngle, QuatFromRotator, QuatInvert, QuatProduct, QuatRotateVector, QuatSlerp, QuatToRotator, Rand, RandRange, RDiff, Repl, Right, RInterpTo, RLerp, RotRand, Round, RSize, RSmerp, SaveConfig, SClampRotAxis, ScriptTrace, SetSpecialValue, SetUTracing, Sin, Split, Sqrt, Square, StaticClearConfig, StaticSaveConfig, Tan, TimeStamp, ToHex, TransformVectorByRotation, UnwindHeading, vect2d, VInterpTo, VLerp, VRand, VSize, VSize2D, VSizeSq, VSizeSq2D, VSmerp, WarnInternal, ^, ^^, |, ||, ~, ~=


Variables Detail

AccountInterface Source code

var OnlineAccountInterface AccountInterface;
The interface to use for creating and/or enumerating account information

ContentInterface Source code

var OnlineContentInterface ContentInterface;
The interface to use for online content

GameInterface Source code

var OnlineGameInterface GameInterface;
The interface to use for creating, searching for, or destroying online games

NewsInterface Source code

var OnlineNewsInterface NewsInterface;
The interface to use for reading game specific news announcements

PlayerInterface Source code

var OnlinePlayerInterface PlayerInterface;
The interface for accessing online player methods

PlayerInterfaceEx Source code

var OnlinePlayerInterfaceEx PlayerInterfaceEx;
The interface for accessing online player extension methods

StatsInterface Source code

var OnlineStatsInterface StatsInterface;
The interface to use for stats read/write operations

SystemInterface Source code

var OnlineSystemInterface SystemInterface;
The interface for accessing system wide network functions

VoiceInterface Source code

var OnlineVoiceInterface VoiceInterface;
The interface to use for voice communication


Enumerations Detail

EFeaturePrivilegeLevel Source code

enum EFeaturePrivilegeLevel
{
FPL_Disabled, FPL_EnabledFriendsOnly, FPL_Enabled
};
This enum indicates access to major features in the game (parent controls

ELanBeaconState Source code

enum ELanBeaconState
{
LANB_NotUsingLanBeacon, LANB_Hosting, LANB_Searching
};
Indicates the state the LAN beacon is in

ELoginStatus Source code

enum ELoginStatus
{
LS_NotLoggedIn, LS_UsingLocalProfile, LS_LoggedIn
};
The different login statuses for a player

ENATType Source code

enum ENATType
{
NAT_Unknown, NAT_Open, NAT_Moderate, NAT_Strict
};
The various NAT types the player may have

ENetworkNotificationPosition Source code

enum ENetworkNotificationPosition
{
NNP_TopLeft, NNP_TopCenter, NNP_TopRight, NNP_CenterLeft, NNP_Center, NNP_CenterRight, NNP_BottomLeft, NNP_BottomCenter, NNP_BottomRight
};
Indicates where network notifications should appear on the screen

EOnlineAccountCreateStatus Source code

enum EOnlineAccountCreateStatus
{
OACS_CreateSuccessful, OACS_UnknownError, OACS_InvalidUserName, OACS_InvalidPassword, OACS_InvalidUniqueUserName, OACS_UniqueUserNameInUse, OACS_ServiceUnavailable
};
The series of status codes that the account creation method can return

EOnlineEnumerationReadState Source code

enum EOnlineEnumerationReadState
{
OERS_NotStarted, OERS_InProgress, OERS_Done, OERS_Failed
};
The state of an async enumeration (friends, content, etc) read request

EOnlineGameState Source code

enum EOnlineGameState
{
OGS_NoSession, OGS_Pending, OGS_InProgress, OGS_Ending, OGS_Ended
};
Enum indicating the current state of the online game (in progress, ended, etc.)

EOnlineServerConnectionStatus Source code

enum EOnlineServerConnectionStatus
{
OSCS_NotConnected, OSCS_Connected, OSCS_ConnectionDropped, OSCS_NoNetworkConnection, OSCS_ServiceUnavailable, OSCS_UpdateRequired, OSCS_ServersTooBusy, OSCS_DuplicateLoginDetected, OSCS_InvalidUser
};
Indicates the connection status with the remote online servers


Structures Detail

FriendsQuery Source code

struct FriendsQuery
{
var bool bIsFriend;
var UniqueNetId UniqueId;
};
Used to bulk query the friends list
bIsFriend:
Out param indicating whether the player is a friend or not
UniqueId:
The unique player id to check friends status for

LocalTalker Source code

struct LocalTalker
{
var bool bHasNetworkedVoice;
var bool bHasVoice;
var bool bIsRecognizingSpeech;
var bool bWasTalking;
};
Information about a local talker
bHasNetworkedVoice:
Whether the talker should send network data
bHasVoice:
Whether this talker is currently registered
bIsRecognizingSpeech:
Whether the player is trying to speak voice commands
bWasTalking:
Whether the local talker was speaking last frame

OnlineArbitrationRegistrant Source code

struct OnlineArbitrationRegistrant
{
var const qword MachineId;
var const UniqueNetId PlayerId;
var const int Trustworthiness;
};
Struct holding the information about a single arbitration registrant
MachineId:
Unique id of the machine involved in the arbitrated session
PlayerId:
Unique id of the player involved in the arbitrated session
Trustworthiness:
Trust level of the machine/player for the arbitrated session

OnlineContent Source code

struct OnlineContent
{
var array<string> ContentFiles;
var array<string> ContentPackages;
var string ContentPath;
var string FriendlyName;
var int UserIndex;
};
Holds information about a single piece of downloaded content
ContentFiles:
List of all non-package files in the content
ContentPackages:
List of packages in the content
ContentPath:
File system usable reference to the content
FriendlyName:
Displayable name of the content
UserIndex:
Optional user index that content is downloaded for (-1 means it's not associated with any user)

OnlineFriend Source code

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

OnlineFriendMessage Source code

struct OnlineFriendMessage
{
var bool bIsFriendInvite;
var bool bIsGameInvite;
var bool bWasAccepted;
var bool bWasDenied;
var string Message;
var UniqueNetId SendingPlayerId;
var string SendingPlayerNick;
};
Holds the data used in a friend message
bIsFriendInvite:
Whether this is a friend invite or just a generic message
bIsGameInvite:
Whether this message is a game invite or not
bWasAccepted:
Whether the invite has been accepted or not
bWasDenied:
Whether the invite has been denied or not
Message:
The corresponding message that was sent
SendingPlayerId:
The player that is sending the message
SendingPlayerNick:
The nick name of the player that sent the message

OnlinePlayerScore Source code

struct OnlinePlayerScore
{
var UniqueNetId PlayerId;
var int Score;
var int TeamId;
};
Struct holding information used when writing scoring information that is used to determine a player's skill rating
PlayerId:
The player that this score is for
Score:
The score for this player
TeamId:
The team that the player is on

RemoteTalker Source code

struct RemoteTalker
{
var bool bWasTalking;
var UniqueNetId TalkerId;
};
Information about a remote talker
bWasTalking:
Whether the remote talker was speaking last frame
TalkerId:
The unique id for this talker

SpeechRecognizedWord Source code

struct SpeechRecognizedWord
{
var float Confidence;
var int WordId;
var string WordText;
};
Holds a word/phrase that was recognized by the speech analyzer @note See VoiceInterface.h to change the native layout of this struct
Confidence:
How confident the analyzer was in the recognition
WordId:
The id of the word in the vocabulary
WordText:
the actual word

UniqueNetId Source code

struct UniqueNetId
{
var byte Uid[8];
};
Struct that holds a transient, unique identifier for a player
Uid[8]:
The id used by the network to uniquely identify a player


Functions Detail

CanAutoLogin Source code

native static final noexport function bool CanAutoLogin ( )
Returns true if auto-login credentials are set on the commandline

Init Source code

event bool Init ( )
Called from engine start up code to allow the subsystem to initialize
@return TRUE if the initialization was successful, FALSE otherwise

SetAccountInterface Source code

event bool SetAccountInterface ( Object NewInterface) )
Called from native code to assign the account interface
@param NewInterface the object to assign as providing the account interface
@return TRUE if the interface is valid, FALSE otherwise

SetContentInterface Source code

event bool SetContentInterface ( Object NewInterface) )
Called from native code to assign the content interface
@param NewInterface the object to assign as providing the content interface
@return TRUE if the interface is valid, FALSE otherwise

SetGameInterface Source code

event bool SetGameInterface ( Object NewInterface) )
Called from native code to assign the game interface
@param NewInterface the object to assign as providing the game interface
@return TRUE if the interface is valid, FALSE otherwise

SetNewsInterface Source code

event bool SetNewsInterface ( Object NewInterface) )
Called from native code to assign the news interface
@param NewInterface the object to assign as providing the news interface
@return TRUE if the interface is valid, FALSE otherwise

SetPlayerInterface Source code

event bool SetPlayerInterface ( Object NewInterface) )
Called from native code to assign the player interface
@param NewInterface the object to assign as providing the player interface
@return TRUE if the interface is valid, FALSE otherwise

SetPlayerInterfaceEx Source code

event bool SetPlayerInterfaceEx ( Object NewInterface) )
Called from native code to assign the extended player interface
@param NewInterface the object to assign as providing the player interface
@return TRUE if the interface is valid, FALSE otherwise

SetStatsInterface Source code

event bool SetStatsInterface ( Object NewInterface) )
Called from native code to assign the stats interface
@param NewInterface the object to assign as providing the stats interface
@return TRUE if the interface is valid, FALSE otherwise

SetSystemInterface Source code

event bool SetSystemInterface ( Object NewInterface) )
Called from native code to assign the system interface
@param NewInterface the object to assign as providing the system interface
@return TRUE if the interface is valid, FALSE otherwise

SetVoiceInterface Source code

event bool SetVoiceInterface ( Object NewInterface) )
Called from native code to assign the voice interface
@param NewInterface the object to assign as providing the voice interface
@return TRUE if the interface is valid, FALSE otherwise

StringToUniqueNetId Source code

static final native noexport function bool StringToUniqueNetId ( string UniqueNetIdString, out UniqueNetId out_UniqueId )
Converts a string representing a UniqueNetId into a UniqueNetId struct.
@param UniqueNetIdString the string containing the text representation of the unique id.
@param out_UniqueId will receive the UniqueNetId generated from the string.
@return TRUE if the string was successfully converted into a UniqueNetId; FALSE if the string was not a valid UniqueNetId.

UniqueNetIdToString Source code

static final native noexport function string UniqueNetIdToString ( const out UniqueNetId IdToConvert )
Generates a string representation of a UniqueNetId struct.
@param IdToConvert the unique net id that should be converted to a string.
@return the specified UniqueNetId represented as a string.


Defaultproperties

defaultproperties
{
   Name="Default__OnlineSubsystem"
   ObjectArchetype=Object'Core.Default__Object'
}

Overview Package Class Source Class tree Glossary
previous class      next class frames      no frames
Creation time: sk 18-3-2018 10:00:40.282 - Created with UnCodeX