게임 아이디어와 기능

다음에 추가할 기능

친구

선택한 프로젝트의 친구, 요청 및 차단입니다.

SDK: develop 브랜치플레이어 세션 필요
Godot
친구 일러스트
확인할 수 있는 결과

시간 초과나 충돌 후 새로 읽고 의도를 확인하세요. 새 리비전으로 자동 재시도하지 마세요.

동영상 준비 중

이 단계의 동영상은 아직 없습니다. 안내와 MCP 요청은 바로 사용할 수 있습니다.

친구

같은 프로젝트 준비

  1. 게임 설정과 같은 프로젝트를 대시보드에서 선택하세요.

    친구 →
  2. 첫 요청에는 추가 정의가 필요하지 않습니다. 일치하는 게임 데이터가 없으면 빈 결과도 정상입니다.

    같은 프로젝트에서 서로 다른 두 플레이어 세션을 사용하세요. 사용자 관리에서 상대의 정확한 UUID를 복사하세요.

    정확한 UUID 또는 정규 H 코드를 사용하세요. 이름과 이메일은 허용되지 않습니다.

    여기서는 조회만 가능하며 플레이어 본인 세션만 관계를 변경합니다.

이 기능 구현하기

가이드는 미리 볼 수 있습니다. 실행하려면 활성 프로젝트 키가 필요합니다. 프로젝트 준비

SDK 설치와 프로젝트 설정 가져오기가 완료되고 플레이어가 로그인해야 합니다.

이 SDK 예제는 develop을 사용합니다. 필요한 API가 설치된 SDK에 있는지 확인하세요.

빠른 시작으로 원하는 플레이어를 연결하세요. 명시적인 버튼이나 씬 동작에서 run_reviewed_action()을 호출하세요. 파일을 여는 것만으로는 요청을 보내지 않습니다.

GDScript
res://scripts/friends.gd
horizOn 호출
1extends Node
2​
3# Existing configured SDK and authenticated player session required.
4# Invoke run_reviewed_action explicitly after reviewing this example.
5func run_reviewed_action() -> void:
6 if not Horizon.auth.isSignedIn():
7 return
8 var user_id: String = Horizon.auth.getCurrentUser().userId
9 var loaded: Dictionary = await Horizon.friends.getFriends(user_id)
10 if not loaded.success:
11 push_warning(loaded.errorCode)
12 return
13 print(loaded.data.friendCode) # Public identifier, not a credential.
14 for friend in loaded.data.friends:
15 print(friend.display.name, ": ", friend.lastActiveAt) # null means unknown, not offline.
16​
17 # Examples for explicit player actions, never run these as an automatic sequence:
18 # var found = await Horizon.friends.findPlayer(user_id, exact_uuid_or_h_code)
19 # var r = await Horizon.friends.sendRequest(user_id, target_id, reviewed_revision)
20 # var r = await Horizon.friends.acceptRequest(user_id, target_id, reviewed_revision, original_request_id)
21 # var r = await Horizon.friends.declineRequest(user_id, target_id, reviewed_revision, original_request_id)
22 # var r = await Horizon.friends.cancelRequest(user_id, target_id, reviewed_revision, original_request_id)
23 # var r = await Horizon.friends.removeFriend(user_id, target_id, reviewed_revision)
24 # var r = await Horizon.friends.blockPlayer(user_id, target_id, reviewed_revision)
25 # var r = await Horizon.friends.unblockPlayer(user_id, target_id, reviewed_revision)
26 # Success: replace the entire snapshot with r.data. Do not patch one side locally.
27 # Timeout/REVISION_CONFLICT: refresh and reconcile; never silently substitute a new revision.
28 # Keep original incoming requestId for accept/decline, outgoing requestId for cancel.
29 # Inbox notices are hints; only the current snapshot authorizes a request action.
30 # Refresh explicitly on reconnect/metadata invalidation; no hidden polling timer.
전체 SDK 예제 열기 ↗

새 기능을 테스트하세요.

시간 초과나 충돌 후 새로 읽고 의도를 확인하세요. 새 리비전으로 자동 재시도하지 마세요.

게임 설정과 같은 프로젝트를 대시보드에서 선택하세요.

엔드포인트
  • GET/friends
  • GET/friends/find
  • POST/friends/request
  • POST/friends/accept
  • POST/friends/decline
  • POST/friends/cancel
  • POST/friends/remove
  • POST/friends/block
  • POST/friends/unblock
API 레퍼런스의 모든 엔드포인트
리더보드 일러스트
다음 단계에 대한 추천

모든 라운드에 최고 점수를 더하세요.

라운드가 끝나면 점수를 저장하고 선두를 보여주세요. 기존 연결과 플레이어 세션을 계속 사용하세요.