mgl_leaderboard_server.h

[詳解]

// SPDX-License-Identifier: Zlib
/* ------------------------------------------------------------------------- */
/* ------------------------------------------------------------------------- */
 
#ifndef INCGUARD_MGL_LEADERBOARD_SERVER_H_1630686448
#define INCGUARD_MGL_LEADERBOARD_SERVER_H_1630686448
 
#include <mgl/common/mgl_singleton.h>
#include <mgl/event/mgl_event.h>
#include <mgl/leaderboard/mgl_leaderboard_server_delegate.h>
#include <mgl/stl/mgl_stl_memory.h>
 
namespace MGL::Leaderboard
{
class Server final : public MGL::SharedSingleton<Server>
{
public:
    enum class State : uint8_t
    {
        NotReady,            
        Ready,               
        FetchEntryData,      
        ReportScore,         
        UploadClipData,      
        DownloadClipData,    
    };
 
    static STL::unique_ptr<Server> &GetInstanceRef() noexcept;
 
    Server() noexcept;
 
    bool Initialize(STL::unique_ptr<ServerDelegate> &delegate) noexcept;
 
    bool ReportScore(Identifier identifier, uint64_t score, const OptionDataArray &options) noexcept;
    bool FetchEntryData(Identifier identifier, uint32_t startRank, uint32_t requestSize, PlayerScope playerScope) noexcept;
    bool FetchEntryDataAroundUser(Identifier identifier, uint32_t requestSize, PlayerScope playerScope) noexcept;
    bool UploadClipData(Identifier identifier, const ClipData &clipData) noexcept;
    bool DownloadClipData(uint64_t clipID) noexcept;
 
    /* ------------------------------------------------------------------------- */
    /* ------------------------------------------------------------------------- */
    [[nodiscard]] const FetchResults &GetFetchedData() const noexcept
    {
        return _delegate->GetFetchedData();
    }
 
    /* ------------------------------------------------------------------------- */
    /* ------------------------------------------------------------------------- */
    [[nodiscard]] const ReportResults &GetReportResults() const noexcept
    {
        return _delegate->GetReportResults();
    }
 
    /* ------------------------------------------------------------------------- */
    /* ------------------------------------------------------------------------- */
    [[nodiscard]] const ClipData &GetClipData() const noexcept
    {
        return _delegate->GetClipData();
    }
 
    /* ------------------------------------------------------------------------- */
    /* ------------------------------------------------------------------------- */
    [[nodiscard]] ClipData::ErrorType GetClipDataUploadResults() const noexcept
    {
        return _delegate->GetClipDataUploadResults();
    }
 
    /* ------------------------------------------------------------------------- */
    /* ------------------------------------------------------------------------- */
    [[nodiscard]] constexpr bool IsProcessing() const noexcept
    {
        return _state != State::Ready;
    }
 
    /* ------------------------------------------------------------------------- */
    /* ------------------------------------------------------------------------- */
    [[nodiscard]] constexpr State GetState() const noexcept
    {
        return _state;
    }
 
private:
    static void OnPreFrameUpdate(void *callbackArg, void *notifyArg) noexcept;
 
    STL::unique_ptr<ServerDelegate> _delegate;
    State _state{State::Ready};
 
    Event::Handle _eventPreFrameUpdate;
};
}    // namespace MGL::Leaderboard
 
#endif    // INCGUARD_MGL_LEADERBOARD_SERVER_H_1630686448
 
// vim: et ts=4 sw=4 sts=4