Skip to content
RallyHere Docs
GitHub

Config

Config

Summary

MembersDescriptions
class URH_ConfigSubsystemConfig Subsystem used for interfacing with configuration coming from the core servers.
struct FRH_ServerTimeCacheAn object that caches information about server time and differences.

class URH_ConfigSubsystem

class URH_ConfigSubsystem
  : public URH_GameInstanceSubsystemPlugin

Config Subsystem used for interfacing with configuration coming from the core servers.

Summary

MembersDescriptions
public FAppSettingsUpdatedDelegate AppSettingsUpdatedDelegateDelegate that can be listented to for whenever App Settings get updated from polling.
public FSettingsUpdatedDelegate OnSettingsUpdatedDelegate that can be listented to for whenever Settings get updated from polling.
public FSettingsUpdatedDynamicDelegate BLUEPRINT_OnSettingsUpdatedDelegate that can be listented to for whenever Settings get updated from polling.
public virtual void Initialize()Initialize the subsystem.
public virtual void Deinitialize()Safely tears down the subsystem.
public void FetchAppSettings(const FRH_GenericSuccessWithErrorBlock & Delegate)Requests the server for the latest App Settings.
public inline FORCEINLINE void FetchAppSettings(const FRH_GenericSuccessDelegate & Delegate)
public void PollAppSettings(const FRH_PollCompleteFunc & Delegate)Pulses a FetchAppSettings call for the polling of App Settings.
public inline const TMap< FString, FString > & GetAppSettings() constGets the map of all the App Settings and their values.
public inline bool GetAppSetting(const FString & Key,FString & Value) constGets the value of a specific App Setting.
public void TriggerHotfixProcessing()If hotfix settings are set, this starts the process of applying them to unreal assets.
public void StartAppSettingsRefreshTimer()Starts the polling for App Settings.
public void StopAppSettingsRefreshTimer()Stops the polling for App Settings.
public void RefreshServerTimeCache(FRH_GenericSuccessWithErrorBlock Delegate)Requests the server time cache to be updated.
public inline FORCEINLINE void RefreshServerTimeCache(FRH_GenericSuccessBlock Delegate)
public inline void BLUEPRINT_RefreshServerTimeCache(const FRH_GenericSuccessWithErrorDynamicDelegate & Delegate)
public inline const FRH_ServerTimeCache&GetServerTimeCache() constGets the server time cache object.
public inline bool GetServerTime(FDateTime & Time) constGets the approximate server time, if we have received one.
public inline bool GetServerTimeDrift(FTimespan & Timespan) constGets the approximate server time, if we have received one.
public inline bool GetHotfixTestValue() constGets if the hotfix system is enabled.
protected TMap< FString, FString > AppSettingsMap of app settings by name.
protected FString AppSettingsETagETag of last Get App Settings call response.
protected FRH_AutoPollerPtr AppSettingsPollerPoller responsible for App Settings.
protected bool bAutomaticallyPollConfigurationDataIf set, automatically start the poller for App Settings.
protected bool bAutomaticallyApplyHotfixDataIf set, automatically use hotfix data in App Settings to modify local data.
protected bool bHotfixTestValuedebug value to test if the hotfix system is working properly.
protected FRH_ServerTimeCache ServerTimeCacheCache data for storing time information from the API.
protected virtual void InitPropertiesWithDefaultValues()Initializes the subsystem with defaults for its cached data.
protected virtual void OnFetchAppSettings(const RallyHereAPI::FResponse_GetAppSettingsClient & Resp)Handles the response to a Fetch App Settings call.

Members

public FAppSettingsUpdatedDelegate AppSettingsUpdatedDelegate

Delegate that can be listented to for whenever App Settings get updated from polling.


#### `public FSettingsUpdatedDelegate `[`OnSettingsUpdated`](#classURH__ConfigSubsystem_1ae1e142e7cd1617f8c6dfea4025da1f51)

Delegate that can be listented to for whenever Settings get updated from polling.


#### `public FSettingsUpdatedDynamicDelegate `[`BLUEPRINT_OnSettingsUpdated`](#classURH__ConfigSubsystem_1a6cd9170e3b5adf90d10225eeaeeab310)

Delegate that can be listented to for whenever Settings get updated from polling.


#### `public virtual void `[`Initialize`](#classURH__ConfigSubsystem_1a5b2aa7a3ec7d38edff89acd5419dea8f)`()`

Initialize the subsystem.


