// Copyright Epic Games, Inc. All Rights Reserved. // This file is automatically generated. Changes to this file may be overwritten. namespace Epic.OnlineServices.PlayerDataStorage { public sealed partial class PlayerDataStorageInterface : Handle { public PlayerDataStorageInterface() { } public PlayerDataStorageInterface(System.IntPtr innerHandle) : base(innerHandle) { } public const int CopyfilemetadataatindexoptionsApiLatest = 1; public const int CopyfilemetadatabyfilenameoptionsApiLatest = 1; /// /// The most recent version of the API. /// public const int DeletecacheoptionsApiLatest = 1; public const int DeletefileoptionsApiLatest = 1; public const int DuplicatefileoptionsApiLatest = 1; /// /// Maximum File size in bytes /// public const int FileMaxSizeBytes = (64 * 1024 * 1024); public const int FilemetadataApiLatest = 3; /// /// Maximum File Name Length in bytes /// public const int FilenameMaxLengthBytes = 64; public const int GetfilemetadatacountoptionsApiLatest = 1; public const int QueryfilelistoptionsApiLatest = 1; public const int QueryfileoptionsApiLatest = 1; public const int ReadfileoptionsApiLatest = 1; public const int WritefileoptionsApiLatest = 1; /// /// Get the cached copy of a file's metadata by index. The metadata will be for the last retrieved or successfully saved version, and will not include any local changes that have not been /// committed by calling SaveFile. The returned pointer must be released by the user when no longer needed. /// /// /// /// Object containing properties related to which user is requesting metadata, and at what index /// A copy of the FileMetadata structure will be set if successful. This data must be released by calling . /// /// if the requested metadata is currently cached, otherwise an error result explaining what went wrong /// public Result CopyFileMetadataAtIndex(ref CopyFileMetadataAtIndexOptions copyFileMetadataOptions, out FileMetadata? outMetadata) { CopyFileMetadataAtIndexOptionsInternal copyFileMetadataOptionsInternal = new CopyFileMetadataAtIndexOptionsInternal(); copyFileMetadataOptionsInternal.Set(ref copyFileMetadataOptions); var outMetadataAddress = System.IntPtr.Zero; var funcResult = Bindings.EOS_PlayerDataStorage_CopyFileMetadataAtIndex(InnerHandle, ref copyFileMetadataOptionsInternal, ref outMetadataAddress); Helper.Dispose(ref copyFileMetadataOptionsInternal); Helper.Get(outMetadataAddress, out outMetadata); if (outMetadata != null) { Bindings.EOS_PlayerDataStorage_FileMetadata_Release(outMetadataAddress); } return funcResult; } /// /// Create the cached copy of a file's metadata by filename. The metadata will be for the last retrieved or successfully saved version, and will not include any changes that have not /// completed writing. The returned pointer must be released by the user when no longer needed. /// /// Object containing properties related to which user is requesting metadata, and for which filename /// A copy of the FileMetadata structure will be set if successful. This data must be released by calling . /// /// if the metadata is currently cached, otherwise an error result explaining what went wrong /// public Result CopyFileMetadataByFilename(ref CopyFileMetadataByFilenameOptions copyFileMetadataOptions, out FileMetadata? outMetadata) { CopyFileMetadataByFilenameOptionsInternal copyFileMetadataOptionsInternal = new CopyFileMetadataByFilenameOptionsInternal(); copyFileMetadataOptionsInternal.Set(ref copyFileMetadataOptions); var outMetadataAddress = System.IntPtr.Zero; var funcResult = Bindings.EOS_PlayerDataStorage_CopyFileMetadataByFilename(InnerHandle, ref copyFileMetadataOptionsInternal, ref outMetadataAddress); Helper.Dispose(ref copyFileMetadataOptionsInternal); Helper.Get(outMetadataAddress, out outMetadata); if (outMetadata != null) { Bindings.EOS_PlayerDataStorage_FileMetadata_Release(outMetadataAddress); } return funcResult; } /// /// Clear previously cached file data. This operation will be done asynchronously. All cached files except those corresponding to the transfers in progress will be removed. /// Warning: Use this with care. Cache system generally tries to clear old and unused cached files from time to time. Unnecessarily clearing cache can degrade performance as SDK will have to re-download data. /// /// Object containing properties related to which user is deleting cache /// Optional pointer to help clients track this request, that is returned in associated callbacks /// This function is called when the delete cache operation completes /// /// if the operation was started correctly, otherwise an error result explaining what went wrong /// public Result DeleteCache(ref DeleteCacheOptions options, object clientData, OnDeleteCacheCompleteCallback completionCallback) { DeleteCacheOptionsInternal optionsInternal = new DeleteCacheOptionsInternal(); optionsInternal.Set(ref options); var clientDataAddress = System.IntPtr.Zero; var completionCallbackInternal = new OnDeleteCacheCompleteCallbackInternal(OnDeleteCacheCompleteCallbackInternalImplementation); Helper.AddCallback(out clientDataAddress, clientData, completionCallback, completionCallbackInternal); var funcResult = Bindings.EOS_PlayerDataStorage_DeleteCache(InnerHandle, ref optionsInternal, clientDataAddress, completionCallbackInternal); Helper.Dispose(ref optionsInternal); return funcResult; } /// /// Deletes an existing file in the cloud. If successful, the file's data will be removed from our local cache. /// /// Object containing properties related to which user is deleting the file, and what file name is /// Optional pointer to help clients track this request, that is returned in the completion callback /// This function is called when the delete operation completes public void DeleteFile(ref DeleteFileOptions deleteOptions, object clientData, OnDeleteFileCompleteCallback completionCallback) { DeleteFileOptionsInternal deleteOptionsInternal = new DeleteFileOptionsInternal(); deleteOptionsInternal.Set(ref deleteOptions); var clientDataAddress = System.IntPtr.Zero; var completionCallbackInternal = new OnDeleteFileCompleteCallbackInternal(OnDeleteFileCompleteCallbackInternalImplementation); Helper.AddCallback(out clientDataAddress, clientData, completionCallback, completionCallbackInternal); Bindings.EOS_PlayerDataStorage_DeleteFile(InnerHandle, ref deleteOptionsInternal, clientDataAddress, completionCallbackInternal); Helper.Dispose(ref deleteOptionsInternal); } /// /// Copies the data of an existing file to a new filename. This action happens entirely on the server and will not upload the contents of the source destination file from the host. This /// function paired with a subsequent can be used to rename a file. If successful, the destination file's metadata will be updated in our local cache. /// /// Object containing properties related to which user is duplicating the file, and what the source and destination file names are /// Optional pointer to help clients track this request, that is returned in the completion callback /// This function is called when the duplicate operation completes public void DuplicateFile(ref DuplicateFileOptions duplicateOptions, object clientData, OnDuplicateFileCompleteCallback completionCallback) { DuplicateFileOptionsInternal duplicateOptionsInternal = new DuplicateFileOptionsInternal(); duplicateOptionsInternal.Set(ref duplicateOptions); var clientDataAddress = System.IntPtr.Zero; var completionCallbackInternal = new OnDuplicateFileCompleteCallbackInternal(OnDuplicateFileCompleteCallbackInternalImplementation); Helper.AddCallback(out clientDataAddress, clientData, completionCallback, completionCallbackInternal); Bindings.EOS_PlayerDataStorage_DuplicateFile(InnerHandle, ref duplicateOptionsInternal, clientDataAddress, completionCallbackInternal); Helper.Dispose(ref duplicateOptionsInternal); } /// /// Get the count of files we have previously queried information for and files we have previously read from / written to. /// /// /// Object containing properties related to which user is requesting the metadata count /// If successful, the count of metadata currently cached /// /// if the input was valid, otherwise an error result explaining what went wrong /// public Result GetFileMetadataCount(ref GetFileMetadataCountOptions getFileMetadataCountOptions, out int outFileMetadataCount) { GetFileMetadataCountOptionsInternal getFileMetadataCountOptionsInternal = new GetFileMetadataCountOptionsInternal(); getFileMetadataCountOptionsInternal.Set(ref getFileMetadataCountOptions); outFileMetadataCount = Helper.GetDefault(); var funcResult = Bindings.EOS_PlayerDataStorage_GetFileMetadataCount(InnerHandle, ref getFileMetadataCountOptionsInternal, ref outFileMetadataCount); Helper.Dispose(ref getFileMetadataCountOptionsInternal); return funcResult; } /// /// Query a specific file's metadata, such as file names, size, and a MD5 hash of the data. This is not required before a file may be opened, saved, copied, or deleted. Once a file has /// been queried, its metadata will be available by the and functions. /// /// /// /// /// Object containing properties related to which user is querying files, and what file is being queried /// Optional pointer to help clients track this request, that is returned in the completion callback /// This function is called when the query operation completes public void QueryFile(ref QueryFileOptions queryFileOptions, object clientData, OnQueryFileCompleteCallback completionCallback) { QueryFileOptionsInternal queryFileOptionsInternal = new QueryFileOptionsInternal(); queryFileOptionsInternal.Set(ref queryFileOptions); var clientDataAddress = System.IntPtr.Zero; var completionCallbackInternal = new OnQueryFileCompleteCallbackInternal(OnQueryFileCompleteCallbackInternalImplementation); Helper.AddCallback(out clientDataAddress, clientData, completionCallback, completionCallbackInternal); Bindings.EOS_PlayerDataStorage_QueryFile(InnerHandle, ref queryFileOptionsInternal, clientDataAddress, completionCallbackInternal); Helper.Dispose(ref queryFileOptionsInternal); } /// /// Query the file metadata, such as file names, size, and a MD5 hash of the data, for all files owned by this user for this application. This is not required before a file may be opened, /// saved, copied, or deleted. /// /// /// /// /// Object containing properties related to which user is querying files /// Optional pointer to help clients track this request, that is returned in the completion callback /// This function is called when the query operation completes public void QueryFileList(ref QueryFileListOptions queryFileListOptions, object clientData, OnQueryFileListCompleteCallback completionCallback) { QueryFileListOptionsInternal queryFileListOptionsInternal = new QueryFileListOptionsInternal(); queryFileListOptionsInternal.Set(ref queryFileListOptions); var clientDataAddress = System.IntPtr.Zero; var completionCallbackInternal = new OnQueryFileListCompleteCallbackInternal(OnQueryFileListCompleteCallbackInternalImplementation); Helper.AddCallback(out clientDataAddress, clientData, completionCallback, completionCallbackInternal); Bindings.EOS_PlayerDataStorage_QueryFileList(InnerHandle, ref queryFileListOptionsInternal, clientDataAddress, completionCallbackInternal); Helper.Dispose(ref queryFileListOptionsInternal); } /// /// Retrieve the contents of a specific file, potentially downloading the contents if we do not have a local copy, from the cloud. This request will occur asynchronously, potentially over /// multiple frames. All callbacks for this function will come from the same thread that the SDK is ticked from. If specified, the FileTransferProgressCallback will always be called at /// least once if the request is started successfully. /// /// /// Object containing properties related to which user is opening the file, what the file's name is, and related mechanisms for copying the data /// Optional pointer to help clients track this request, that is returned in associated callbacks /// This function is called when the read operation completes /// /// A valid Player Data Storage File Request handle if successful, or otherwise. Data contained in the completion callback will have more detailed information about issues with the request in failure cases. This handle must be released when it is no longer needed /// public PlayerDataStorageFileTransferRequest ReadFile(ref ReadFileOptions readOptions, object clientData, OnReadFileCompleteCallback completionCallback) { ReadFileOptionsInternal readOptionsInternal = new ReadFileOptionsInternal(); readOptionsInternal.Set(ref readOptions); var clientDataAddress = System.IntPtr.Zero; var completionCallbackInternal = new OnReadFileCompleteCallbackInternal(OnReadFileCompleteCallbackInternalImplementation); Helper.AddCallback(out clientDataAddress, clientData, completionCallback, completionCallbackInternal, readOptions.ReadFileDataCallback, ReadFileOptionsInternal.ReadFileDataCallback, readOptions.FileTransferProgressCallback, ReadFileOptionsInternal.FileTransferProgressCallback); var funcResult = Bindings.EOS_PlayerDataStorage_ReadFile(InnerHandle, ref readOptionsInternal, clientDataAddress, completionCallbackInternal); Helper.Dispose(ref readOptionsInternal); PlayerDataStorageFileTransferRequest funcResultReturn; Helper.Get(funcResult, out funcResultReturn); return funcResultReturn; } /// /// Write new data to a specific file, potentially overwriting any existing file by the same name, to the cloud. This request will occur asynchronously, potentially over multiple frames. /// All callbacks for this function will come from the same thread that the SDK is ticked from. If specified, the FileTransferProgressCallback will always be called at least once if the /// request is started successfully. /// /// /// Object containing properties related to which user is writing the file, what the file's name is, and related mechanisms for writing the data /// Optional pointer to help clients track this request, that is returned in associated callbacks /// This function is called when the write operation completes /// /// A valid Player Data Storage File Request handle if successful, or otherwise. Data contained in the completion callback will have more detailed information about issues with the request in failure cases. This handle must be released when it is no longer needed /// public PlayerDataStorageFileTransferRequest WriteFile(ref WriteFileOptions writeOptions, object clientData, OnWriteFileCompleteCallback completionCallback) { WriteFileOptionsInternal writeOptionsInternal = new WriteFileOptionsInternal(); writeOptionsInternal.Set(ref writeOptions); var clientDataAddress = System.IntPtr.Zero; var completionCallbackInternal = new OnWriteFileCompleteCallbackInternal(OnWriteFileCompleteCallbackInternalImplementation); Helper.AddCallback(out clientDataAddress, clientData, completionCallback, completionCallbackInternal, writeOptions.WriteFileDataCallback, WriteFileOptionsInternal.WriteFileDataCallback, writeOptions.FileTransferProgressCallback, WriteFileOptionsInternal.FileTransferProgressCallback); var funcResult = Bindings.EOS_PlayerDataStorage_WriteFile(InnerHandle, ref writeOptionsInternal, clientDataAddress, completionCallbackInternal); Helper.Dispose(ref writeOptionsInternal); PlayerDataStorageFileTransferRequest funcResultReturn; Helper.Get(funcResult, out funcResultReturn); return funcResultReturn; } [MonoPInvokeCallback(typeof(OnDeleteCacheCompleteCallbackInternal))] internal static void OnDeleteCacheCompleteCallbackInternalImplementation(ref DeleteCacheCallbackInfoInternal data) { OnDeleteCacheCompleteCallback callback; DeleteCacheCallbackInfo callbackInfo; if (Helper.TryGetAndRemoveCallback(ref data, out callback, out callbackInfo)) { callback(ref callbackInfo); } } [MonoPInvokeCallback(typeof(OnDeleteFileCompleteCallbackInternal))] internal static void OnDeleteFileCompleteCallbackInternalImplementation(ref DeleteFileCallbackInfoInternal data) { OnDeleteFileCompleteCallback callback; DeleteFileCallbackInfo callbackInfo; if (Helper.TryGetAndRemoveCallback(ref data, out callback, out callbackInfo)) { callback(ref callbackInfo); } } [MonoPInvokeCallback(typeof(OnDuplicateFileCompleteCallbackInternal))] internal static void OnDuplicateFileCompleteCallbackInternalImplementation(ref DuplicateFileCallbackInfoInternal data) { OnDuplicateFileCompleteCallback callback; DuplicateFileCallbackInfo callbackInfo; if (Helper.TryGetAndRemoveCallback(ref data, out callback, out callbackInfo)) { callback(ref callbackInfo); } } [MonoPInvokeCallback(typeof(OnFileTransferProgressCallbackInternal))] internal static void OnFileTransferProgressCallbackInternalImplementation(ref FileTransferProgressCallbackInfoInternal data) { OnFileTransferProgressCallback callback; FileTransferProgressCallbackInfo callbackInfo; if (Helper.TryGetStructCallback(ref data, out callback, out callbackInfo)) { FileTransferProgressCallbackInfo dataObj; Helper.Get(ref data, out dataObj); callback(ref dataObj); } } [MonoPInvokeCallback(typeof(OnQueryFileCompleteCallbackInternal))] internal static void OnQueryFileCompleteCallbackInternalImplementation(ref QueryFileCallbackInfoInternal data) { OnQueryFileCompleteCallback callback; QueryFileCallbackInfo callbackInfo; if (Helper.TryGetAndRemoveCallback(ref data, out callback, out callbackInfo)) { callback(ref callbackInfo); } } [MonoPInvokeCallback(typeof(OnQueryFileListCompleteCallbackInternal))] internal static void OnQueryFileListCompleteCallbackInternalImplementation(ref QueryFileListCallbackInfoInternal data) { OnQueryFileListCompleteCallback callback; QueryFileListCallbackInfo callbackInfo; if (Helper.TryGetAndRemoveCallback(ref data, out callback, out callbackInfo)) { callback(ref callbackInfo); } } [MonoPInvokeCallback(typeof(OnReadFileCompleteCallbackInternal))] internal static void OnReadFileCompleteCallbackInternalImplementation(ref ReadFileCallbackInfoInternal data) { OnReadFileCompleteCallback callback; ReadFileCallbackInfo callbackInfo; if (Helper.TryGetAndRemoveCallback(ref data, out callback, out callbackInfo)) { callback(ref callbackInfo); } } [MonoPInvokeCallback(typeof(OnReadFileDataCallbackInternal))] internal static ReadResult OnReadFileDataCallbackInternalImplementation(ref ReadFileDataCallbackInfoInternal data) { OnReadFileDataCallback callback; ReadFileDataCallbackInfo callbackInfo; if (Helper.TryGetStructCallback(ref data, out callback, out callbackInfo)) { ReadFileDataCallbackInfo dataObj; Helper.Get(ref data, out dataObj); var funcResult = callback(ref dataObj); return funcResult; } return Helper.GetDefault(); } [MonoPInvokeCallback(typeof(OnWriteFileCompleteCallbackInternal))] internal static void OnWriteFileCompleteCallbackInternalImplementation(ref WriteFileCallbackInfoInternal data) { OnWriteFileCompleteCallback callback; WriteFileCallbackInfo callbackInfo; if (Helper.TryGetAndRemoveCallback(ref data, out callback, out callbackInfo)) { callback(ref callbackInfo); } } [MonoPInvokeCallback(typeof(OnWriteFileDataCallbackInternal))] internal static WriteResult OnWriteFileDataCallbackInternalImplementation(ref WriteFileDataCallbackInfoInternal data, System.IntPtr outDataBuffer, ref uint outDataWritten) { OnWriteFileDataCallback callback; WriteFileDataCallbackInfo callbackInfo; if (Helper.TryGetStructCallback(ref data, out callback, out callbackInfo)) { WriteFileDataCallbackInfo dataObj; Helper.Get(ref data, out dataObj); System.ArraySegment outDataBufferArray; var funcResult = callback(ref dataObj, out outDataBufferArray); Helper.Get(outDataBufferArray, out outDataWritten); Helper.Copy(outDataBufferArray, outDataBuffer); return funcResult; } return Helper.GetDefault(); } } }