167 lines
7.4 KiB
C++
167 lines
7.4 KiB
C++
//====== Copyright © 1996-2008, Valve Corporation, All rights reserved. =======
|
|
//
|
|
// Purpose: interface to both friends list data and general information about users
|
|
//
|
|
//=============================================================================
|
|
|
|
#ifndef ISTEAMFRIENDS_H
|
|
#define ISTEAMFRIENDS_H
|
|
#ifdef _WIN32
|
|
#pragma once
|
|
#endif
|
|
|
|
#include "isteamclient.h"
|
|
|
|
//-----------------------------------------------------------------------------
|
|
// Purpose: set of relationships to other users
|
|
//-----------------------------------------------------------------------------
|
|
enum EFriendRelationship
|
|
{
|
|
k_EFriendRelationshipNone = 0,
|
|
k_EFriendRelationshipBlocked = 1,
|
|
k_EFriendRelationshipRequestRecipient = 2,
|
|
k_EFriendRelationshipFriend = 3,
|
|
k_EFriendRelationshipRequestInitiator = 4,
|
|
k_EFriendRelationshipIgnored = 5,
|
|
k_EFriendRelationshipIgnoredFriend = 6,
|
|
};
|
|
|
|
|
|
//-----------------------------------------------------------------------------
|
|
// Purpose: list of states a friend can be in
|
|
//-----------------------------------------------------------------------------
|
|
enum EPersonaState
|
|
{
|
|
k_EPersonaStateOffline = 0, // friend is not currently logged on
|
|
k_EPersonaStateOnline = 1, // friend is logged on
|
|
k_EPersonaStateBusy = 2, // user is on, but busy
|
|
k_EPersonaStateAway = 3, // auto-away feature
|
|
k_EPersonaStateSnooze = 4, // auto-away for a long time
|
|
k_EPersonaStateMax,
|
|
};
|
|
|
|
|
|
//-----------------------------------------------------------------------------
|
|
// Purpose: flags for enumerating friends list, or quickly checking a the relationship between users
|
|
//-----------------------------------------------------------------------------
|
|
enum k_EFriendFlags
|
|
{
|
|
k_EFriendFlagNone = 0x00,
|
|
k_EFriendFlagBlocked = 0x01,
|
|
k_EFriendFlagFriendshipRequested = 0x02,
|
|
k_EFriendFlagImmediate = 0x04, // "regular" friend
|
|
k_EFriendFlagClanMember = 0x08,
|
|
k_EFriendFlagOnGameServer = 0x10,
|
|
// k_EFriendFlagHasPlayedWith = 0x20, // not currently used
|
|
// k_EFriendFlagFriendOfFriend = 0x40, // not currently used
|
|
k_EFriendFlagRequestingFriendship = 0x80,
|
|
k_EFriendFlagRequestingInfo = 0x100,
|
|
k_EFriendFlagIgnored = 0x200,
|
|
k_EFriendFlagIgnoredFriend = 0x400,
|
|
k_EFriendFlagAll = 0xFFFF,
|
|
};
|
|
|
|
// maximum number of characters in a users name
|
|
enum { k_cchPersonaNameMax = 128 };
|
|
|
|
// size limit on chat room or member metadata
|
|
const uint32 k_cubChatMetadataMax = 4096;
|
|
|
|
//-----------------------------------------------------------------------------
|
|
// Purpose: interface to accessing information about individual users,
|
|
// that can be a friend, in a group, on a game server or in a lobby with the local user
|
|
//-----------------------------------------------------------------------------
|
|
class ISteamFriends
|
|
{
|
|
public:
|
|
// returns the local players name - guaranteed to not be NULL.
|
|
// this is the same name as on the users community profile page
|
|
// this is stored in UTF-8 format
|
|
// like all the other interface functions that return a char *, it's important that this pointer is not saved
|
|
// off; it will eventually be free'd or re-allocated
|
|
virtual const char *GetPersonaName() = 0;
|
|
|
|
virtual void SetPersonaName( const char *pchPersonaName ) = 0;
|
|
virtual EPersonaState GetPersonaState() = 0;
|
|
virtual void SetPersonaState( EPersonaState ePersonaState ) = 0;
|
|
virtual bool AddFriend( CSteamID steamIDFriend ) = 0;
|
|
virtual bool RemoveFriend( CSteamID steamIDFriend ) = 0;
|
|
virtual bool HasFriend( CSteamID steamIDFriend ) = 0;
|
|
virtual EFriendRelationship GetFriendRelationship( CSteamID steamIDFriend ) = 0;
|
|
virtual EPersonaState GetFriendPersonaState( CSteamID steamIDFriend ) = 0;
|
|
virtual bool Deprecated_GetFriendGamePlayed( CSteamID steamIDFriend, int32 *pnGameID, uint32 *punGameIP, uint16 *pusGamePort ) = 0;
|
|
virtual const char *GetFriendPersonaName( CSteamID steamIDFriend ) = 0;
|
|
virtual int32 AddFriendByName( const char *pchEmailOrAccountName ) = 0;
|
|
virtual int GetFriendCount() = 0;
|
|
virtual CSteamID GetFriendByIndex( int iFriend ) = 0;
|
|
virtual void SendMsgToFriend( CSteamID steamIDFriend, EChatEntryType eChatEntryType, const char *pchMsgBody ) = 0;
|
|
virtual void SetFriendRegValue( CSteamID steamIDFriend, const char *pchKey, const char *pchValue ) = 0;
|
|
virtual const char *GetFriendRegValue( CSteamID steamIDFriend, const char *pchKey ) = 0;
|
|
virtual const char *GetFriendPersonaNameHistory( CSteamID steamIDFriend, int iPersonaName ) = 0;
|
|
virtual int GetChatMessage( CSteamID steamIDFriend, int iChatID, void *pvData, int cubData, EChatEntryType *peChatEntryType ) = 0;
|
|
|
|
virtual bool SendMsgToFriend( CSteamID steamIDFriend, EChatEntryType eChatEntryType, const void *pvMsgBody, int cubMsgBody ) = 0;
|
|
virtual int GetChatIDOfChatHistoryStart( CSteamID steamIDFriend ) = 0;
|
|
virtual void SetChatHistoryStart( CSteamID steamIDFriend, int iChatID ) = 0;
|
|
virtual void ClearChatHistory( CSteamID steamIDFriend ) = 0;
|
|
virtual bool InviteFriendByEmail( const char *pchEmailAccount ) = 0;
|
|
virtual int GetBlockedFriendCount() = 0;
|
|
virtual bool GetFriendGamePlayed( CSteamID steamIDFriend, uint64 *pulGameID, uint32 *punGameIP, uint16 *pusGamePort ) = 0;
|
|
virtual bool GetFriendGamePlayed2( CSteamID steamIDFriend, uint64 *pulGameID, uint32 *punGameIP, uint16 *pusGamePort, uint16 *pusQueryPort ) = 0;
|
|
};
|
|
|
|
#define STEAMFRIENDS_INTERFACE_VERSION "SteamFriends001"
|
|
|
|
//-----------------------------------------------------------------------------
|
|
// Purpose: called when a friends' status changes
|
|
//-----------------------------------------------------------------------------
|
|
struct PersonaStateChange_t
|
|
{
|
|
enum { k_iCallback = k_iSteamFriendsCallbacks + 4 };
|
|
|
|
uint64 m_ulSteamID; // steamID of the friend who changed
|
|
int m_nChangeFlags; // what's changed
|
|
};
|
|
|
|
|
|
// used in PersonaStateChange_t::m_nChangeFlags to describe what's changed about a user
|
|
// these flags describe what the client has learned has changed recently, so on startup you'll see a name, avatar & relationship change for every friend
|
|
enum EPersonaChange
|
|
{
|
|
k_EPersonaChangeName = 0x001,
|
|
k_EPersonaChangeStatus = 0x002,
|
|
k_EPersonaChangeComeOnline = 0x004,
|
|
k_EPersonaChangeGoneOffline = 0x008,
|
|
k_EPersonaChangeGamePlayed = 0x010,
|
|
k_EPersonaChangeGameServer = 0x020,
|
|
k_EPersonaChangeAvatar = 0x040,
|
|
k_EPersonaChangeJoinedSource= 0x080,
|
|
k_EPersonaChangeLeftSource = 0x100,
|
|
k_EPersonaChangeRelationshipChanged = 0x200,
|
|
k_EPersonaChangeNameFirstSet = 0x400,
|
|
};
|
|
|
|
|
|
//-----------------------------------------------------------------------------
|
|
// Purpose: posted when game overlay activates or deactivates
|
|
// the game can use this to be pause or resume single player games
|
|
//-----------------------------------------------------------------------------
|
|
struct GameOverlayActivated_t
|
|
{
|
|
enum { k_iCallback = k_iSteamFriendsCallbacks + 31 };
|
|
uint8 m_bActive; // true if it's just been activated, false otherwise
|
|
};
|
|
|
|
|
|
//-----------------------------------------------------------------------------
|
|
// Purpose: called when the user tries to join a different game server from their friends list
|
|
// game client should attempt to connect to specified server when this is received
|
|
//-----------------------------------------------------------------------------
|
|
struct GameServerChangeRequested_t
|
|
{
|
|
enum { k_iCallback = k_iSteamFriendsCallbacks + 32 };
|
|
char m_rgchServer[64]; // server address ("127.0.0.1:27015", "tf2.valvesoftware.com")
|
|
char m_rgchPassword[64]; // server password, if any
|
|
};
|
|
|
|
#endif // ISTEAMFRIENDS_H
|