v4_api_reference/CPP/_h_i_v_e___match_making_8h_source.html

//

//  HIVE_MatchMaking.hpp

//  HIVE_SDK_Plugin

//

//  Created by jschoi on 2024/09/26.

//


#ifndef __HIVE_MATCH_MAKING_H__

#define  __HIVE_MATCH_MAKING_H__


#include "HIVE_AuthV4.h"        //  hive::PlayerID

#include "HIVE_ResultAPI.h"

#include <map>


NS_HIVE_BEGIN


typedef long long PlayerID;


class ResultAPI;


class MatchMakingData;

class MatchMakingGroupData;

class MatchingMemberInfo;

class MatchingResultPlayerInfo;

class MatchingResultTeamInfo;


class HIVESDK_DLLEXPORT MatchMaking

{

public:


    typedef std::function<void(ResultAPI const & result)> onMatchMakingResult;


    typedef std::function<void(ResultAPI const & result, MatchMakingData const & matchMakingData)> onMatchMakingData;


    typedef std::function<void(ResultAPI const & result, MatchMakingGroupData const & matchMakingGroupData)> onMatchMakingGroupData;


    static void requestMatchMaking(int matchId, int point, const char * extraData, onMatchMakingData listener);


    static void getRequestingStatus(int matchId, onMatchMakingData listener);


    static void deleteRequesting(int matchId, onMatchMakingResult listener);


    static void createGroup(int matchId, int point, const char * extraData, onMatchMakingGroupData listener);


    static void joinGroup(int matchId, const char * groupCode, int point, const char * extraData, onMatchMakingGroupData listener);


    static void leaveGroup(int matchId, onMatchMakingResult listener);


    static void kickGroupUser(int matchId, PlayerID targetPlayerId, onMatchMakingGroupData listener);


    static void getGroupInfoByUser(int matchId, onMatchMakingGroupData listener);


    static void getGroupInfoByGroupCode(const char * groupCode, onMatchMakingGroupData listener);


    static void updateGroupUser(int matchId, bool ready, int point, const char * extraData, onMatchMakingGroupData listener);


    static void requestGroupMatching(int matchId, onMatchMakingGroupData listener);


    static void deleteGroupMatching(int matchId, onMatchMakingGroupData listener);


    // \~korean Native 영역에서 호출된 요청을 처리하기 위한 플러그인 내부 코드

    // \~english Plug-in internal code to handle requests invoked from the native code.

    static void executeEngine(picojson::value jsonParam);


};


class HIVESDK_DLLEXPORT MatchingMemberInfo {

public:

    // 플레이어 ID / Player ID

    hive::PlayerID playerId;

    // 준비 상태 (빈값인 경우 false) / Ready Status (false if empty)

    bool ready;

    // 매칭 포인트 / Matching Point

    int point;

    // 추가 데이터 (선택사항) / Extra Data (nickName, Level, Etc..)

    std::string extraData;


    MatchingMemberInfo();


    bool parse(picojson::value jsonParam);

    picojson::object toJson() const;

    std::string toString() const;

};


class HIVESDK_DLLEXPORT MatchMakingGroupData {

public:

    // 그룹 코드 / Group Code

    std::string groupCode;

    // 그룹 소유자 플레이어 ID / Group Owner Player ID

    hive::PlayerID ownerPlayerId;


    // 매칭 멤버 정보 리스트 / Matching Member Information List

    std::vector<MatchingMemberInfo> memberInfoList;


    // 게임인덱스 / Game Index

    int requestGameIndex;

    // 매치 ID / Match ID

    int requestMatchId;


    // 매칭 요청 상태 / Matching Request Status

    std::string requestStatus;

    // 요청 시각 (UTC) String / Request Time (UTC) String

    std::string requestTimeUtc;


    // 매칭 상태 / Matching Status

    std::string matchingStatus;

    // 매칭 ID / Matching ID

    std::string matchingId;

    // 매칭 타입 / Matching Type

    std::string matchingType;


    // 매칭 팀 정보 리스트 / Matching Team Information List

    std::vector<MatchingResultTeamInfo> matchingTeamInfoList;


    MatchMakingGroupData();


