This document is about: QUANTUM 2

SWITCH TO

QUANTUM 1 QUANTUM 2 QUANTUM 3

API-Tournament

Available in the Gaming Circle and Industries Circle

Namespace: Gimmebreak.Backbone.Tournaments

Inheritance: Object → Tournament

필요한 모든 정보를 보유한 토너먼트의 특정 인스턴스를 나타냅니다. 토너먼트 데이터를 로드하려면 백본 클라이언트에서 LoadTournamentList() 또는 LoadTournament()를 호출합니다. 모든 토너먼트 인스턴스는 client.Tournaments.TournamentList에서 찾을 수 있습니다.

public class Tournament

생성자

`Tournament()`

토너먼트의 인스턴스를 생성합니다.

public Tournament()

속성

`AdditionalDescription`

이 토너먼트에 대한 추가 설명이 있으면 가져옵니다.

public string AdditionalDescription
{
    get;
    set;
}

`AllMatches`

모든 단계의 모든 토너먼트 경기가 매치됩니다. 이 필드는 백본 클라이언트에서 LoadTournamentMatches() 또는 LoadTournamentMatchesAll() 호출로 채울 수 있습니다.

public List<TournamentMatch> AllMatches
{
    get;
    set;
}

`CurrentInvites`

토너먼트의 현재 활성 초대/등록을 결정합니다. 토너먼트가 파티/팀으로 설정된 경우에도 항상 단일 사용자를 나타냅니다.

public int CurrentInvites
{
    get;
    set;
}

`CurrentPhaseId`

현재 활성 단계 Id를 확인합니다(id=0인 경우 토너먼트가 아직 시작되지 않았으며, 항상 첫 번째 단계가 id=1로 시작됩니다).

public int CurrentPhaseId
{
    get;
    set;
}

`CurrentPhaseStarted`

현재 단계가 언제 시작되었는지 확인합니다. UTC 날짜 시간입니다.

public DateTime CurrentPhaseStarted
{
    get;
    set;
}

`CustomProperties`

토너먼트 사용자 지정 속성을 얻습니다. (예. 게임 모드, 허용된 능력, 허용된 맵 등)

public TournamentCustomProperties CustomProperties
{
    get;
    set;
}

`Description`

토너먼트의 설명이 있다면 가져옵니다.

public string Description
{
    get;
    set;
}

`EntryFee`

이 토너먼트의 참가비를 결정합니다. 토너먼트에 참가비가 설정되지 않았더라도 이는 무효가 아닙니다. 하지만 EntryFee.Items가 비게 됩니다.

public TournamentEntryFee EntryFee
{
    get;
    set;
}

`HasAllDataLoaded`

모든 토너먼트 데이터가 로드되었는지 확인합니다.

public bool HasAllDataLoaded
{
    get;
    set;
}

설명

토너먼트가 백본 클라이언트에서 LoadTournamentList() 호출로만 로드된 경우 이 설정은 false로 설정됩니다. 이것은 토너먼트가 백본 클라이언트에서 LoadTournament() 호출로 로드된 경우 true로 설정됩니다.(있는 경우)

`HighlightsUrl`

토너먼트의 하이라이트 URL이 있는 경우 가져옵니다.

public string HighlightsUrl
{
    get;
    set;
}

`IconUrl`

이 토너먼트의 아이콘 URL이 있는 경우 가져옵니다.

public string IconUrl
{
    get;
    set;
}

`Id`

Tournament 유일 id.

public long Id
{
    get;
    set;
}

`ImageUrl`

이 토너먼트의 이미지 URL이 있는 경우 가져옵니다.

public string ImageUrl
{
    get;
    set;
}

`InvitationCloseTime`

초대가 언제 닫히는지 확인합니다. 이 시점 이후에는 누구도 등록하거나 로그아웃할 수 없습니다. UTC 날짜 시간입니다.

public DateTime InvitationCloseTime
{
    get;
    set;
}

`InvitationOpenTime`

초대가 언제 오픈하는지 확인합니다. UTC 날짜 시간입니다.

public DateTime InvitationOpenTime
{
    get;
    set;
}

설명

