C# Класс Steamworks.SteamUtils

Показать файл Открыть проект Примеры использования класса

Открытые методы

Метод Описание
BOverlayNeedsPresent ( ) : bool

Normally this call is unneeded if your game has a constantly running frame loop that calls the

D3D Present API, or OGL SwapBuffers API every frame.

However, if you have a game that only refreshes the screen on an event driven basis then that can break

the overlay, as it uses your Present/SwapBuffers calls to drive it's internal frame loop and it may also

need to Present() to the screen any time an even needing a notification happens or when the overlay is

brought up over the game by a user. You can use this API to ask the overlay if it currently need a present

in that case, and then you can check for this periodically (roughly 33hz is desirable) and make sure you

refresh the screen with Present or SwapBuffers to allow the overlay to do it's work.

CheckFileSignature ( string szFileName ) : SteamAPICall_t

Asynchronous call to check if an executable file has been signed using the public key set on the signing tab

of the partner site, for example to refuse to load modified executable files.

The result is returned in CheckFileSignature_t.

k_ECheckFileSignatureNoSignaturesFoundForThisApp - This app has not been configured on the signing tab of the partner site to enable this function.

k_ECheckFileSignatureNoSignaturesFoundForThisFile - This file is not listed on the signing tab for the partner site.

k_ECheckFileSignatureFileNotFound - The file does not exist on disk.

k_ECheckFileSignatureInvalidSignature - The file exists, and the signing tab has been set for this file, but the file is either not signed or the signature does not match.

k_ECheckFileSignatureValidSignature - The file is signed and the signature is valid.

GetAPICallFailureReason ( SteamAPICall_t hSteamAPICall ) : ESteamAPICallFailure
GetAPICallResult ( SteamAPICall_t hSteamAPICall, IntPtr pCallback, int cubCallback, int iCallbackExpected, bool &pbFailed ) : bool
GetAppID ( ) : AppId_t

returns the appID of the current process

GetCSERIPPort ( uint &unIP, ushort &usPort ) : bool

returns the IP of the reporting server for valve - currently only used in Source engine games

GetConnectedUniverse ( ) : EUniverse

the universe this client is connecting to

GetCurrentBatteryPower ( ) : byte

return the amount of battery power left in the current system in % [0..100], 255 for being on AC power

GetEnteredGamepadTextInput ( string &pchText, uint cchText ) : bool
GetEnteredGamepadTextLength ( ) : uint

Returns previously entered text & length

GetIPCCallCount ( ) : uint

returns the number of IPC calls made since the last time this function was called

Used for perf debugging so you can understand how many IPC calls your game makes per frame

Every IPC call is at minimum a thread context switch if not a process one so you want to rate

control how often you do them.

GetIPCountry ( ) : string

returns the 2 digit ISO 3166-1-alpha-2 format country code this client is running in (as looked up via an IP-to-location database)

e.g "US" or "UK".

GetImageRGBA ( int iImage, byte pubDest, int nDestBufferSize ) : bool

returns true if the image exists, and the buffer was successfully filled out

results are returned in RGBA format

the destination buffer size should be 4 * height * width * sizeof(char)

GetImageSize ( int iImage, uint &pnWidth, uint &pnHeight ) : bool

returns true if the image exists, and valid sizes were filled out

GetSecondsSinceAppActive ( ) : uint

return the number of seconds since the user

GetSecondsSinceComputerActive ( ) : uint
GetServerRealTime ( ) : uint

Steam server time. Number of seconds since January 1, 1970, GMT (i.e unix time)

GetSteamUILanguage ( ) : string

returns the language the steam client is running in, you probably want ISteamApps::GetCurrentGameLanguage instead, this is for very special usage cases

IsAPICallCompleted ( SteamAPICall_t hSteamAPICall, bool &pbFailed ) : bool

API asynchronous call results

can be used directly, but more commonly used via the callback dispatch API (see steam_api.h)

IsOverlayEnabled ( ) : bool

Returns true if the overlay is running & the user can access it. The overlay process could take a few seconds to

start & hook the game process, so this function will initially return false while the overlay is loading.

IsSteamInBigPictureMode ( ) : bool

returns true if Steam & the Steam Overlay are running in Big Picture mode

Games much be launched through the Steam client to enable the Big Picture overlay. During development,

a game can be added as a non-steam game to the developers library to test this feature

IsSteamRunningInVR ( ) : bool

returns true if Steam itself is running in VR mode

SetOverlayNotificationInset ( int nHorizontalInset, int nVerticalInset ) : void

