Ark Server API (ASA) - Wiki
Loading...
Searching...
No Matches
IPlatformChunkInstall Class Referenceabstract

#include <GenericPlatformChunkInstall.h>

+ Inheritance diagram for IPlatformChunkInstall:

Public Member Functions

virtual ~IPlatformChunkInstall ()
 
virtual EChunkLocation::Type GetPakchunkLocation (int32 PakchunkIndex)=0
 
virtual bool GetProgressReportingTypeSupported (EChunkProgressReportingType::Type ReportType)=0
 
virtual float GetChunkProgress (uint32 ChunkID, EChunkProgressReportingType::Type ReportType)=0
 
virtual EChunkInstallSpeed::Type GetInstallSpeed ()=0
 
virtual bool SetInstallSpeed (EChunkInstallSpeed::Type InstallSpeed)=0
 
virtual bool PrioritizePakchunk (int32 PakchunkIndex, EChunkPriority::Type Priority)=0
 
virtual bool DebugStartNextChunk ()=0
 
virtual void ExternalNotifyChunkAvailable (uint32 InChunkID)=0
 
virtual FDelegateHandle AddChunkInstallDelegate (FPlatformChunkInstallDelegate Delegate)=0
 
virtual void RemoveChunkInstallDelegate (FDelegateHandle Delegate)=0
 
virtual bool SupportsIntelligentInstall ()=0
 
virtual bool IsChunkInstallationPending (const TArray< FCustomChunk > &ChunkTagsID)=0
 
virtual bool InstallChunks (const TArray< FCustomChunk > &ChunkTagsID)=0
 
virtual bool UninstallChunks (const TArray< FCustomChunk > &ChunkTagsID)=0
 
virtual TArray< FCustomChunkGetCustomChunksByType (ECustomChunkType DesiredChunkType)=0
 
virtual bool SupportsNamedChunkInstall () const =0
 
virtual bool IsNamedChunkInProgress (const FName NamedChunk)=0
 
virtual bool InstallNamedChunk (const FName NamedChunk)=0
 
virtual bool UninstallNamedChunk (const FName NamedChunk)=0
 
virtual bool InstallNamedChunks (const TArrayView< const FName > &NamedChunks)=0
 
virtual bool UninstallNamedChunks (const TArrayView< const FName > &NamedChunks)=0
 
virtual EChunkLocation::Type GetNamedChunkLocation (const FName NamedChunk)=0
 
virtual float GetNamedChunkProgress (const FName NamedChunk, EChunkProgressReportingType::Type ReportType)=0
 
virtual bool PrioritizeNamedChunk (const FName NamedChunk, EChunkPriority::Type Priority)=0
 
virtual ENamedChunkType GetNamedChunkType (const FName NamedChunk) const =0
 
virtual TArray< FNameGetNamedChunksByType (ENamedChunkType NamedChunkType) const =0
 
virtual FDelegateHandle AddNamedChunkInstallDelegate (FPlatformNamedChunkInstallDelegate Delegate)=0
 
virtual void RemoveNamedChunkInstallDelegate (FDelegateHandle Delegate)=0
 

Protected Member Functions

virtual EChunkLocation::Type GetChunkLocation (uint32 ChunkID)=0
 
virtual bool PrioritizeChunk (uint32 ChunkID, EChunkPriority::Type Priority)=0
 

Detailed Description

Interface for platform specific chunk based install

Definition at line 135 of file GenericPlatformChunkInstall.h.

Constructor & Destructor Documentation

◆ ~IPlatformChunkInstall()

virtual IPlatformChunkInstall::~IPlatformChunkInstall ( )
inlinevirtual

Virtual destructor

Definition at line 140 of file GenericPlatformChunkInstall.h.

Member Function Documentation

◆ AddChunkInstallDelegate()

virtual FDelegateHandle IPlatformChunkInstall::AddChunkInstallDelegate ( FPlatformChunkInstallDelegate Delegate)
pure virtual

Request a delegate callback on chunk install completion or failure. Request may not be respected.

Parameters
DelegateThe delegate to call when any chunk is installed or fails to install
Returns
Handle to the bound delegate

Implemented in FGenericPlatformChunkInstall.

◆ AddNamedChunkInstallDelegate()

virtual FDelegateHandle IPlatformChunkInstall::AddNamedChunkInstallDelegate ( FPlatformNamedChunkInstallDelegate Delegate)
pure virtual

Request a delegate callback on named chunk install completion or failure. Request may not be respected.

Parameters
DelegateThe delegate to call when any named chunk is installed or fails to install
Returns
Handle to the bound delegate

Implemented in FGenericPlatformChunkInstall.

◆ DebugStartNextChunk()

virtual bool IPlatformChunkInstall::DebugStartNextChunk ( )
pure virtual

For platforms that support emulation of the Chunk install. Starts transfer of the next chunk. Does nothing in a shipping build.