초대가 열리면 직접 초대가 있는 사용자만 등록할 수 있습니다. 직접 초대장은 이전 대회의 우승자 또는 관리 화면에 설정된 특정 사용자를 나타낼 수 있습니다. 즉, 공개 등록이 시작되기 전에 해당 사용자에게 등록 시간 우선순위를 부여할 수 있습니다.

`Invite`

토너먼트 초대/티켓을 얻습니다. 사용자가 토너먼트에 초대된 경우 티켓은 사용할 수 있지만 확인되지 않습니다. 사용자가 자동으로 초대되거나 토너먼트에 등록되지 않은 경우 이 속성은 null이 됩니다.

public TournamentInvite Invite
{
    get;
    set;
}

`IsAdministrator`

사용자가 이 토너먼트의 관리자인지 확인합니다. 관리자는 매치를 볼 때 경기에 비밀리에 접근하여 관람자로 참여할 수 있습니다.

public bool IsAdministrator
{
    get;
    set;
}

`IsInvitationOnly`

토너먼트가 초대된 사용자만을 위한 것인지 확인합니다. true로 설정하면 RegistrationOpenTime에 유효한 값이 포함되어 있지 않으므로 사용할 수 없습니다.

public bool IsInvitationOnly
{
    get;
    set;
}

`LastMatchRoundId`

사용자가 플레이한 매치의 마지막 라운드 ID를 확인합니다.

public int LastMatchRoundId
{
    get;
    set;
}

`LastUpdate`

마지막 토너먼트 데이터 업데이트를 확인합니다.

public DateTime LastUpdate
{
    get;
    set;
}

`MaxInvites`

토너먼트의 최대 초대/등록 수를 결정합니다. 토너먼트가 파티/팀으로 설정된 경우에도 항상 단일 사용자를 나타냅니다.

public int MaxInvites
{
    get;
    set;
}

`NextPhase`

다음 단계가 시작되는 시간을 결정합니다. UTC 날짜 시간입니다.

public DateTime NextPhase
{
    get;
    set;
}

설명

모든 매치가 현재 단계에서 진행되면 토너먼트가 다음 단계로 더 빨리 진행되어 사용자가 불필요한 대기 상태를 방지할 수 있습니다.

`Party`

사용자 파티를 가져옵니다(1v1에 있더라도 사인업 사용자는 항상 파티에 있습니다). 이 속성은 사용자가 토너먼트에 등록할 때까지 null입니다.

public TournamentParty Party
{
    get;
    set;
}

설명

가입한 사용자는 항상 파티에 있습니다. 사용자가 파티를 탈퇴하면 자동으로 새 파티가 할당됩니다.

`PartySize`

토너먼트에 필요한 파티 규모를 결정합니다(예: 1v1, 2v2, 3v3 등).

public int PartySize
{
    get;
    set;
}

`PhaseCount`

토너먼트의 단계 수를 결정합니다(항상 하나 이상).

public int PhaseCount
{
    get;
    set;
}

`Phases`

모든 토너먼트 단계 목록입니다. 토너먼트에는 항상 하나 이상의 단계가 있습니다(PhaseId = 1).

public List<TournamentPhase> Phases
{
    get;
    set;
}

`PolicyURL`

이 토너먼트의 정책 URL이 있는 경우 가져옵니다.

public string PolicyURL
{
    get;
    set;
}

`Prizes`

토너먼트 경품 목록입니다.

public List<TournamentPrize> Prizes
{
    get;
    set;
}

`RegistrationOpenTime`

등록이 열리는 시기를 결정합니다. 이 속성은 IsInvitationOnly가 false로 설정된 경우에만 설정됩니다. UTC 날짜 시간입니다.

public DateTime RegistrationOpenTime
{
    get;
    set;
}

설명

등록이 열리면 모든 사용자가 등록할 수 있습니다.

`ReplayExpires`

리플레이 URL이 만료되는 시기를 결정합니다(트위치 14일 후). UTC 날짜 시간입니다.

public DateTime ReplayExpires
{
    get;
    set;
}

`ReplayUrl`

토너먼트의 리플레이 URL이 있는 경우 가져옵니다(예: 트위치 VOD).

public string ReplayUrl
{
    get;
    set;
}

`Requirements`

