C# 클래스 Steamworks.SteamGameServer

associate this game server with this clan for the purposes of computing player compat

status functions

Update the data to be displayed in the server browser and matchmaking interfaces for a user

currently connected to the server. For regular users you must call this after you receive a

GSUserValidationSuccess callback.

Return Value: true if successful, false if failure (ie, steamIDUser wasn't for an active player)

Authenticate ticket ( from GetAuthSessionTicket ) from entity steamID to be sure it is valid and isnt reused

Registers for callbacks if the entity goes offline or cancels the ticket ( see ValidateAuthTicketResponse_t callback and EAuthSessionResponse )

Cancel auth ticket from GetAuthSessionTicket, called when no longer playing game with the entity you gave the ticket to

/ Call this to clear the whole list of key/values that are sent in rules queries.

ask if any of the current players dont want to play with this new player - or vice versa

Creates a fake user (ie, a bot) which will be listed as playing on the server, but skips validation.

Return Value: Returns a SteamID for the user to be tracked with, you should call HandleUserDisconnect()

when this user leaves the server just like you would for a real user.

Control heartbeats / advertisement with master server

Call this as often as you like to tell the master server updater whether or not

you want it to be active (default: off).

Stop tracking started by BeginAuthSession - called when no longer playing game with this entity

Force a heartbeat to steam at the next opportunity

New auth system APIs - do not mix with the old auth system APIs.

----------------------------------------------------------------

Retrieve ticket to be sent to the entity who wishes to authenticate you ( using BeginAuthSession API ).

pcbTicket retrieves the length of the actual ticket.

these two functions s are deprecated, and will not return results

they will be removed in a future version of the SDK

AFTER calling HandleIncomingPacket for any packets that came in that frame, call this.

This gets a packet that the master server updater needs to send out on UDP.

It returns the length of the packet it wants to send, or 0 if there are no more packets to send.

Call this each frame until it returns 0.

Returns the public IP of the server according to Steam, useful when the server is

behind NAT and you want to advertise its IP in a lobby for other clients to directly

connect to

These are in GameSocketShare mode, where instead of ISteamGameServer creating its own

socket to talk to the master server on, it lets the game use its socket to forward messages

back and forth. This prevents us from requiring server ops to open up yet another port

in their firewalls.

the IP address and port should be in host order, i.e 127.0.0.1 == 0x7f000001

These are used when you've elected to multiplex the game server's UDP socket

rather than having the master server updater use its own sockets.

Source games use this to simplify the job of the server admins, so they

don't have to open up more ports on their firewalls.

Call this when a packet that starts with 0xFFFFFFFF comes in. That means

it's for us.

Basic server data. These properties, if set, must be set before before calling LogOn. They

may not be changed after logged in.

/ This is called by SteamGameServer_Init, and you will usually not need to call it directly

/ Begin process of logging game server out of steam

Login

/ Begin process to login to a persistent game server account

/

/ You need to register for callbacks to determine the result of this operation.

/ @see SteamServersConnected_t

/ @see SteamServerConnectFailure_t

/ @see SteamServersDisconnected_t

/ Login to a generic, anonymous account.

/

/ Note: in previous versions of the SDK, this was automatically called within SteamGameServer_Init,

/ but this is no longer the case.

Ask if a user in in the specified group, results returns async by GSUserGroupStatus_t

returns false if we're not connected to the steam servers and thus cannot ask

Player list management / authentication

Handles receiving a new connection from a Steam user. This call will ask the Steam

servers to validate the users identity, app ownership, and VAC status. If the Steam servers

are off-line, then it will validate the cached ticket itself which will validate app ownership

and identity. The AuthBlob here should be acquired on the game client using SteamUser()->InitiateGameConnection()

and must then be sent up to the game server for authentication.

Return Value: returns true if the users ticket passes basic checks. pSteamIDUser will contain the Steam ID of this user. pSteamIDUser must NOT be NULL

If the call succeeds then you should expect a GSClientApprove_t or GSClientDeny_t callback which will tell you whether authentication

for the user has succeeded or failed (the steamid in the callback will match the one returned by this call)

Should be called whenever a user leaves our game server, this lets Steam internally

track which users are currently on which servers for the purposes of preventing a single

account being logged into multiple servers, showing who is currently on a server, etc.

/ Number of bots. Default value is zero

/ Is this is a dedicated server? The default value is false.

/ Sets a string defining the "gamedata" for this server, this is optional, but if it is set

/ it allows users to filter in the matchmaking/server-browser interfaces based on the value

/ don't set this unless it actually changes, its only uploaded to the master once (when

/ acknowledged)

/

/ @see k_cbMaxGameServerGameData

/ Description of the game. This is a required field and is displayed in the steam server browser....for now.

/ This is a required field, but it will go away eventually, as the data should be determined from the AppID.

/ Sets a string defining the "gametags" for this server, this is optional, but if it is set

/ it allows users to filter in the matchmaking/server-browser interfaces based on the value

/

/ @see k_cbMaxGameServerTags

You usually don't need to modify this.

Pass -1 to use the default value for iHeartbeatInterval.

Some mods change this.

/ Call this to add/update a key/value pair.

/ Set name of map to report in the server browser

/

/ @see k_cbMaxGameServerName

Server state. These properties may be changed at any time.

/ Max player count that will be reported to server browser and client queries

/ If your game is a "mod," pass the string that identifies it. The default is an empty string, meaning

/ this application is the original game, not a mod.

/

/ @see k_cbMaxGameServerGameDir

/ Let people know if your server will require a password

/ Game product identifier. This is currently used by the master server for version checking purposes.

/ It's a required field, but will eventually will go away, and the AppID will be used for this purpose.

/ Region identifier. This is an optional field, the default value is empty, meaning the "world" region

/ Set the name of server as it will appear in the server browser

/

/ @see k_cbMaxGameServerName

/ Spectator server. The default value is zero, meaning the service

/ is not used.

/ Name of the spectator server. (Only used if spectator port is nonzero.)

/

/ @see k_cbMaxGameServerMapName

After receiving a user's authentication data, and passing it to SendUserConnectAndAuthenticate, use this function

to determine if the user owns downloadable content specified by the provided AppID.

/ Returns true if the master server has requested a restart.

/ Only returns true once per request.