204 lines
12 KiB
Protocol Buffer
204 lines
12 KiB
Protocol Buffer
//====== Copyright 1996-2010, Valve Corporation, All rights reserved. =======
|
|
//
|
|
// Purpose: The file defines our Google Protocol Buffers which are used in over
|
|
// the wire messages between servers as well as between clients and servers.
|
|
//
|
|
//=============================================================================
|
|
|
|
// We care more about speed than code size
|
|
option optimize_for = SPEED;
|
|
|
|
// We don't use the service generation functionality
|
|
option cc_generic_services = false;
|
|
|
|
|
|
//
|
|
// STYLE NOTES:
|
|
//
|
|
// Use CamelCase CMsgMyMessageName style names for messages.
|
|
//
|
|
// Use lowercase _ delimited names like my_steam_id for field names, this is non-standard for Steam,
|
|
// but plays nice with the Google formatted code generation.
|
|
//
|
|
// Try not to use required fields ever. Only do so if you are really really sure you'll never want them removed.
|
|
// Optional should be preffered as it will make versioning easier and cleaner in the future if someone refactors
|
|
// your message and wants to remove or rename fields.
|
|
//
|
|
// Use fixed64 for JobId_t, GID_t, or SteamID. This is appropriate for any field that is normally
|
|
// going to be larger than 2^56. Otherwise use int64 for 64 bit values that are frequently smaller
|
|
// than 2^56 as it will safe space on the wire in those cases.
|
|
//
|
|
// Similar to fixed64, use fixed32 for RTime32 or other 32 bit values that are frequently larger than
|
|
// 2^28. It will safe space in those cases, otherwise use int32 which will safe space for smaller values.
|
|
// An exception to this rule for RTime32 is if the value will frequently be zero rather than set to an actual
|
|
// time.
|
|
//
|
|
|
|
enum EGCSystemMsg
|
|
{
|
|
k_EGCMsgInvalid = 0;
|
|
k_EGCMsgMulti = 1;
|
|
|
|
k_EGCMsgGenericReply = 10;
|
|
|
|
k_EGCMsgSystemBase = 50;
|
|
k_EGCMsgAchievementAwarded = 51;
|
|
k_EGCMsgConCommand = 52; // A command from the GC's admin console
|
|
k_EGCMsgStartPlaying = 53;
|
|
k_EGCMsgStopPlaying = 54;
|
|
k_EGCMsgStartGameserver = 55;
|
|
k_EGCMsgStopGameserver = 56;
|
|
k_EGCMsgWGRequest = 57;
|
|
k_EGCMsgWGResponse = 58;
|
|
k_EGCMsgGetUserGameStatsSchema = 59; // Gets the user game stats schema for the app
|
|
k_EGCMsgGetUserGameStatsSchemaResponse = 60;
|
|
k_EGCMsgGetUserStatsDEPRECATED = 61; // Gets user game stats for a user
|
|
k_EGCMsgGetUserStatsResponse = 62;
|
|
k_EGCMsgAppInfoUpdated = 63; // Message sent to the GC when there has been an AppInfo update
|
|
k_EGCMsgValidateSession = 64; // Message sent by the GC when it wants to make sure a session exists
|
|
k_EGCMsgValidateSessionResponse = 65; // Message sent to the GC in response to ValidateSession
|
|
k_EGCMsgLookupAccountFromInput = 66; // Sent by the GC to lookup user. Reply is k_EGCMsgGenericReply
|
|
k_EGCMsgSendHTTPRequest = 67; // Message sent by the GC to do a generic HTTP request
|
|
k_EGCMsgSendHTTPRequestResponse = 68; // Response back to the GC with the results of the HTTP request
|
|
k_EGCMsgPreTestSetup = 69; // Reset the GC database (usually for testing purposes)
|
|
k_EGCMsgRecordSupportAction = 70; // Logs a support action
|
|
k_EGCMsgGetAccountDetails_DEPRECATED = 71; // DEPRECATED - Use protobuf-based k_EGCMsgGetAccountDetails //Requests the details for an account
|
|
// k_EGCMsgSendInterAppMessage = 72; // Sends a message to another app's GC
|
|
k_EGCMsgReceiveInterAppMessage = 73; // Receives a message from another app's GC
|
|
k_EGCMsgFindAccounts = 74; // queries the AMs for accounts by name
|
|
k_EGCMsgPostAlert = 75; // posts an alert to Steam
|
|
k_EGCMsgGetLicenses = 76; // asks Steam for the user's licenses
|
|
k_EGCMsgGetUserStats = 77; // Gets user game stats for a user
|
|
k_EGCMsgGetCommands = 78; // request for a list of commands from a gc console
|
|
k_EGCMsgGetCommandsResponse = 79; // response with a list of commands for a gc console
|
|
k_EGCMsgAddFreeLicense = 80; // request for for Steam to add a license to the specified free package
|
|
k_EGCMsgAddFreeLicenseResponse = 81; // response with the result of the attempt to add a free license
|
|
k_EGCMsgGetIPLocation = 82; // Get geolocation data for a specific IP
|
|
k_EGCMsgGetIPLocationResponse = 83; // Geolocation response
|
|
|
|
k_EGCMsgSystemStatsSchema = 84; // Message sent by the GC specifying what its stats schema is
|
|
k_EGCMsgGetSystemStats = 85; // Message sent to the GC requesting its stats
|
|
k_EGCMsgGetSystemStatsResponse = 86; // Message sent by the GC with its stats
|
|
|
|
k_EGCMsgSendEmail = 87; // Sent by the GC to send an email to a user
|
|
k_EGCMsgSendEmailResponse = 88; // Response with the result of the send request
|
|
k_EGCMsgGetEmailTemplate = 89; // Sent to the GC to request an email template
|
|
k_EGCMsgGetEmailTemplateResponse = 90; // Get email template response
|
|
k_EGCMsgGrantGuestPass = 91; // Sends a guest pass/gift to a user
|
|
k_EGCMsgGrantGuestPassResponse = 92; // Send guest pass response
|
|
k_EGCMsgGetAccountDetails = 93; // Requests the details for an account
|
|
k_EGCMsgGetAccountDetailsResponse = 94; // Requests the details for an account response
|
|
k_EGCMsgGetPersonaNames = 95; // Gets the persona names for a set of accounts
|
|
k_EGCMsgGetPersonaNamesResponse = 96; // Gets the persona names for a set of accounts response
|
|
k_EGCMsgMultiplexMsg = 97; // Sends a single message to multiple users
|
|
|
|
// web API calls
|
|
k_EGCMsgWebAPIRegisterInterfaces = 101; // sent once at startup to register APIs
|
|
k_EGCMsgWebAPIJobRequest = 102; // sent when an actual request is made
|
|
// k_EGCMsgWebAPIRegistrationRequested = 103; // sent by the GC Host when it learns a web API server has started -- No longer sent by the GCH
|
|
k_EGCMsgWebAPIJobRequestHttpResponse = 104; // sent by the GC in response to k_EGCMsgWebAPIJobRequest - uses CMsgHttpResponse
|
|
k_EGCMsgWebAPIJobRequestForwardResponse = 105; // sent by the GC in response to k_EGCMsgWebAPIJobRequest - uses CMsgGCMsgWebAPIJobRequestForwardResponse
|
|
|
|
|
|
// Memcached
|
|
k_EGCMsgMemCachedGet = 200; // Get key(s) from memcached
|
|
k_EGCMsgMemCachedGetResponse = 201; // Retrieved keys
|
|
k_EGCMsgMemCachedSet = 202; // Set key(s) into memcached
|
|
k_EGCMsgMemCachedDelete = 203; // Delete key(s) from memcached
|
|
k_EGCMsgMemCachedStats = 204; // Request stats from memcached
|
|
k_EGCMsgMemCachedStatsResponse = 205; // Retrieved stats
|
|
|
|
// SQL
|
|
k_EGCMsgSQLStats = 210; // Get the current SQL stats
|
|
k_EGCMsgSQLStatsResponse = 211; // Retrieved stats
|
|
|
|
// Multi-GC setup
|
|
k_EGCMsgMasterSetDirectory = 220; // The master GC will send this back to the GCH indicating the sub GC's that need to be created
|
|
k_EGCMsgMasterSetDirectoryResponse = 221; // Response back from the GCH to the master GC regarding the successful receiving of the directory (note this doesn't mean all sub GCs are done starting up)
|
|
k_EGCMsgMasterSetWebAPIRouting = 222; // The master GC will send this back to the GCH indicating the routing details for WebAPI requests
|
|
k_EGCMsgMasterSetWebAPIRoutingResponse = 223; // Response back from the GCH to the master GC regarding the successful receipt and processing of k_EGCMsgMasterSetWebAPIRouting
|
|
k_EGCMsgMasterSetClientMsgRouting = 224; // The master GC will send this back to the GCH indicating the routing details for client messages
|
|
k_EGCMsgMasterSetClientMsgRoutingResponse = 225; // Response back from the GCH to the master GC regarding the successful receipt and processing of k_EGCMsgMasterSetClientMsgRouting
|
|
k_EGCMsgSetOptions = 226; // Each GC can send this back to the GCH indicating which client messages and data streams the GC is interested in
|
|
k_EGCMsgSetOptionsResponse = 227; // Response back from the GCH (optional - don't send a job ID with SetOptions to skip the response)
|
|
|
|
// Newer GC SDK messages. All should be protobuf based.
|
|
k_EGCMsgSystemBase2 = 500;
|
|
k_EGCMsgGetPurchaseTrustStatus = 501; // Gets information about a user's purchase trustworthiness
|
|
k_EGCMsgGetPurchaseTrustStatusResponse = 502; // Gets information about a user's purchase trustworthiness response
|
|
k_EGCMsgUpdateSession = 503; // GCH update regarding the status of a session, only sent if the convar to enable these messages is set
|
|
k_EGCMsgGCAccountVacStatusChange = 504; // Accounts VAC status has changed
|
|
k_EGCMsgCheckFriendship = 505; // GC checking if two users are friends
|
|
k_EGCMsgCheckFriendshipResponse = 506; // Response to the GC regarding the users' friendship
|
|
k_EGCMsgGetPartnerAccountLink = 507; // Request the partner account link details for a user
|
|
k_EGCMsgGetPartnerAccountLinkResponse = 508; // Response to the GC with the partner account link details
|
|
k_EGCMsgVSReportedSuspiciousActivity = 509; // Suspicious activity detected on user's account
|
|
k_EGCMsgAccountTradeBanStatusChange = 510; // Account's trade ban status has changed
|
|
k_EGCMsgAccountLockStatusChange = 511; // Account's lock status has changed
|
|
k_EGCMsgDPPartnerMicroTxns = 512; // A set of microtransaction data relayed to the DP for insert or update.
|
|
k_EGCMsgDPPartnerMicroTxnsResponse = 513; // ... Response
|
|
k_EGCMsgGetIPASN = 514; // Get ASN data for a specific IP
|
|
k_EGCMsgGetIPASNResponse = 515; // IP ASN response
|
|
k_EGCMsgGetAppFriendsList = 516; // GC requesting a list of app-friends for a user (defined as friends who play the app requesting the friends list)
|
|
k_EGCMsgGetAppFriendsListResponse = 517; // ... Response
|
|
k_EGCMsgVacVerificationChange = 518; // From VS to GC
|
|
k_EGCMsgAccountPhoneNumberChange = 519; // From Phone Server to GC
|
|
k_EGCMsgAccountTwoFactorChange = 520; // From AM to GC
|
|
k_EGCMsgCheckClanMembership = 521; // Checks if an account is a member of a given clan
|
|
k_EGCMsgCheckClanMembershipResponse = 522; // Checks if an account is a member of a given clan response
|
|
};
|
|
|
|
enum ESOMsg
|
|
{
|
|
k_ESOMsg_Create = 21;
|
|
k_ESOMsg_Update = 22;
|
|
k_ESOMsg_Destroy = 23;
|
|
k_ESOMsg_CacheSubscribed = 24;
|
|
k_ESOMsg_CacheUnsubscribed = 25;
|
|
k_ESOMsg_UpdateMultiple = 26;
|
|
k_ESOMsg_CacheSubscriptionCheck = 27; // need to get rid of this!
|
|
k_ESOMsg_CacheSubscriptionRefresh = 28;
|
|
k_ESOMsg_CacheSubscribedUpToDate = 29;
|
|
};
|
|
|
|
enum EGCBaseClientMsg
|
|
{
|
|
k_EMsgGCPingRequest = 3001; // GC <=> client
|
|
k_EMsgGCPingResponse = 3002; // GC <=> client
|
|
|
|
// WARNING: These messages were promoted into the gcsdk
|
|
// from base_gcmessages.proto (which is not part of the gcsdk put is
|
|
// "shared game code"). But we did not want to change the numbers
|
|
// for existing messages. Don't add new messages in the 4000 range!
|
|
k_EMsgGCClientWelcome = 4004; // GC => client
|
|
k_EMsgGCServerWelcome = 4005; // GC => server
|
|
k_EMsgGCClientHello = 4006; // client => GC
|
|
k_EMsgGCServerHello = 4007; // server => GC
|
|
|
|
k_EMsgGCClientGoodbye = 4008; // GC => client
|
|
k_EMsgGCServerGoodbye = 4009; // GC => server
|
|
|
|
// !FIXME! DOTAMERGE
|
|
//k_EMsgGCClientConnectionStatus = 4009; // GC => client
|
|
//k_EMsgGCServerConnectionStatus = 4010; // GC => server
|
|
|
|
};
|
|
|
|
enum EGCToGCMsg
|
|
{
|
|
k_EGCToGCMsgMasterAck = 150; // Sub GC => Master GC, confirm that we've started up successfully so the master can go when all sub GCs are ready
|
|
k_EGCToGCMsgMasterAckResponse = 151; // Master GC => Sub GC, the ack came through fine and everything is as expected
|
|
k_EGCToGCMsgRouted = 152; // Master GC => Sub GC, a routed message that originally came in from a client or the system and has been sent to another GC
|
|
k_EGCToGCMsgRoutedReply = 153; // Sub GC => Sub/Master GC, a reply message that needs to be sent back from the original GC that received the message
|
|
k_EMsgGCUpdateSubGCSessionInfo = 154; // Master GC => Other GCs
|
|
k_EMsgGCRequestSubGCSessionInfo = 155; // Sub GC => Master GC
|
|
k_EMsgGCRequestSubGCSessionInfoResponse = 156; // Master GC => Sub GC
|
|
k_EGCToGCMsgMasterStartupComplete = 157; // Master GC => Sub GC - Indicates that the master universe has completed startup, indicating that sub GC's are in a good spot to complete startup
|
|
k_EMsgGCToGCSOCacheSubscribe = 158; // Master GC => Sub GC - A steam ID has subscribed to another SO cache (or possibly their own)
|
|
k_EMsgGCToGCSOCacheUnsubscribe = 159; // Master GC => Sub GC - A steam ID has unsubscribed from another SO cache (or possibly their own)
|
|
}
|
|
|
|
|
|
// Do not remove this comment due to a bug on the Mac OS X protobuf compiler
|
|
|