Returns
true if the operation succeeds.

Implemented in FGenericPlatformChunkInstall.

◆ ExternalNotifyChunkAvailable()

virtual void IPlatformChunkInstall::ExternalNotifyChunkAvailable ( uint32 InChunkID)
pure virtual

Allow an external system to notify that a particular chunk ID has become available Initial use-case is for dynamically encrypted pak files to signal to the outside world that it has become available.

Parameters
InChunkID- ID of the chunk that has just become available

Implemented in FGenericPlatformChunkInstall.

◆ GetChunkLocation()

virtual EChunkLocation::Type IPlatformChunkInstall::GetChunkLocation ( uint32 ChunkID)
protectedpure virtual

Get the current location of a chunk. Pakchunk index and platform chunk id are not always the same. Call GetPakchunkLocation instead of calling from outside.

Parameters
ChunkIDThe id of the chunk to check.
Returns
Enum specifying whether the chunk is available to use, waiting to install, or does not exist.

Implemented in FGenericPlatformChunkInstall.

◆ GetChunkProgress()

virtual float IPlatformChunkInstall::GetChunkProgress ( uint32 ChunkID,
EChunkProgressReportingType::Type ReportType )
pure virtual

Get the current install progress of a chunk. Let the user specify report type for platforms that support more than one.

Parameters
ChunkIDThe id of the chunk to check.
ReportTypeThe type of progress report you want.
Returns
A value whose meaning is dependent on the ReportType param.

Implemented in FGenericPlatformChunkInstall.

◆ GetCustomChunksByType()

virtual TArray< FCustomChunk > IPlatformChunkInstall::GetCustomChunksByType ( ECustomChunkType DesiredChunkType)
pure virtual

◆ GetInstallSpeed()

virtual EChunkInstallSpeed::Type IPlatformChunkInstall::GetInstallSpeed ( )
pure virtual

Inquire about the priority of chunk installation vs. game IO.

Returns
Paused, low or high priority.

Implemented in FGenericPlatformChunkInstall.

◆ GetNamedChunkLocation()

virtual EChunkLocation::Type IPlatformChunkInstall::GetNamedChunkLocation ( const FName NamedChunk)
pure virtual

Get the current location of the given named chunk

Parameters
NamedChunkThe name of the chunk
Returns
Enum specifying whether the chunk is available to use, waiting to install, or does not exist.

Implemented in FGenericPlatformChunkInstall.

◆ GetNamedChunkProgress()

virtual float IPlatformChunkInstall::GetNamedChunkProgress ( const FName NamedChunk,
EChunkProgressReportingType::Type ReportType )
pure virtual

Get the current install progress of the given named chunk. Let the user specify report type for platforms that support more than one.

Parameters
NamedChunkThe name of the chunk
ReportTypeThe type of progress report you want.
Returns
A value whose meaning is dependent on the ReportType param.

Implemented in FGenericPlatformChunkInstall.

◆ GetNamedChunksByType()

virtual TArray< FName > IPlatformChunkInstall::GetNamedChunksByType ( ENamedChunkType NamedChunkType) const
pure virtual

Get a list of all the named chunks of the given type

Parameters
Enumindicating the type of chunk
Returns
Array containing all named chunks of the given type

Implemented in FGenericPlatformChunkInstall.

◆ GetNamedChunkType()

virtual ENamedChunkType IPlatformChunkInstall::GetNamedChunkType ( const FName NamedChunk) const
pure virtual

Query the type of the given named chunk

Parameters
NamedChunkThe name of the chunk
Returns
Enum indicating the type of chunk, if any

Implemented in FGenericPlatformChunkInstall.

◆ GetPakchunkLocation()

virtual EChunkLocation::Type IPlatformChunkInstall::GetPakchunkLocation ( int32 PakchunkIndex)
pure virtual

Get the current location of a chunk with pakchunk index.

Parameters
PakchunkIndexThe id of the pak chunk.
Returns
Enum specifying whether the chunk is available to use, waiting to install, or does not exist.

Implemented in FGenericPlatformChunkInstall.

◆ GetProgressReportingTypeSupported()

virtual bool IPlatformChunkInstall::GetProgressReportingTypeSupported ( EChunkProgressReportingType::Type ReportType)
pure virtual

Check if a given reporting type is supported.

Parameters
ReportTypeEnum specifying how progress is reported.
Returns
true if reporting type is supported on the current platform.

Implemented in FGenericPlatformChunkInstall.

◆ InstallChunks()

virtual bool IPlatformChunkInstall::InstallChunks ( const TArray< FCustomChunk > & ChunkTagsID)
pure virtual

◆ InstallNamedChunk()

virtual bool IPlatformChunkInstall::InstallNamedChunk ( const FName NamedChunk)
pure virtual

Install the given named chunk

Parameters
NamedChunkThe name of the chunk
Returns
whether installation task has been kicked