    bool parse(picojson::value jsonParam);

    picojson::object toJson() const;

    std::string toString() const;

};


class HIVESDK_DLLEXPORT MatchMakingData {

public:

    hive::PlayerID requestPlayerId;

    int requestGameIndex;

    int requestMatchId;


    std::string requestStatus;

    std::string requestTimeUtc;

    int requestPoint;

    std::string requestExtraData;


    std::string matchingStatus;

    std::string matchingId;

    std::string matchingType;


    std::vector<MatchingResultPlayerInfo> matchingPlayerInfoList;

    std::vector<MatchingResultTeamInfo> matchingTeamInfoList;


    MatchMakingData();


    bool parse(picojson::value jsonParam);

    picojson::object toJson() const;

    std::string toString() const;

};


class HIVESDK_DLLEXPORT MatchingResultPlayerInfo {

public:

    hive::PlayerID playerId;

    int point;

    std::string extraData;


    MatchingResultPlayerInfo();


    bool parse(picojson::value jsonParam);

    picojson::object toJson() const;

    std::string toString() const;

};


class HIVESDK_DLLEXPORT MatchingResultTeamInfo {

public:

    int teamIndex;

    std::vector<MatchingResultPlayerInfo> playerInfos;


    MatchingResultTeamInfo();


    bool parse(picojson::value jsonParam);

    picojson::object toJson() const;

    std::string toString() const;

};


// MARK: -

NS_HIVE_END        // namespace hive


#endif        // __HIVE_MATCH_MAKING_H__


HIVE_AuthV4.h

HIVE_ResultAPI.h

MatchMakingData
Match Making 콜백 데이터 정보
Definition: HIVE_MatchMaking.h:342

MatchMakingGroupData
매치 메이킹 그룹 데이터 정보
Definition: HIVE_MatchMaking.h:299

MatchMaking
Hive MatchMaking은 온라인 매치를 위해 플레이어를 연결하고 관련 데이터를 제공합니다.
Definition: HIVE_MatchMaking.h:45

MatchMaking::getGroupInfoByUser
static void getGroupInfoByUser(int matchId, onMatchMakingGroupData listener)
그룹 정보 조회 (그룹 내 유저 기준)

MatchMaking::getGroupInfoByGroupCode
static void getGroupInfoByGroupCode(const char *groupCode, onMatchMakingGroupData listener)
그룹 정보 조회 (그룹 코드 기준)

MatchMaking::requestGroupMatching
static void requestGroupMatching(int matchId, onMatchMakingGroupData listener)
그룹 매칭 요청

MatchMaking::createGroup
static void createGroup(int matchId, int point, const char *extraData, onMatchMakingGroupData listener)
매칭 그룹 생성

MatchMaking::getRequestingStatus
static void getRequestingStatus(int matchId, onMatchMakingData listener)
매칭 상태 확인

MatchMaking::kickGroupUser
static void kickGroupUser(int matchId, PlayerID targetPlayerId, onMatchMakingGroupData listener)
그룹원 추방

MatchMaking::requestMatchMaking
static void requestMatchMaking(int matchId, int point, const char *extraData, onMatchMakingData listener)
매칭 요청

MatchMaking::deleteRequesting
static void deleteRequesting(int matchId, onMatchMakingResult listener)
매칭 요청 삭제

MatchMaking::joinGroup
static void joinGroup(int matchId, const char *groupCode, int point, const char *extraData, onMatchMakingGroupData listener)
매칭 그룹 참여

MatchMaking::leaveGroup
static void leaveGroup(int matchId, onMatchMakingResult listener)
매칭 그룹 탈퇴

MatchMaking::updateGroupUser
static void updateGroupUser(int matchId, bool ready, int point, const char *extraData, onMatchMakingGroupData listener)
멤버 정보 수정

MatchMaking::deleteGroupMatching
static void deleteGroupMatching(int matchId, onMatchMakingGroupData listener)
그룹 매칭 요청 취소

MatchingMemberInfo
매치 메이킹 그룹 멤버 정보
Definition: HIVE_MatchMaking.h:276

ResultAPI
Definition: HIVE_ResultAPI.h:64