mirror of
https://github.com/Detanup01/gbe_fork.git
synced 2024-12-05 08:45:37 +08:00
215 lines
13 KiB
C
215 lines
13 KiB
C
|
|
||
|
|
#ifndef ISTEAMREMOTESTORAGE014_H
|
||
|
|
#define ISTEAMREMOTESTORAGE014_H
|
||
|
|
#ifdef STEAM_WIN32
|
||
|
|
#pragma once
|
||
|
|
#endif
|
||
|
|
|
||
|
|
|
||
|
|
//-----------------------------------------------------------------------------
|
||
|
|
// Purpose: Functions for accessing, reading and writing files stored remotely
|
||
|
|
// and cached locally
|
||
|
|
//-----------------------------------------------------------------------------
|
||
|
|
class ISteamRemoteStorage014
|
||
|
|
{
|
||
|
|
public:
|
||
|
|
// NOTE
|
||
|
|
//
|
||
|
|
// Filenames are case-insensitive, and will be converted to lowercase automatically.
|
||
|
|
// So "foo.bar" and "Foo.bar" are the same file, and if you write "Foo.bar" then
|
||
|
|
// iterate the files, the filename returned will be "foo.bar".
|
||
|
|
//
|
||
|
|
|
||
|
|
// file operations
|
||
|
|
virtual bool FileWrite( const char *pchFile, const void *pvData, int32 cubData ) = 0;
|
||
|
|
virtual int32 FileRead( const char *pchFile, void *pvData, int32 cubDataToRead ) = 0;
|
||
|
|
|
||
|
|
STEAM_CALL_RESULT( RemoteStorageFileWriteAsyncComplete_t )
|
||
|
|
virtual SteamAPICall_t FileWriteAsync( const char *pchFile, const void *pvData, uint32 cubData ) = 0;
|
||
|
|
|
||
|
|
STEAM_CALL_RESULT( RemoteStorageFileReadAsyncComplete_t )
|
||
|
|
virtual SteamAPICall_t FileReadAsync( const char *pchFile, uint32 nOffset, uint32 cubToRead ) = 0;
|
||
|
|
virtual bool FileReadAsyncComplete( SteamAPICall_t hReadCall, void *pvBuffer, uint32 cubToRead ) = 0;
|
||
|
|
|
||
|
|
virtual bool FileForget( const char *pchFile ) = 0;
|
||
|
|
virtual bool FileDelete( const char *pchFile ) = 0;
|
||
|
|
STEAM_CALL_RESULT( RemoteStorageFileShareResult_t )
|
||
|
|
virtual SteamAPICall_t FileShare( const char *pchFile ) = 0;
|
||
|
|
virtual bool SetSyncPlatforms( const char *pchFile, ERemoteStoragePlatform eRemoteStoragePlatform ) = 0;
|
||
|
|
|
||
|
|
// file operations that cause network IO
|
||
|
|
virtual UGCFileWriteStreamHandle_t FileWriteStreamOpen( const char *pchFile ) = 0;
|
||
|
|
virtual bool FileWriteStreamWriteChunk( UGCFileWriteStreamHandle_t writeHandle, const void *pvData, int32 cubData ) = 0;
|
||
|
|
virtual bool FileWriteStreamClose( UGCFileWriteStreamHandle_t writeHandle ) = 0;
|
||
|
|
virtual bool FileWriteStreamCancel( UGCFileWriteStreamHandle_t writeHandle ) = 0;
|
||
|
|
|
||
|
|
// file information
|
||
|
|
virtual bool FileExists( const char *pchFile ) = 0;
|
||
|
|
virtual bool FilePersisted( const char *pchFile ) = 0;
|
||
|
|
virtual int32 GetFileSize( const char *pchFile ) = 0;
|
||
|
|
virtual int64 GetFileTimestamp( const char *pchFile ) = 0;
|
||
|
|
virtual ERemoteStoragePlatform GetSyncPlatforms( const char *pchFile ) = 0;
|
||
|
|
|
||
|
|
// iteration
|
||
|
|
virtual int32 GetFileCount() = 0;
|
||
|
|
virtual const char *GetFileNameAndSize( int iFile, int32 *pnFileSizeInBytes ) = 0;
|
||
|
|
|
||
|
|
// configuration management
|
||
|
|
virtual bool GetQuota( uint64 *pnTotalBytes, uint64 *puAvailableBytes ) = 0;
|
||
|
|
virtual bool IsCloudEnabledForAccount() = 0;
|
||
|
|
virtual bool IsCloudEnabledForApp() = 0;
|
||
|
|
virtual void SetCloudEnabledForApp( bool bEnabled ) = 0;
|
||
|
|
|
||
|
|
// user generated content
|
||
|
|
|
||
|
|
// Downloads a UGC file. A priority value of 0 will download the file immediately,
|
||
|
|
// otherwise it will wait to download the file until all downloads with a lower priority
|
||
|
|
// value are completed. Downloads with equal priority will occur simultaneously.
|
||
|
|
STEAM_CALL_RESULT( RemoteStorageDownloadUGCResult_t )
|
||
|
|
virtual SteamAPICall_t UGCDownload( UGCHandle_t hContent, uint32 unPriority ) = 0;
|
||
|
|
|
||
|
|
// Gets the amount of data downloaded so far for a piece of content. pnBytesExpected can be 0 if function returns false
|
||
|
|
// or if the transfer hasn't started yet, so be careful to check for that before dividing to get a percentage
|
||
|
|
virtual bool GetUGCDownloadProgress( UGCHandle_t hContent, int32 *pnBytesDownloaded, int32 *pnBytesExpected ) = 0;
|
||
|
|
|
||
|
|
// Gets metadata for a file after it has been downloaded. This is the same metadata given in the RemoteStorageDownloadUGCResult_t call result
|
||
|
|
virtual bool GetUGCDetails( UGCHandle_t hContent, AppId_t *pnAppID, STEAM_OUT_STRING() char **ppchName, int32 *pnFileSizeInBytes, STEAM_OUT_STRUCT() CSteamID *pSteamIDOwner ) = 0;
|
||
|
|
|
||
|
|
// After download, gets the content of the file.
|
||
|
|
// Small files can be read all at once by calling this function with an offset of 0 and cubDataToRead equal to the size of the file.
|
||
|
|
// Larger files can be read in chunks to reduce memory usage (since both sides of the IPC client and the game itself must allocate
|
||
|
|
// enough memory for each chunk). Once the last byte is read, the file is implicitly closed and further calls to UGCRead will fail
|
||
|
|
// unless UGCDownload is called again.
|
||
|
|
// For especially large files (anything over 100MB) it is a requirement that the file is read in chunks.
|
||
|
|
virtual int32 UGCRead( UGCHandle_t hContent, void *pvData, int32 cubDataToRead, uint32 cOffset, EUGCReadAction eAction ) = 0;
|
||
|
|
|
||
|
|
// Functions to iterate through UGC that has finished downloading but has not yet been read via UGCRead()
|
||
|
|
virtual int32 GetCachedUGCCount() = 0;
|
||
|
|
virtual UGCHandle_t GetCachedUGCHandle( int32 iCachedContent ) = 0;
|
||
|
|
|
||
|
|
// The following functions are only necessary on the Playstation 3. On PC & Mac, the Steam client will handle these operations for you
|
||
|
|
// On Playstation 3, the game controls which files are stored in the cloud, via FilePersist, FileFetch, and FileForget.
|
||
|
|
|
||
|
|
#if defined(_SERVER)
|
||
|
|
// Connect to Steam and get a list of files in the Cloud - results in a RemoteStorageAppSyncStatusCheck_t callback
|
||
|
|
virtual void GetFileListFromServer() = 0;
|
||
|
|
// Indicate this file should be downloaded in the next sync
|
||
|
|
virtual bool FileFetch( const char *pchFile ) = 0;
|
||
|
|
// Indicate this file should be persisted in the next sync
|
||
|
|
virtual bool FilePersist( const char *pchFile ) = 0;
|
||
|
|
// Pull any requested files down from the Cloud - results in a RemoteStorageAppSyncedClient_t callback
|
||
|
|
virtual bool SynchronizeToClient() = 0;
|
||
|
|
// Upload any requested files to the Cloud - results in a RemoteStorageAppSyncedServer_t callback
|
||
|
|
virtual bool SynchronizeToServer() = 0;
|
||
|
|
// Reset any fetch/persist/etc requests
|
||
|
|
virtual bool ResetFileRequestState() = 0;
|
||
|
|
#endif
|
||
|
|
|
||
|
|
// publishing UGC
|
||
|
|
STEAM_CALL_RESULT( RemoteStoragePublishFileProgress_t )
|
||
|
|
virtual SteamAPICall_t PublishWorkshopFile( const char *pchFile, const char *pchPreviewFile, AppId_t nConsumerAppId, const char *pchTitle, const char *pchDescription, ERemoteStoragePublishedFileVisibility eVisibility, SteamParamStringArray_t *pTags, EWorkshopFileType eWorkshopFileType ) = 0;
|
||
|
|
virtual PublishedFileUpdateHandle_t CreatePublishedFileUpdateRequest( PublishedFileId_t unPublishedFileId ) = 0;
|
||
|
|
virtual bool UpdatePublishedFileFile( PublishedFileUpdateHandle_t updateHandle, const char *pchFile ) = 0;
|
||
|
|
virtual bool UpdatePublishedFilePreviewFile( PublishedFileUpdateHandle_t updateHandle, const char *pchPreviewFile ) = 0;
|
||
|
|
virtual bool UpdatePublishedFileTitle( PublishedFileUpdateHandle_t updateHandle, const char *pchTitle ) = 0;
|
||
|
|
virtual bool UpdatePublishedFileDescription( PublishedFileUpdateHandle_t updateHandle, const char *pchDescription ) = 0;
|
||
|
|
virtual bool UpdatePublishedFileVisibility( PublishedFileUpdateHandle_t updateHandle, ERemoteStoragePublishedFileVisibility eVisibility ) = 0;
|
||
|
|
virtual bool UpdatePublishedFileTags( PublishedFileUpdateHandle_t updateHandle, SteamParamStringArray_t *pTags ) = 0;
|
||
|
|
STEAM_CALL_RESULT( RemoteStorageUpdatePublishedFileResult_t )
|
||
|
|
virtual SteamAPICall_t CommitPublishedFileUpdate( PublishedFileUpdateHandle_t updateHandle ) = 0;
|
||
|
|
// Gets published file details for the given publishedfileid. If unMaxSecondsOld is greater than 0,
|
||
|
|
// cached data may be returned, depending on how long ago it was cached. A value of 0 will force a refresh.
|
||
|
|
// A value of k_WorkshopForceLoadPublishedFileDetailsFromCache will use cached data if it exists, no matter how old it is.
|
||
|
|
STEAM_CALL_RESULT( RemoteStorageGetPublishedFileDetailsResult_t )
|
||
|
|
virtual SteamAPICall_t GetPublishedFileDetails( PublishedFileId_t unPublishedFileId, uint32 unMaxSecondsOld ) = 0;
|
||
|
|
STEAM_CALL_RESULT( RemoteStorageDeletePublishedFileResult_t )
|
||
|
|
virtual SteamAPICall_t DeletePublishedFile( PublishedFileId_t unPublishedFileId ) = 0;
|
||
|
|
// enumerate the files that the current user published with this app
|
||
|
|
STEAM_CALL_RESULT( RemoteStorageEnumerateUserPublishedFilesResult_t )
|
||
|
|
virtual SteamAPICall_t EnumerateUserPublishedFiles( uint32 unStartIndex ) = 0;
|
||
|
|
STEAM_CALL_RESULT( RemoteStorageSubscribePublishedFileResult_t )
|
||
|
|
virtual SteamAPICall_t SubscribePublishedFile( PublishedFileId_t unPublishedFileId ) = 0;
|
||
|
|
STEAM_CALL_RESULT( RemoteStorageEnumerateUserSubscribedFilesResult_t )
|
||
|
|
virtual SteamAPICall_t EnumerateUserSubscribedFiles( uint32 unStartIndex ) = 0;
|
||
|
|
STEAM_CALL_RESULT( RemoteStorageUnsubscribePublishedFileResult_t )
|
||
|
|
virtual SteamAPICall_t UnsubscribePublishedFile( PublishedFileId_t unPublishedFileId ) = 0;
|
||
|
|
virtual bool UpdatePublishedFileSetChangeDescription( PublishedFileUpdateHandle_t updateHandle, const char *pchChangeDescription ) = 0;
|
||
|
|
STEAM_CALL_RESULT( RemoteStorageGetPublishedItemVoteDetailsResult_t )
|
||
|
|
virtual SteamAPICall_t GetPublishedItemVoteDetails( PublishedFileId_t unPublishedFileId ) = 0;
|
||
|
|
STEAM_CALL_RESULT( RemoteStorageUpdateUserPublishedItemVoteResult_t )
|
||
|
|
virtual SteamAPICall_t UpdateUserPublishedItemVote( PublishedFileId_t unPublishedFileId, bool bVoteUp ) = 0;
|
||
|
|
STEAM_CALL_RESULT( RemoteStorageGetPublishedItemVoteDetailsResult_t )
|
||
|
|
virtual SteamAPICall_t GetUserPublishedItemVoteDetails( PublishedFileId_t unPublishedFileId ) = 0;
|
||
|
|
STEAM_CALL_RESULT( RemoteStorageEnumerateUserPublishedFilesResult_t )
|
||
|
|
virtual SteamAPICall_t EnumerateUserSharedWorkshopFiles( CSteamID steamId, uint32 unStartIndex, SteamParamStringArray_t *pRequiredTags, SteamParamStringArray_t *pExcludedTags ) = 0;
|
||
|
|
STEAM_CALL_RESULT( RemoteStoragePublishFileProgress_t )
|
||
|
|
virtual SteamAPICall_t PublishVideo( EWorkshopVideoProvider eVideoProvider, const char *pchVideoAccount, const char *pchVideoIdentifier, const char *pchPreviewFile, AppId_t nConsumerAppId, const char *pchTitle, const char *pchDescription, ERemoteStoragePublishedFileVisibility eVisibility, SteamParamStringArray_t *pTags ) = 0;
|
||
|
|
STEAM_CALL_RESULT( RemoteStorageSetUserPublishedFileActionResult_t )
|
||
|
|
virtual SteamAPICall_t SetUserPublishedFileAction( PublishedFileId_t unPublishedFileId, EWorkshopFileAction eAction ) = 0;
|
||
|
|
STEAM_CALL_RESULT( RemoteStorageEnumeratePublishedFilesByUserActionResult_t )
|
||
|
|
virtual SteamAPICall_t EnumeratePublishedFilesByUserAction( EWorkshopFileAction eAction, uint32 unStartIndex ) = 0;
|
||
|
|
// this method enumerates the public view of workshop files
|
||
|
|
STEAM_CALL_RESULT( RemoteStorageEnumerateWorkshopFilesResult_t )
|
||
|
|
virtual SteamAPICall_t EnumeratePublishedWorkshopFiles( EWorkshopEnumerationType eEnumerationType, uint32 unStartIndex, uint32 unCount, uint32 unDays, SteamParamStringArray_t *pTags, SteamParamStringArray_t *pUserTags ) = 0;
|
||
|
|
|
||
|
|
STEAM_CALL_RESULT( RemoteStorageDownloadUGCResult_t )
|
||
|
|
virtual SteamAPICall_t UGCDownloadToLocation( UGCHandle_t hContent, const char *pchLocation, uint32 unPriority ) = 0;
|
||
|
|
};
|
||
|
|
|
||
|
|
//-----------------------------------------------------------------------------
|
||
|
|
// Purpose: sent when the local file cache is fully synced with the server for an app
|
||
|
|
// That means that an application can be started and has all latest files
|
||
|
|
//-----------------------------------------------------------------------------
|
||
|
|
struct RemoteStorageAppSyncedClient_t
|
||
|
|
{
|
||
|
|
enum { k_iCallback = k_iClientRemoteStorageCallbacks + 1 };
|
||
|
|
AppId_t m_nAppID;
|
||
|
|
EResult m_eResult;
|
||
|
|
int m_unNumDownloads;
|
||
|
|
};
|
||
|
|
|
||
|
|
//-----------------------------------------------------------------------------
|
||
|
|
// Purpose: sent when the server is fully synced with the local file cache for an app
|
||
|
|
// That means that we can shutdown Steam and our data is stored on the server
|
||
|
|
//-----------------------------------------------------------------------------
|
||
|
|
struct RemoteStorageAppSyncedServer_t
|
||
|
|
{
|
||
|
|
enum { k_iCallback = k_iClientRemoteStorageCallbacks + 2 };
|
||
|
|
AppId_t m_nAppID;
|
||
|
|
EResult m_eResult;
|
||
|
|
int m_unNumUploads;
|
||
|
|
};
|
||
|
|
|
||
|
|
//-----------------------------------------------------------------------------
|
||
|
|
// Purpose: Status of up and downloads during a sync session
|
||
|
|
//
|
||
|
|
//-----------------------------------------------------------------------------
|
||
|
|
struct RemoteStorageAppSyncProgress_t
|
||
|
|
{
|
||
|
|
enum { k_iCallback = k_iClientRemoteStorageCallbacks + 3 };
|
||
|
|
char m_rgchCurrentFile[k_cchFilenameMax]; // Current file being transferred
|
||
|
|
AppId_t m_nAppID; // App this info relates to
|
||
|
|
uint32 m_uBytesTransferredThisChunk; // Bytes transferred this chunk
|
||
|
|
double m_dAppPercentComplete; // Percent complete that this app's transfers are
|
||
|
|
bool m_bUploading; // if false, downloading
|
||
|
|
};
|
||
|
|
|
||
|
|
//
|
||
|
|
// IMPORTANT! k_iClientRemoteStorageCallbacks + 4 is used, see iclientremotestorage.h
|
||
|
|
//
|
||
|
|
|
||
|
|
|
||
|
|
//-----------------------------------------------------------------------------
|
||
|
|
// Purpose: Sent after we've determined the list of files that are out of sync
|
||
|
|
// with the server.
|
||
|
|
//-----------------------------------------------------------------------------
|
||
|
|
struct RemoteStorageAppSyncStatusCheck_t
|
||
|
|
{
|
||
|
|
enum { k_iCallback = k_iClientRemoteStorageCallbacks + 5 };
|
||
|
|
AppId_t m_nAppID;
|
||
|
|
EResult m_eResult;
|
||
|
|
};
|
||
|
|
|
||
|
|
|
||
|
|
#endif // ISTEAMREMOTESTORAGE014_H
|