社交系统对接

对接【好友系统】

一，实现接口

为对接好友系统，你需要实现【IFriendProvider】接口。

public interface IFriendProvider extends IFunctionProvider {
    /**
     * 获得目标玩家的{好友列表}，即玩家当前所有好友与好友状态
     *
     * @param player 目标玩家的uuid
     */
    List<IMateInfo> getFriends(UUID player);

    /**
     * 获得某玩家的{请求列表}，即玩家当前收到的好友请求
     *
     * @param player 目标玩家
     */
    List<IRequestInfo> getRequests(UUID player);

    /*
     * 发送好友请求，好友请求包括【删除好友】、【添加好友】
     *
     * @param from 来源玩家
     * @param to 目标玩家
     *
     * @return 结果提示
     * */
    String sendFriendQuest(UUID from, UUID to, FriendRequestTypEnum requestTyp);

    /*
     * 处理请求，需要处理的请求包括【接受好友要求】、【拒绝好友邀请】
     *
     * @param uuid 目标玩家的uuid
     * @param requestShortName 目标请求的shortName
     * @param action 玩家做出的行为
     * */
    void handleFriendRequest(UUID uuid, String requestShortName, RequestActionEnum action);

    /*
     * 返回目标是否拥有（一个或以上）的【好友请求】，用于在好友UI上添加红点提示处理请求
     *
     * @param player 需要判断的玩家
     * */
    boolean isHasRequest(UUID player);

    /**
     * 判断两玩家是否是朋友
     *
     * @param player1 需要判断的目标1
     * @param player2 需要判断的目标2
     */
    boolean isFriend(UUID player1, UUID player2);
}

对接【组队系统】

一，实现接口

组队系统大部分功能同上相同，实现【ITeamProvider】功能即可。

public interface ITeamProvider extends IFunctionProvider {

    /**
     * 判断目标玩家是否拥有队伍
     */
    boolean hasTeam(UUID player);

    /**
     * 判断两个玩家是否是队友
     */
    boolean isTeammate(UUID player1, UUID player2);

    /**
     * 获得目标玩家的{队友列表}，即玩家当前所有队友与队友状态
     *
     * @param player 目标玩家的uuid
     */
    List<IMateInfo> getTeammates(UUID player);


    /**
     * 获得某玩家的{请求列表}，即玩家当前收到的组队请求
     *
     * @param player 目标玩家
     */
    List<IRequestInfo> getRequests(UUID player);

    /**
     * 如果目标玩家有队伍，则获得目标玩家的队伍领队。
     *
     * @param player 目标玩家
     *
     * @return 如果没有队伍，则返回NULL
     * */
    UUID getTeamLeader(UUID player);


    /*
     * 处理请求，需要处理的请求包括【接受组队要求】、【拒绝组队邀请】
     *
     * @param uuid 目标玩家的uuid
     * @param requestShortName 目标请求的shortName
     * @param action 玩家做出的行为
     * */
    void handleTeamRequest(UUID uuid, String requestShortName, RequestActionEnum action);

    /*
     * 发送组队请求，组队请求包括【请求组队】、【退出组队】、【提出队伍】、【设置为队长】
     *
     * @param from 来源玩家
     * @param to 目标玩家，注意，该值可能为空。
     *
     * @return 结果提示
     * */
    String sendTeamQuest(UUID from, @Nullable UUID to, TeamRequestTypEnum requestTyp);
}

二，进行组队的主动通知

当某玩家收到组队邀请时，需进行主动通知。

/**
* 提醒目标收到新的组队邀请
*/
TeamManager.notifyTeamUp(uuid);

在实现接口后，需注册接口

注册方法可看本章。

其他类内容

IMateInfo——伙伴信息接口

/**
 * 伙伴信息，可以为好友，也可以为队伍
 * */
public interface IMateInfo {
    /**
     * 获得目标玩家的UUID
     */
    UUID getFriendUUID();

    /**
     * 获得目标玩家的名字
     */
    String getFriendName();

    /**
     * 获得好友状态
     */
    MateStateEnum getFriendState();
}

IRequestInfo——请求信息接口

/**
 * 请求信息
 * */
public interface IRequestInfo {

    //获得请求的shortName
    //该shortName将会用于回调
    String getRequestShortName();

    //获得请求的名字
    //请求名字为【申请者名字】即可
    String getRequestName();
}

TeamRequestTypeEnum——队伍请求类型

public enum TeamRequestTypeEnum {
    APPLY,//申请/加入组队。申请者，被申请者。
    QUIT,//申请退出组队。申请者，NULL。
    KICK,//申请踢出组队。申请者，踢出目标。
    PROMOTE;//设置为队长。申请者，升职目标。
}