设置好友

与社交服务 API 交互，以执行与事件和用户相关的操作。这些操作包括创建新的好友请求、接受或拒绝传入请求，以及删除好友关系。社交服务允许用户在平台内管理他们的关系和互动。

好友关系与操作

社交服务中的好友关系是用户之间的双向关系。可以通过一些操作来更新这些好友关系，例如发送好友请求、接受或拒绝请求、取消请求以及移除好友关系。这些操作中的每一种都会对用户之间的关系产生特定影响。

实现好友关系更新

要执行这些与好友关系相关的操作，必须使用 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
}