Sets the inset of the overlay notification from the corner specified by SetOverlayNotificationPosition.

SetOverlayNotificationPosition ( ENotificationPosition eNotificationPosition ) : void

Sets the position where the overlay instance for the currently calling game should show notifications.

This position is per-game and if this function is called from outside of a game context it will do nothing.

SetWarningMessageHook ( SteamAPIWarningMessageHook_t pFunction ) : void

API warning handling

'int' is the severity; 0 for msg, 1 for warning

'const char *' is the text of the message

callbacks will occur directly after the API function is called that generated the warning or message

ShowGamepadTextInput ( EGamepadTextInputMode eInputMode, EGamepadTextInputLineMode eLineInputMode, string pchDescription, uint unCharMax, string pchExistingText ) : bool

Activates the Big Picture text input dialog which only supports gamepad input

StartVRDashboard ( ) : void

ask SteamUI to create and render its OpenVR dashboard

Описание методов

BOverlayNeedsPresent() публичный статический Метод

Normally this call is unneeded if your game has a constantly running frame loop that calls the

D3D Present API, or OGL SwapBuffers API every frame.

However, if you have a game that only refreshes the screen on an event driven basis then that can break

the overlay, as it uses your Present/SwapBuffers calls to drive it's internal frame loop and it may also

need to Present() to the screen any time an even needing a notification happens or when the overlay is

brought up over the game by a user. You can use this API to ask the overlay if it currently need a present

in that case, and then you can check for this periodically (roughly 33hz is desirable) and make sure you

refresh the screen with Present or SwapBuffers to allow the overlay to do it's work.

public static BOverlayNeedsPresent ( ) : bool
Результат bool

CheckFileSignature() публичный статический Метод

Asynchronous call to check if an executable file has been signed using the public key set on the signing tab

of the partner site, for example to refuse to load modified executable files.

The result is returned in CheckFileSignature_t.

k_ECheckFileSignatureNoSignaturesFoundForThisApp - This app has not been configured on the signing tab of the partner site to enable this function.

k_ECheckFileSignatureNoSignaturesFoundForThisFile - This file is not listed on the signing tab for the partner site.

k_ECheckFileSignatureFileNotFound - The file does not exist on disk.

k_ECheckFileSignatureInvalidSignature - The file exists, and the signing tab has been set for this file, but the file is either not signed or the signature does not match.

k_ECheckFileSignatureValidSignature - The file is signed and the signature is valid.

public static CheckFileSignature ( string szFileName ) : SteamAPICall_t
szFileName string
Результат SteamAPICall_t

GetAPICallFailureReason() публичный статический Метод

public static GetAPICallFailureReason ( SteamAPICall_t hSteamAPICall ) : ESteamAPICallFailure
hSteamAPICall SteamAPICall_t
Результат ESteamAPICallFailure

GetAPICallResult() публичный статический Метод

public static GetAPICallResult ( SteamAPICall_t hSteamAPICall, IntPtr pCallback, int cubCallback, int iCallbackExpected, bool &pbFailed ) : bool
hSteamAPICall SteamAPICall_t
pCallback System.IntPtr
cubCallback int
iCallbackExpected int
pbFailed bool
Результат bool

GetAppID() публичный статический Метод

returns the appID of the current process

public static GetAppID ( ) : AppId_t
Результат AppId_t

GetCSERIPPort() публичный статический Метод

returns the IP of the reporting server for valve - currently only used in Source engine games

public static GetCSERIPPort ( uint &unIP, ushort &usPort ) : bool
unIP uint
usPort ushort
Результат bool

GetConnectedUniverse() публичный статический Метод

the universe this client is connecting to

public static GetConnectedUniverse ( ) : EUniverse
Результат EUniverse

GetCurrentBatteryPower() публичный статический Метод

return the amount of battery power left in the current system in % [0..100], 255 for being on AC power

public static GetCurrentBatteryPower ( ) : byte
Результат byte

GetEnteredGamepadTextInput() публичный статический Метод

public static GetEnteredGamepadTextInput ( string &pchText, uint cchText ) : bool
pchText string
cchText uint
Результат bool

GetEnteredGamepadTextLength() публичный статический Метод

Returns previously entered text & length

public static GetEnteredGamepadTextLength ( ) : uint
Результат uint

GetIPCCallCount() публичный статический Метод

returns the number of IPC calls made since the last time this function was called

Used for perf debugging so you can understand how many IPC calls your game makes per frame

