친구 추가하기

이벤트와 사용자와 관련된 작업을 수행하기 위해 Social Service API와 상호작용합니다. 이러한 작업에는 새 친구 요청 생성, 들어오는 요청 수락 또는 거절, 그리고 친구 관계 삭제가 포함됩니다. Social Service를 통해 사용자는 플랫폼 내에서 관계와 상호작용을 관리할 수 있습니다.

친구 관계와 작업

Social Service 내의 친구 관계는 사용자 간의 양방향 관계입니다. 친구 요청 보내기, 요청 수락 또는 거절, 요청 취소, 친구 관계 제거와 같은 작업을 통해 이러한 관계를 업데이트할 수 있습니다. 이러한 각 작업은 사용자 간 관계에 특정한 영향을 미칩니다.

친구 관계 업데이트 구현

이러한 친구 관계 관련 작업을 수행하려면, UpdateFriendshipEvent 메시지를 사용해야 합니다. 이 메시지를 사용하면 요청, 수락, 거절, 취소, 제거와 같은 친구 관계 관련 다양한 작업을 실행할 수 있습니다.

각 작업에 필요한 정확한 페이로드 구조와 필수 매개변수는 UpdateFriendshipEvent 메시지에 지정되어 있습니다.

사용 예시

다음은 UpdateFriendshipEvent 친구 요청을 보내기 위한 예시입니다:

message UpdateFriendshipEvent {
  string userAddress = 1;
  string targetUserAddress = 2;
  FriendshipAction action = 3;
}

이 예시에서, userAddress 는 보낸 사람의 주소를 나타내며, targetUserAddress 는 받는 사람의 주소를 나타내며, action 는 수행할 작업 유형(요청, 수락, 거절, 취소 또는 제거)을 나타냅니다.

친구 요청 보내기

사용자는 누구나 다른 사용자에게 친구 요청을 보낼 수 있습니다. 그러나 친구 관계를 성립하려면 수신자 사용자가 요청을 수락해야 합니다.

requestFriendship: async (address: string, message?: string) => {
  const response = await service.updateFriendshipEvent({
    event: { request: { user: { address }, message } },
    authToken: { synapseToken }
  })
  processErrors(response)
  return response.event
}

요청 수락 또는 거절

사용자가 친구 요청을 받으면, 이를 수락하거나 거절할 수 있습니다. 요청을 수락하면 두 사용자 간에 상호 친구 관계가 성립됩니다. 요청을 거절하면 친구 관계 성립이 거부됩니다.

acceptFriendshipRequest: async (address: string) => {
  const response = await service.updateFriendshipEvent(
    UpdateFriendshipPayload.create({
      event: { accept: { user: { address } } },
      authToken: { synapseToken }
    })
  )
  processErrors(response)
  return response.event
}

rejectFriendshipRequest: async (address: string) => {
  const response = await service.updateFriendshipEvent(
    UpdateFriendshipPayload.create({
      authToken: { synapseToken },
      event: { reject: { user: { address } } }
    })
  )
  processErrors(response)
  return response.event
}

친구 요청 취소

사용자가 수락되기 전에 보낸 친구 요청을 철회하기로 결정하면, 요청을 취소할 수 있습니다. 이렇게 하면 수신자가 요청을 보거나 응답하는 것을 방지할 수 있습니다.

cancelFriendshipRequest: async (address: string) => {
  const response = await service.updateFriendshipEvent(
    UpdateFriendshipPayload.create({
      event: { cancel: { user: { address } } },
      authToken: { synapseToken }
    })
  )
  processErrors(response)
  return response.event
}

친구 관계 제거

상호 친구 관계에 있는 어느 쪽 사용자든 친구 관계를 제거할 수 있습니다. 친구 관계가 제거되면 양쪽 사용자의 기록에서 삭제되어 상호 관계가 종료됩니다.

removeFriend: async (address: string) => {
  const response = await service.updateFriendshipEvent(
    UpdateFriendshipPayload.create({
      authToken: { synapseToken },
      event: { delete: { user: { address } } }
    })
  )
  processErrors(response)
  return response.event
}