|
// Fill out your copyright notice in the Description page of Project Settings.
|
|
|
|
#pragma once
|
|
|
|
#include "Http.h"
|
|
#include "FileDownloader.generated.h"
|
|
|
|
/**
|
|
* Possible results from a download request.
|
|
*/
|
|
UENUM(BlueprintType, Category = "HTTP")
|
|
enum class EDownloadResult : uint8
|
|
{
|
|
Success,
|
|
DownloadFailed,
|
|
SaveFailed,
|
|
DirectoryCreationFailed
|
|
};
|
|
DECLARE_DYNAMIC_MULTICAST_DELEGATE_OneParam(FOnResult, const EDownloadResult, Result);
|
|
DECLARE_DYNAMIC_MULTICAST_DELEGATE_ThreeParams(FOnProgress, const int32, BytesSent, const int32, BytesReceived, const int32, ContentLength);
|
|
|
|
/**
|
|
* Download a file from a URL and save it locally.
|
|
*/
|
|
UCLASS(BlueprintType, Category = "HTTP")
|
|
class MEDIOCREMAPPER_API UFileDownloader : public UObject
|
|
{
|
|
GENERATED_BODY()
|
|
|
|
public:
|
|
/**
|
|
* Bind to know when the download is complete (even if it fails).
|
|
*/
|
|
UPROPERTY(BlueprintAssignable, Category = "HTTP")
|
|
FOnResult OnResult;
|
|
/**
|
|
* Bind to know when the download is complete (even if it fails).
|
|
*/
|
|
UPROPERTY(BlueprintAssignable, Category = "HTTP")
|
|
FOnProgress OnProgress;
|
|
|
|
/**
|
|
* The URL used to start this download.
|
|
*/
|
|
UPROPERTY(BlueprintReadOnly, Category = "HTTP")
|
|
FString FileUrl;
|
|
/**
|
|
* The path set to save the downloaded file.
|
|
*/
|
|
UPROPERTY(BlueprintReadOnly, Category = "HTTP")
|
|
FString FileSavePath;
|
|
|
|
UFileDownloader();
|
|
~UFileDownloader();
|
|
|
|
/**
|
|
* Instantiates a FileDownloader object, starts downloading and saves it when done.
|
|
*
|
|
* @return The FileDownloader object. Bind to it's OnResult event to know when it's done downloading.
|
|
*/
|
|
UFUNCTION(BlueprintCallable, Meta = (DisplayName = "Create Downloader"), Category = "HTTP")
|
|
static UFileDownloader* MakeDownloader();
|
|
|
|
/**
|
|
* Starts downloading a file and saves it when done. Bind to the OnResult
|
|
* event to know when the download is done (preferrably, before calling this function).
|
|
*
|
|
* @param Url The file Url to be downloaded.
|
|
* @param SavePath The absolute path and file name to save the downloaded file.
|
|
* @return Returns itself.
|
|
*/
|
|
UFUNCTION(BlueprintCallable, Category = "HTTP")
|
|
UFileDownloader* DownloadFile(const FString& Url, FString SavePath);
|
|
|
|
private:
|
|
|
|
void OnReady(FHttpRequestPtr Request, FHttpResponsePtr Response, bool bWasSuccessful);
|
|
void OnProgress_Internal(FHttpRequestPtr Request, int32 BytesSent, int32 BytesReceived);
|
|
};
|