#### `public virtual void `[`Deinitialize`](#classURH__ConfigSubsystem_1a3772586395855d20b68419525357d482)`()`

Safely tears down the subsystem.


#### `public void `[`FetchAppSettings`](#classURH__ConfigSubsystem_1ad403c4ca8a27ea7c655e90a284dc78d5)`(const FRH_GenericSuccessWithErrorBlock & Delegate)`

Requests the server for the latest App Settings.

Parameters

  • Delegate Delegate to call when the request is complete.

#### `public inline FORCEINLINE void `[`FetchAppSettings`](#classURH__ConfigSubsystem_1a50fe9c7e6cff1c087b90a9a260589d42)`(const FRH_GenericSuccessDelegate & Delegate)`
#### `public void `[`PollAppSettings`](#classURH__ConfigSubsystem_1af54aaef08b3ea1cde7002a1d9c799f5e)`(const FRH_PollCompleteFunc & Delegate)`

Pulses a FetchAppSettings call for the polling of App Settings.

Parameters

  • Delegate Delegate to call when the request is complete.

#### `public inline const TMap< FString, FString > & `[`GetAppSettings`](#classURH__ConfigSubsystem_1a5dc66896184c8dfb91dd2be05adbf885)`() const`

Gets the map of all the App Settings and their values.

Returns

Map of all the App Settings and their values


#### `public inline bool `[`GetAppSetting`](#classURH__ConfigSubsystem_1aa720f15382278f6dc7843fd813f7c055)`(const FString & Key,FString & Value) const`

Gets the value of a specific App Setting.

Parameters

  • Key Key of the App Setting to get the value of.

  • Value Value of the App Setting.

Returns

if true, a Value was found for the Key.


#### `public void `[`TriggerHotfixProcessing`](#classURH__ConfigSubsystem_1a524f29aaf89857bd7bbb75ee8a4a47a6)`()`

If hotfix settings are set, this starts the process of applying them to unreal assets.


#### `public void `[`StartAppSettingsRefreshTimer`](#classURH__ConfigSubsystem_1ac4025b9a4e7668d077902c15884f1f84)`()`

Starts the polling for App Settings.


#### `public void `[`StopAppSettingsRefreshTimer`](#classURH__ConfigSubsystem_1a4d102b2b260b8931994a758fc0ea1854)`()`

Stops the polling for App Settings.


#### `public void `[`RefreshServerTimeCache`](#classURH__ConfigSubsystem_1ad4d64fbcf9c3bbd0dc8452d4e38f6a12)`(FRH_GenericSuccessWithErrorBlock Delegate)`

Requests the server time cache to be updated.


#### `public inline FORCEINLINE void `[`RefreshServerTimeCache`](#classURH__ConfigSubsystem_1a337367e2a0b271b9a7629e776fd8cde6)`(FRH_GenericSuccessBlock Delegate)`
#### `public inline void `[`BLUEPRINT_RefreshServerTimeCache`](#classURH__ConfigSubsystem_1a5c4610a7f6baf7d8b3d6b385b8318232)`(const FRH_GenericSuccessWithErrorDynamicDelegate & Delegate)`
#### `public inline const `[`FRH_ServerTimeCache`](Config.md#structFRH__ServerTimeCache)` & `[`GetServerTimeCache`](#classURH__ConfigSubsystem_1a15bf58f4b62f9d9f638c2ceae633c474)`() const`

Gets the server time cache object.


#### `public inline bool `[`GetServerTime`](#classURH__ConfigSubsystem_1a946dd5b6f7306f98540241a22a02bb4a)`(FDateTime & Time) const`

Gets the approximate server time, if we have received one.

Parameters

  • Time The approximate server time.

Returns

True if we have received a server time, false otherwise.


#### `public inline bool `[`GetServerTimeDrift`](#classURH__ConfigSubsystem_1a8c858f002ca9de0d0c656e2dad1d08a8)`(FTimespan & Timespan) const`

Gets the approximate server time, if we have received one.

Parameters

  • Timespan The approximate server time drift

Returns

True if we have received a server time, false otherwise.


#### `public inline bool `[`GetHotfixTestValue`](#classURH__ConfigSubsystem_1a36219ba1c46c10df675d0fe546fc31b4)`() const`

Gets if the hotfix system is enabled.

Returns

Gets if enabled.


#### `protected TMap< FString, FString > `[`AppSettings`](#classURH__ConfigSubsystem_1acbb61ccb593c2ab63b88e724af77ac7b)

Map of app settings by name.


#### `protected FString `[`AppSettingsETag`](#classURH__ConfigSubsystem_1a8d386d5683aedd0d45ac56239f45eadd)

ETag of last Get App Settings call response.


#### `protected FRH_AutoPollerPtr `[`AppSettingsPoller`](#classURH__ConfigSubsystem_1a3fa83db7018f68e8cb4f22733629df09)

Poller responsible for App Settings.


#### `protected bool `[`bAutomaticallyPollConfigurationData`](#classURH__ConfigSubsystem_1aa0a4994a1e4728341c2c9d99cb23bf9f)

If set, automatically start the poller for App Settings.


#### `protected bool `[`bAutomaticallyApplyHotfixData`](#classURH__ConfigSubsystem_1ae6a1ea4e7a62149e8742979bcc8ad4e8)

If set, automatically use hotfix data in App Settings to modify local data.


#### `protected bool `[`bHotfixTestValue`](#classURH__ConfigSubsystem_1ad8f7a9544bd7e02d623c6706b26309d9)

debug value to test if the hotfix system is working properly.


#### `protected `[`FRH_ServerTimeCache`](Config.md#structFRH__ServerTimeCache)` `[`ServerTimeCache`](#classURH__ConfigSubsystem_1a89412dc101f8e23d7715719f46ac079a)

Cache data for storing time information from the API.


#### `protected virtual void `[`InitPropertiesWithDefaultValues`](#classURH__ConfigSubsystem_1ad979b4e471d7be71b35798bd79547e7b)`()`

Initializes the subsystem with defaults for its cached data.


#### `protected virtual void `[`OnFetchAppSettings`](#classURH__ConfigSubsystem_1abdfe9bdb927724998ee14a9ca74fef80)`(const RallyHereAPI::FResponse_GetAppSettingsClient & Resp)`

Handles the response to a Fetch App Settings call.

Parameters

  • Resp Response given for the call

  • Delegate Delegate passed in for original call to respond to when call completes.


## struct `FRH_ServerTimeCache`

An object that caches information about server time and differences.

Summary

MembersDescriptions
public FDateTime LastReceivedServerDateTimeThe timestamp received during the most recent update from the server.
public FDateTime LastReceivedServerAtTimeThe time we received the most recent update from the server.
public inline FRH_ServerTimeCache()Constructor.
public inline FDateTime GetLocalTime() constGets the current local time.
public inline bool GetServerTime(FDateTime & Time) constGets the approximate server time, if we have received one.
public inline bool GetServerTimeDrift(FTimespan & Timespan) constGets the approximate server time, if we have received one.
public inline void ImportAPITime(const RallyHereAPI::FResponse_GetUtcTime & Time)Imports data from the server response.

Members

public FDateTime LastReceivedServerDateTime

The timestamp received during the most recent update from the server.


#### `public FDateTime `[`LastReceivedServerAtTime`](#structFRH__ServerTimeCache_1af3fc128d16c059cb4420ca5841a91d20)

The time we received the most recent update from the server.


#### `public inline `[`FRH_ServerTimeCache`](#structFRH__ServerTimeCache_1a4b895cff8968b4e82df5e794376b8168)`()`

Constructor.


#### `public inline FDateTime `[`GetLocalTime`](#structFRH__ServerTimeCache_1a9c40461ffd5001e460d8e897bb45f68a)`() const`

Gets the current local time.


#### `public inline bool `[`GetServerTime`](#structFRH__ServerTimeCache_1aaa54f6ae4bddd94bc4665ae40f69dae6)`(FDateTime & Time) const`

Gets the approximate server time, if we have received one.

Parameters

  • Time The approximate server time.

Returns

True if we have received a server time, false otherwise.


#### `public inline bool `[`GetServerTimeDrift`](#structFRH__ServerTimeCache_1a777a359d346cb75f394b622844fa6f68)`(FTimespan & Timespan) const`

Gets the approximate server time, if we have received one.

Parameters

  • Timespan The approximate server time drift

Returns

True if we have received a server time, false otherwise.


#### `public inline void `[`ImportAPITime`](#structFRH__ServerTimeCache_1a5b805808b827d56da61fe16ecd38cf20)`(const RallyHereAPI::FResponse_GetUtcTime & Time)`

Imports data from the server response.

Parameters

  • Time the time data to import