다음에 추가할 기능
그룹
선택한 프로젝트의 길드, 클랜, 팀을 역할과 함께 관리합니다.
Godot

확인할 수 있는 결과
시간 초과나 충돌 시 원래 작업을 보존하고 현재 상태를 확인하세요. 새 리비전으로 자동 재시도하지 마세요.
이 단계의 동영상은 아직 없습니다. 안내와 MCP 요청은 바로 사용할 수 있습니다.
그룹
같은 프로젝트 준비
게임 설정과 같은 프로젝트를 대시보드에서 선택하세요.
그룹 →첫 요청에는 추가 정의가 필요하지 않습니다. 일치하는 게임 데이터가 없으면 빈 결과도 정상입니다.
그룹은 게임 안에서 생성하고 관리합니다.
첫 예제는 데이터를 읽습니다. 그룹, 매치, 오브젝트를 생성하지 않습니다. 빈 목록도 정상적인 첫 응답입니다.
이 기능 구현하기
가이드는 미리 볼 수 있습니다. 실행하려면 활성 프로젝트 키가 필요합니다. 프로젝트 준비
SDK 설치와 프로젝트 설정 가져오기가 완료되고 플레이어가 로그인해야 합니다.
이 SDK 예제는 develop을 사용합니다. 필요한 API가 설치된 SDK에 있는지 확인하세요.
빠른 시작으로 원하는 플레이어를 연결하세요. 명시적인 버튼이나 씬 동작에서 read_my_groups()을 호출하세요. 파일을 여는 것만으로는 요청을 보내지 않습니다.
GDScript
1extends Node
2
3# Restore the existing matching player and connect in the Quickstart first.
4# Invoke explicitly from a player action, not from a poll or page loop.
5func read_my_groups() -> void:
6 var user = Horizon.auth.getCurrentUser()
7 if user == null:
8 return
9 var result = await Horizon.groups.getGroups(user.userId)
10 if not result.success:
11 push_warning(result.errorCode)
12 return
13 print("Player revision: ", result.data.revision)
14 for group in result.data.groups:
15 print(group.id, " ", group.myRole, " revision=", group.revision)
16 # result.data.limits contains all current limits; retained groups are not truncated.
17 # getMembers(userId, groupId, "", 1) reads one page. Keep its revision/cursor.
18 # Restart explicitly on a changed revision; optional createdAt is not epoch zero.
19# Full durable mutations: addons/horizon_sdk/examples/features/groups_example.gd.
20# Keep the original revision/requestId; unknown create requires explicit reconciliation.
새 기능을 테스트하세요.
시간 초과나 충돌 시 원래 작업을 보존하고 현재 상태를 확인하세요. 새 리비전으로 자동 재시도하지 마세요.
게임 설정과 같은 프로젝트를 대시보드에서 선택하세요.
엔드포인트
- GET
/groups - GET
/groups/{groupId} - GET
/groups/{groupId}/members - GET
/groups/{groupId}/pending - POST
/groups - PUT
/groups/{groupId} - POST
/groups/{groupId}/join - POST
/groups/{groupId}/request - POST
/groups/{groupId}/invite - POST
/groups/{groupId}/accept-invite - POST
/groups/{groupId}/decline-invite - POST
/groups/{groupId}/cancel-invite - POST
/groups/{groupId}/accept-request - POST
/groups/{groupId}/decline-request - POST
/groups/{groupId}/cancel-request - POST
/groups/{groupId}/leave - POST
/groups/{groupId}/remove - POST
/groups/{groupId}/role - POST
/groups/{groupId}/transfer - POST
/groups/{groupId}/delete


