매치 관리

매치 메이킹 시작하기¶

콘솔에서 [매치 메이킹>매치 관리] 메뉴로 이동합니다.

매치 메이킹을 추가할 프로젝트를 선택하고, 시작하기 버튼을 눌러 매치를 생성하세요.

Note

설정할 프로젝트가 없다면 [앱센터 > 프로젝트 관리]에서 프로젝트 생성 여부를 확인하세요. 프로젝트 상태가 [개발중] 또는 [라이브]일 때만 매치 검색이 가능합니다.
프로젝트에 매치를 처음 생성할 때, 새 매치 화면에서 기본 정보를 입력하세요.
- 매치 연동 방식 : 프로젝트에서 매치를 호출하는 방식입니다.
  - SDK : Hive SDK를 사용하여 매치 요청을 보내려는 경우 선택합니다.
  - 서버 콜백 : 매치 메이킹 서버의 API를 통해 직접 매치 요청을 보내려는 경우 선택합니다.
- 매치 콜백 URL : 매치 결과를 받을 주소입니다. 매치 연동 방식이 서버 콜백일 경우에만 등록이 필요합니다.
- 매치 이름 : 콘솔에서 매치를 구분할 이름입니다.
새 매치 화면에서 매치 옵션을 선택하세요.
- 매치 방식 : 유저 매칭 알고리즘을 선택합니다. 점수 방식을 선택하면 점수가 비슷한 유저끼리 매칭되며, 랜덤을 선택하면 유저 실력에 상관없이 무작위로 매칭됩니다.
- 매치 단위/인원 : 팀 매치인지 개인 매치인지를 선택합니다. 팀 매치의 경우 팀 개수를 선택할 수 있으며, 각 팀의 팀원 수는 항상 동일하게 구성됩니다. 팀 개수는 최대 4개이며, 참여 인원은 총 16명을 넘을 수 없습니다.
  - 최대 팀 개수 예시: 팀 개수 8 / 각 팀원 수 2
  - 최대 팀원 수 예시: 팀 개수 2 / 각 팀원 수 8
- 매치 시도 시간 : 매치 인원이 충족되지 않으면, 매치 시도 시간 동안 유저를 탐색합니다.
- 매치 결과 수신
  - 매치 인원이 충족된 경우만 결과 수신 : 매치 시도 시간 내에 매치가 완료되었을 때만 매치 성공 여부와 함께 유저 정보를 전달합니다.
  - 매치 인원이 충족되지 않아도 결과 수신 : 매치 시도 시간이 지날 때까지 매치 인원이 충족되지 않아도 현재까지 매칭된 유저 정보를 포함한 결과를 전달합니다.
- 매치 방식이 점수인 경우, 매치 범위 정보를 입력하세요.
  - 매치 범위
    - 매치 대상을 찾지 못하면 매치 증감 시간이 지날 때마다 점수 범위를 매치 증감 값만큼 넓힙니다.
    - 매치 범위 확장 시간 < 전체 매치 시도 시간
    - 매치 범위 증감 값 < 최대 매치 범위 값
  - 최대 매치 범위
    - 유저끼리 매치 가능한 점수 범위를 입력합니다. 예를 들어, 100을 입력하면 요청한 점수에서 +-100점 범위까지만 탐색 범위를 넓힙니다.
설정이 완료되면, ‘저장’을 클릭하세요.
API 가이드를 참고하여 매치 정보를 호출하세요.

매치 목록¶

매치를 관리할 프로젝트를 선택해 주세요.
프로젝트에 매치가 등록되어 있으면, 매치 연결 정보가 선택 프로젝트 하위에 표시됩니다.

매치 연동 방식 : 프로젝트에서 매치를 호출하는 방식입니다.
- SDK : Hive SDK를 사용하여 매치 요청을 보내려는 경우 선택합니다.
- 서버 콜백 : 매치 메이킹 서버의 API를 통해 직접 매치 요청을 보내려는 경우 선택합니다. 이 방식을 사용하려면 매치 콜백 URL과 매치 콜백 Secret Key를 등록해야 합니다.
매치 콜백 URL : 매치 결과를 받을 주소입니다. 서버 콜백 방식을 사용할 때만 입력이 필요합니다.
매치 콜백 Secret Key : 매치 메이킹 서버와 통신할 때 필요한 값으로, 자동으로 생성됩니다. 키를 변경하거나 새로 생성하려면 Refresh 버튼을 누르세요.

매치 생성하기¶

새 매치 버튼으로 매치 설정을 추가할 수 있습니다. 하나의 프로젝트에 여러 개의 매치를 등록할 수 있습니다.

매치 수정하기¶

매치 방식, 매치 단위, 점수 기준을 제외한 나머지 항목을 수정할 수 있습니다. 변경된 정보는 실시간으로 매치 메이킹에 반영됩니다.

매치 삭제하기¶

매치 목록에서 삭제할 매치를 선택하고, 삭제 버튼을 누릅니다.