Every IPC call is at minimum a thread context switch if not a process one so you want to rate

control how often you do them.

public static GetIPCCallCount ( ) : uint
Результат uint

GetIPCountry() публичный статический Метод

returns the 2 digit ISO 3166-1-alpha-2 format country code this client is running in (as looked up via an IP-to-location database)

e.g "US" or "UK".

public static GetIPCountry ( ) : string
Результат string

GetImageRGBA() публичный статический Метод

returns true if the image exists, and the buffer was successfully filled out

results are returned in RGBA format

the destination buffer size should be 4 * height * width * sizeof(char)

public static GetImageRGBA ( int iImage, byte pubDest, int nDestBufferSize ) : bool
iImage int
pubDest byte
nDestBufferSize int
Результат bool

GetImageSize() публичный статический Метод

returns true if the image exists, and valid sizes were filled out

public static GetImageSize ( int iImage, uint &pnWidth, uint &pnHeight ) : bool
iImage int
pnWidth uint
pnHeight uint
Результат bool

GetSecondsSinceAppActive() публичный статический Метод

return the number of seconds since the user

public static GetSecondsSinceAppActive ( ) : uint
Результат uint

GetSecondsSinceComputerActive() публичный статический Метод

public static GetSecondsSinceComputerActive ( ) : uint
Результат uint

GetServerRealTime() публичный статический Метод

Steam server time. Number of seconds since January 1, 1970, GMT (i.e unix time)

public static GetServerRealTime ( ) : uint
Результат uint

GetSteamUILanguage() публичный статический Метод

returns the language the steam client is running in, you probably want ISteamApps::GetCurrentGameLanguage instead, this is for very special usage cases

public static GetSteamUILanguage ( ) : string
Результат string

IsAPICallCompleted() публичный статический Метод

API asynchronous call results

can be used directly, but more commonly used via the callback dispatch API (see steam_api.h)

public static IsAPICallCompleted ( SteamAPICall_t hSteamAPICall, bool &pbFailed ) : bool
hSteamAPICall SteamAPICall_t
pbFailed bool
Результат bool

IsOverlayEnabled() публичный статический Метод

Returns true if the overlay is running & the user can access it. The overlay process could take a few seconds to

start & hook the game process, so this function will initially return false while the overlay is loading.

public static IsOverlayEnabled ( ) : bool
Результат bool

IsSteamInBigPictureMode() публичный статический Метод

returns true if Steam & the Steam Overlay are running in Big Picture mode

Games much be launched through the Steam client to enable the Big Picture overlay. During development,

a game can be added as a non-steam game to the developers library to test this feature

public static IsSteamInBigPictureMode ( ) : bool
Результат bool

IsSteamRunningInVR() публичный статический Метод

returns true if Steam itself is running in VR mode

public static IsSteamRunningInVR ( ) : bool
Результат bool

SetOverlayNotificationInset() публичный статический Метод

Sets the inset of the overlay notification from the corner specified by SetOverlayNotificationPosition.

public static SetOverlayNotificationInset ( int nHorizontalInset, int nVerticalInset ) : void
nHorizontalInset int
nVerticalInset int
Результат void

SetOverlayNotificationPosition() публичный статический Метод

Sets the position where the overlay instance for the currently calling game should show notifications.

This position is per-game and if this function is called from outside of a game context it will do nothing.

public static SetOverlayNotificationPosition ( ENotificationPosition eNotificationPosition ) : void
eNotificationPosition ENotificationPosition
Результат void

SetWarningMessageHook() публичный статический Метод

API warning handling

'int' is the severity; 0 for msg, 1 for warning

'const char *' is the text of the message

callbacks will occur directly after the API function is called that generated the warning or message

public static SetWarningMessageHook ( SteamAPIWarningMessageHook_t pFunction ) : void
pFunction SteamAPIWarningMessageHook_t
Результат void

ShowGamepadTextInput() публичный статический Метод

Activates the Big Picture text input dialog which only supports gamepad input

public static ShowGamepadTextInput ( EGamepadTextInputMode eInputMode, EGamepadTextInputLineMode eLineInputMode, string pchDescription, uint unCharMax, string pchExistingText ) : bool
eInputMode EGamepadTextInputMode
eLineInputMode EGamepadTextInputLineMode
pchDescription string
unCharMax uint
pchExistingText string
Результат bool

StartVRDashboard() публичный статический Метод

ask SteamUI to create and render its OpenVR dashboard

public static StartVRDashboard ( ) : void
Результат void