등록을 위한 토너먼트 요건을 결정합니다. 토너먼트에 사용자 지정 요구 사항이 설정되지 않았더라도 요구 사항은 null이 아니며 Requirements.CustomRequirements는 비어 있습니다.

public TournamentRequirements Requirements
{
    get;
    set;
}

`RoundCount`

토너먼트에서 총 라운드 수를 결정합니다(항상 1회 이상).

public int RoundCount
{
    get;
    set;
}

`Season`

어떤 시즌 토너먼트가 만들어질지 결정합니다.

public int Season
{
    get;
    set;
}

`SeasonPart`

어떤 시즌 파트 토너먼트가 만들어질지 결정합니다.

public int SeasonPart
{
    get;
    set;
}

`SponsorImageUrl`

스폰서 이미지를 가져옵니다.

public string SponsorImageUrl
{
    get;
    set;
}

`SponsorName`

스폰서 이름을 가져옵니다.

public string SponsorName
{
    get;
    set;
}

`Status`

토너먼트의 현재 상태(예: 초대 열기, 종료됨 등) 자세한 상태를 보려면 토너먼트를 토너먼트 허브와 연결해야 합니다.

public TournamentStatus Status
{
    get;
    set;
}

`StreamUrl`

토너먼트 스트림 URL이 있는 경우 가져옵니다.

public string StreamUrl
{
    get;
    set;
}

`ThemeColor`

토너먼트 테마 색상이 있는 경우 가져옵니다.

public string ThemeColor
{
    get;
    set;
}

`Time`

토너먼트의 시작 시간을 결정합니다. UTC 시간입니다.

public DateTime Time
{
    get;
    set;
}

`TournamentName`

토너먼트의 공식 이름.

public string TournamentName
{
    get;
    set;
}

`Type`

토너먼트 유형을 결정합니다(예: 공개, 비공개, 테스트). 일부 토너먼트 유형은 특정 사용자만 볼 수 있습니다.

public TournamentType Type
{
    get;
    set;
}

`UserActiveMatch`

가입해야 하는 사용자에 대해 현재 활성 매치입니다. 이는 토너먼트에 등록한 사용자에게만 적용됩니다.

public TournamentMatch UserActiveMatch
{
    get;
    set;
}

설명

이 속성은 사용자가 토너먼트 허브에 연결할 때 자동으로 설정됩니다. 경우에 따라서는 토너먼트 허브로부터 토너먼트 경기가 배정되기 전에 사용자가 준비가 되었는지 명시적으로 확인하라는 메시지가 표시됩니다.

`UserMatches`

모든 단계에서 모든 사용자 매치.

public List<TournamentMatch> UserMatches
{
    get;
    set;
}

설명

사용자가 특정 라운드를 제시간에 시작하지 못하고 일부 라운드 매치를 완전히 건너뛴 경우(자동 패배) 해당 매치는 이 목록에 없습니다. 토너먼트 단계 개체의 UserPlayedRoundCount 속성을 사용하여 사용자가 실제로 일치 항목을 놓쳤는지 확인합니다.

`Winner`

기본 토너먼트 우승자 데이터를 가져옵니다. 여기에는 첫 번째 위치에서 완료된 모든 파티의 모든 사용자 목록이 포함됩니다.

public TournamentWinner Winner
{
    get;
    set;
}

설명

토너먼트의 마지막 단계에 그룹이 있을 경우, 그룹 내에서 최종 순위가 계산되므로 토너먼트에 여러 명의 우승자가 있을 수 있습니다.

Methods

`GetCurrentTournamentPhase()`

현재 토너먼트 단계를 가져옵니다.

public Gimmebreak.Backbone.Tournaments.TournamentPhase GetCurrentTournamentPhase()

리턴

토너먼트 단계이거나 토너먼트가 아직 시작되지 않은 경우 null입니다. 종료된 토너먼트는 항상 마지막 단계를 리턴합니다.

`GetMatchMinGameLength(TournamentMatch)`

게임을 플레이하는 데 필요한 최소 길이(분)를 얻습니다.

public int GetMatchMinGameLength(Gimmebreak.Backbone.Tournaments.TournamentMatch match)

파라미터

match: 토너먼트 매치.

리턴

최소 길이 (분 단위).

`GetMatchNextGameDeadline(TournamentMatch)`

이 아이템은 사용하지 않습니다. 대신 GetMatchNextGameFinishDeadline() 을 사용하세요.

매치 내 다음 매치의 종료 기한을 계산합니다. 이 마감 시간은 각 게임을 플레이해야 하는 최소 게임 시간이 남아 있는 방식으로 계산됩니다.

public System.DateTime GetMatchNextGameDeadline(Gimmebreak.Backbone.Tournaments.TournamentMatch match)

파라미터

match: 토너먼트 매치.

리턴

다음 게임의 가능한 최대 종료 기한.

`GetMatchNextGameFinishDeadline(TournamentMatch)`

매치 내 다음 매치의 종료 기한을 계산합니다. 이 마감 시간은 각 게임을 플레이해야 하는 최소 게임 시간이 남아 있는 방식으로 계산됩니다.

public System.DateTime GetMatchNextGameFinishDeadline(Gimmebreak.Backbone.Tournaments.TournamentMatch match)

파라미터

match: 토너먼트 매치.

리턴

다음 게임의 가능한 최대 종료 기한.

`GetMatchNextGameStartDeadline(TournamentMatch)`

매치 내 다음 매치의 시작 기한을 계산합니다. 이 마감 시간은 각 게임을 플레이해야 하는 최소 게임 시간이 남아 있는 방식으로 계산됩니다.

public System.DateTime GetMatchNextGameStartDeadline(Gimmebreak.Backbone.Tournaments.TournamentMatch match)

파라미터

match: 토너먼트 매치.

리턴

다음 게임의 가능한 최대 시작 기한.

`GetMatchStartDeadline(TournamentMatch)`

최소 게임 시간으로 각 게임을 진행하기 위해 필요한 모든 게임을 수용하기 위해 경기를 시작해야 할 마감 시간을 결정합니다.

public System.DateTime GetMatchStartDeadline(Gimmebreak.Backbone.Tournaments.TournamentMatch match)

파라미터

match: 토너먼트 매치.

리턴

매치가 시작된 이후의 종료 시간.

`GetThemeColor()`

토너먼트 테마 색상을 가져옵니다.

public UnityEngine.Color GetThemeColor()

리턴

유니티 색상.

`GetTournamentMatchById(long)`

고유한 ID로 토너먼트 매치를 가져옵니다.

public Gimmebreak.Backbone.Tournaments.TournamentMatch GetTournamentMatchById(long tournamentMatchId)

파라미터

tournamentMatchId: 토너먼트 매치 id.

리턴

토너먼트 매치 또는 매치가 없는 경우 null.

설명

이 메소드는 로컬에서 매치 항목을 검색하고 서버 데이터에 접근하지 않습니다. 매치 ID가 유효하지만 메소드가 null을 반환하는 경우 로컬 데이터를 백본 클라이언트의 LoadTournamentMatches()로 채웁니다.

`GetTournamentMatchMaxGameCount(TournamentMatch)`

특정 매치에서 플레이할 수 있는 최대 게임 수를 결정합니다. 이 값에 도달하면 시스템이 모든 게임에서 획득한 점수로 승자를 결정합니다.

public int GetTournamentMatchMaxGameCount(Gimmebreak.Backbone.Tournaments.TournamentMatch match)

파라미터

match: 토너먼트 매치.

리턴

허용되는 최대 게임 수입니다.

`GetTournamentMatchMinCheckinsPerTeam(TournamentMatch)`

특정 매치에 필요한 승리 점수를 결정합니다. 승리 점수는 사용자가 경기에서 이기기 위해 점수를 받은 위치에 배치해야 하는 횟수를 결정합니다.

public int GetTournamentMatchMinCheckinsPerTeam(Gimmebreak.Backbone.Tournaments.TournamentMatch match)

파라미터

match: 토너먼트 매치.

리턴

특정 매치에 대한 승리 점수.

`GetTournamentMatchWinScore(TournamentMatch)`

특정 매치에 필요한 승리 점수를 결정합니다. 승리 점수는 사용자가 경기에서 이기기 위해 점수를 받은 위치에 배치해야 하는 횟수를 결정합니다.