Implemented in FGenericPlatformChunkInstall.

◆ InstallNamedChunks()

virtual bool IPlatformChunkInstall::InstallNamedChunks ( const TArrayView< const FName > & NamedChunks)
pure virtual

Install the given set of named chunks

Parameters
NamedChunksThe names of the chunks to install
Returns
whether installation task has been kicked

Implemented in FGenericPlatformChunkInstall.

◆ IsChunkInstallationPending()

virtual bool IPlatformChunkInstall::IsChunkInstallationPending ( const TArray< FCustomChunk > & ChunkTagsID)
pure virtual

◆ IsNamedChunkInProgress()

virtual bool IPlatformChunkInstall::IsNamedChunkInProgress ( const FName NamedChunk)
pure virtual

Check whether the give chunk is being installed

Parameters
NamedChunkThe name of the chunk
Returns
whether installation task has been kicked

Implemented in FGenericPlatformChunkInstall.

◆ PrioritizeChunk()

virtual bool IPlatformChunkInstall::PrioritizeChunk ( uint32 ChunkID,
EChunkPriority::Type Priority )
protectedpure virtual

Hint to the installer that we would like to prioritize a specific chunk

Parameters
ChunkIDThe id of the chunk to prioritize.
PriorityThe priority for the chunk.
Returns
false if the operation is not allowed or the chunk doesn't exist, otherwise true.

Implemented in FGenericPlatformChunkInstall.

◆ PrioritizeNamedChunk()

virtual bool IPlatformChunkInstall::PrioritizeNamedChunk ( const FName NamedChunk,
EChunkPriority::Type Priority )
pure virtual

Hint to the installer that we would like to prioritize a specific chunk

Parameters
NamedChunkThe name of the chunk
PriorityThe priority for the chunk.
Returns
false if the operation is not allowed or the chunk doesn't exist, otherwise true.

Implemented in FGenericPlatformChunkInstall.

◆ PrioritizePakchunk()

virtual bool IPlatformChunkInstall::PrioritizePakchunk ( int32 PakchunkIndex,
EChunkPriority::Type Priority )
pure virtual

Hint to the installer that we would like to prioritize a specific chunk

Parameters
PakchunkIndexThe index of the pakchunk to prioritize.
PriorityThe priority for the chunk.
Returns
false if the operation is not allowed or the chunk doesn't exist, otherwise true.

Implemented in FGenericPlatformChunkInstall.

◆ RemoveChunkInstallDelegate()

virtual void IPlatformChunkInstall::RemoveChunkInstallDelegate ( FDelegateHandle Delegate)
pure virtual

Remove a delegate callback on chunk install completion.

Parameters
DelegateThe delegate to remove.

Implemented in FGenericPlatformChunkInstall.

◆ RemoveNamedChunkInstallDelegate()

virtual void IPlatformChunkInstall::RemoveNamedChunkInstallDelegate ( FDelegateHandle Delegate)
pure virtual

Remove a delegate callback on named chunk install completion.

Parameters
DelegateThe delegate to remove.

Implemented in FGenericPlatformChunkInstall.

◆ SetInstallSpeed()

virtual bool IPlatformChunkInstall::SetInstallSpeed ( EChunkInstallSpeed::Type InstallSpeed)
pure virtual

Specify the priority of chunk installation vs. game IO.

Parameters
InstallSpeedPause, low or high priority.
Returns
false if the operation is not allowed, otherwise true.

Implemented in FGenericPlatformChunkInstall.

◆ SupportsIntelligentInstall()

virtual bool IPlatformChunkInstall::SupportsIntelligentInstall ( )
pure virtual

◆ SupportsNamedChunkInstall()

virtual bool IPlatformChunkInstall::SupportsNamedChunkInstall ( ) const
pure virtual

Check whether current platform supports chunk installation by name

Returns
whether Intelligent Install is supported

Implemented in FGenericPlatformChunkInstall.

◆ UninstallChunks()

virtual bool IPlatformChunkInstall::UninstallChunks ( const TArray< FCustomChunk > & ChunkTagsID)
pure virtual

◆ UninstallNamedChunk()

virtual bool IPlatformChunkInstall::UninstallNamedChunk ( const FName NamedChunk)
pure virtual

Uninstall the given named chunk

Parameters
NamedChunkThe name of the chunk
Returns
whether uninstallation task has been kicked

Implemented in FGenericPlatformChunkInstall.

◆ UninstallNamedChunks()

virtual bool IPlatformChunkInstall::UninstallNamedChunks ( const TArrayView< const FName > & NamedChunks)
pure virtual

Uninstall the given set of named chunks

Parameters
NamedChunkThe names of the chunks to uninstall
Returns
whether uninstallation task has been kicked

Implemented in FGenericPlatformChunkInstall.


The documentation for this class was generated from the following file: