메인 콘텐츠로 건너뛰기

Documentation Index

Fetch the complete documentation index at: https://docs.hyperx.dev/llms.txt

Use this file to discover all available pages before exploring further.

소셜 기능은 유저가 서로 찾고, 관계를 맺고, 메시지와 보상을 주고받는 흐름을 제공합니다. 운영자는 Console에서 유저, 우편, 메시지, 길드 상태를 확인할 수 있습니다.

​
유저 검색과 랜덤 조회

var users = await HyperX.Core.Search.Users(query: "hero", limit: 20);

await HyperX.Core.Random.Register(
    session.AccessToken,
    bucket: "arena",
    metadata: HyperX.Json.JsonMapper.ToObject("{\"power\":1200}")
);

var candidates = await HyperX.Core.Random.Lookup(
    session.AccessToken,
    bucket: "arena",
    limit: 5
);
검색은 닉네임 또는 유저 ID 기준으로 공개 유저 정보를 반환합니다. 랜덤 조회는 같은 bucket에 등록한 유저 중 후보를 반환합니다.

​
친구

var request = await HyperX.Core.Friends.SendRequest(
    targetUserId,
    session.AccessToken
);

await HyperX.Core.Friends.Accept(request.Id, otherSession.AccessToken);
var friends = await HyperX.Core.Friends.List(session.AccessToken);
친구는 요청, 수락, 거절, 삭제, 차단을 지원합니다. 차단된 관계에서는 친구 요청과 쪽지 전송이 거부됩니다.

​
우편

var mail = await HyperX.Core.Mail.Send(
    recipientUserId,
    "gift",
    session.AccessToken,
    body: "welcome",
    attachmentPayload: HyperX.Json.JsonMapper.ToObject("{\"gold\":100}")
);

var inbox = await HyperX.Core.Mail.List(session.AccessToken);
var claimed = await HyperX.Core.Mail.Claim(mail.Id, session.AccessToken);
우편 첨부는 JSON payload로 반환됩니다. 보상 지급은 게임 정책에 맞게 처리하고, 중복 수령은 서버의 수령 상태를 기준으로 막습니다.

​
쪽지

var sent = await HyperX.Core.Messages.Send(
    recipientUserId,
    "hello",
    session.AccessToken
);

var thread = await HyperX.Core.Messages.List(
    session.AccessToken,
    peerUserId: recipientUserId
);
쪽지는 유저 간 텍스트 메시지입니다. 운영자는 Console에서 부적절한 메시지를 숨김 처리할 수 있습니다.

​
길드

var guild = await HyperX.Core.Guilds.Create(
    "knights",
    "Knights",
    session.AccessToken,
    joinPolicy: "open"
);

await HyperX.Core.Guilds.Join(guild.Id, otherSession.AccessToken);
var members = await HyperX.Core.Guilds.Members(guild.Id, session.AccessToken);
joinPolicy는 open, approval, invite_only 중 하나입니다.

​
알림

var notifications = await HyperX.Core.Notify.List(
    session.AccessToken,
    unreadOnly: true
);

await HyperX.Core.Notify.MarkRead(
    notifications[0].Id,
    session.AccessToken
);
Unity에서 새 알림을 주기적으로 받고 싶으면 구독 래퍼를 사용합니다. 
using var subscription = HyperX.Core.Notify.Subscribe(
    session.AccessToken,
    notification => Debug.Log(notification.EventType),
    error => Debug.LogWarning(error.Message),
    pollIntervalMilliseconds: 2000
);