public int GetTournamentMatchWinScore(Gimmebreak.Backbone.Tournaments.TournamentMatch match)

파라미터

match: 토너먼트 매치.

리턴

특정 매치에 대한 승리 점수.

`GetTournamentPhaseById(int)`

ID 별로 특정 토너먼트 단계를 가져옵니다.

public Gimmebreak.Backbone.Tournaments.TournamentPhase GetTournamentPhaseById(int phaseId)

파라미터

phaseId: 토너먼트 단계 ID(항상 첫 번째 단계가 id=1로 시작됨)입니다.

리턴

토너먼트 단계 또는 단계가 없는 경우 null.

`GetTournamentPhaseFinishTime(int)`

특정 토너먼트 단계의 종료 시간 스탬프를 가져옵니다.

public System.DateTime GetTournamentPhaseFinishTime(int phaseId)

파라미터

phaseId: 단계 id.

리턴

요청된 단계의 종료 타임스탬프

`GetTournamentPhaseMaxLength(int)`

분으로 토너먼트 단계 최대 시간 길이를 가져옵니다. 이는 모든 라운드 MaxLength 값의 합계입니다.

public int GetTournamentPhaseMaxLength(int phaseId)

파라미터

phaseId: 단계 id.

리턴

분으로 토너먼트 단계의 길이.

`GetTournamentPhaseRoundFinishTime(int, int)`

현재 활성 토너먼트 단계에서 라운드 종료 타임스탬프를 가져옵니다.

public System.DateTime GetTournamentPhaseRoundFinishTime(int phaseId, int roundId)

파라미터

phaseId: 단계 id.
roundId: 라운드 id.

리턴

요청한 라운드의 종료 타임 스탬프.

`GetTournamentPhaseRoundStartTime(int, int)`

현재 활성 중인 토너먼트 단계에 라운드 시작 타임 스탬프를 가져옵니다.

public System.DateTime GetTournamentPhaseRoundStartTime(int phaseId, int roundId)

파라미터

phaseId: 단계 id.
roundId: 라운드 id.

리턴

요청한 라운드의 시작 타임 스탬프.

`GetTournamentPhaseStartTime(int)`

특정 토너먼트 단계의 시작 타임 스탬프를 가져옵니다.

public System.DateTime GetTournamentPhaseStartTime(int phaseId)

파라미터

phaseId: 단계 id.

리턴

요청한 단계의 시작 타임 스탬프.

`IsMatchInLoserBracket(TournamentMatch)`

매치가 패배자 브래킷에 있는지 확인합니다. 이중 제거 브래킷 형식에 사용됩니다.

public bool IsMatchInLoserBracket(Gimmebreak.Backbone.Tournaments.TournamentMatch match)

파라미터

match: 토너먼트 매치.

리턴

매치가 패배자 브래킷 내에 있으면 true.

`IsMatchInWinnerBracket(TournamentMatch)`

승자 브래킷 내에 매치가 있는지 확인합니다. 이중 제거 브래킷 형식에 사용됩니다.

public bool IsMatchInWinnerBracket(Gimmebreak.Backbone.Tournaments.TournamentMatch match)

파라미터

match: 토너먼트 매치.

리턴

매치가 승자 브래킷에 있으면 True.

`IsMatchMergingInLoserBracket(TournamentMatch)`

매치 항목이 패배자 브래킷에서 병합되는지 확인합니다. 이중 제거 브래킷 형식에 사용됩니다.

public bool IsMatchMergingInLoserBracket(Gimmebreak.Backbone.Tournaments.TournamentMatch match)

파라미터

match: 토너먼트 매치.

리턴

매치가 패배자 브래킷 내에서 병합되고 있으면 True.

설명

패배자 브래킷으로 병합하면 패배자 브래킷 매치의 승자가 다른 루저 브래킷 매치의 승자와 맞붙게 됩니다. 반대로, 매치가 병합되지 않으면 패자 순위 승자는 승자 순위 패자와 맞붙게 되므로 다음 라운드에서 패자 순위 매칭 횟수는 동일합니다. 이 방법은 이중 제거 브래킷의 UI 시각화에 도움이 됩니다.

생성자
속성
Methods