新社交系统对接

社交系统现包括好友与组队

社交TAB界面对接，实现BaseSocialGui。

社交TAB界面利用ForgeGui框架。由你方提供数据与逻辑，客户端进行渲染。

BaseSocialGui类是针对需求对于ForgeGui的抽象实现，以方便你方开发。

示例代码

你可以主动地提供、更新数据。

public class ExampleSocialGui extends BaseSocialGui {
    public ExampleSocialGui(Player viewer) {
        super(viewer);

        setup();
    }

    public void setup() {
        //提供好友数据，若无可不传
        getProperty().setFriends(list);

        //提供组队数据，若无可不传
        getProperty().setTeammates(list);

        //提供未处理请求，若无可不传
        getProperty().setRequests(list);

        //若需要立即更新，请主动进行，以确保客户体验。
        forceSynProperty();
    }

    @Override
    public void onRequest(RequestProperty requestProperty) {
        //在此进行逻辑层处理

        /**
         * 以下为例
         * */

        //情况一：客户端向服务器发出请求，请求与某好友组队
        if (requestProperty.getRequestType() == SocialRequestEnum.FRIEND_REQUEST_TEAM) {
            //在此，target为目标玩家UUID
            String requestTarget = requestProperty.cTarget.get();
            UUID targetUuid = UUID.fromString(requestTarget);

            //生成新的请求，发送给目标玩家
            RequestProperty applyRequest = new RequestProperty(requestProperty.cSource.get(), SocialRequestEnum.REQUEST_CLIENT_APPLY_FRIEND);
            //⚠️ 在此，我们将target规范为为该请求的UUID，以便回调。可见下方回调代码。
            applyRequest.cTarget.set(UUID.randomUUID().toString());
            applyRequest.cExtMsg.set(目标玩家名);

            //TODO 保存该请求，并发送给目标玩家
            
            /***/
            //你可以通过该方法将请求转换为Json进行保存。
            applyRequest.getProperty().getCompleteJson();
            /***/

            //反馈
            info("好友请求发出！");
        }

        //情况二：客户端向服务器发出请求，同意了某个请求
        else if (requestProperty.getRequestType() == SocialRequestEnum.REQUEST_ACCEPT) {
            //此Uuid为目标请求的回调ID
            String targetRequestUuid = requestProperty.cTarget.get();

            //TODO 处理请求
        }

    }

功能接口对接，实现ISocialProvider

public interface ISocialProvider extends IFunctionProvider {

    /*
     * 客户端发出打开界面请求
     *
     * 为保证流程，客户端会率先打开空界面。当收到该调用，再次打开覆盖即可。
     * */
    void askForSocialUi(Player player);

    /**
     * 获取某玩家的队伍成员
     *
     * @return 可传回带有玩家本人的list，以方便缓存与开发。
     */
    List<MateProperty> getTeammates(Player player);
}

附加对照

public enum SocialRequpublic enum SocialRequestEnum {

    //FRIEND
    FRIEND_REQUEST_TEAM(0),//客户端Source玩家向服务端发出请求，请求与Target玩家组队
    FRIEND_DELETE(1),//客户端向服务端发出请求，请求删除Target玩家

    //TEAM
    TEAM_MEMBER_KICK(2),//客户端Source玩家向服务器发出请求，请求从组队踢出Target玩家
    TEAM_MEMBER_PROMOTE(3),//客户端Source玩家向服务器发出请求，请求给予Target玩家房主
    TEAM_QUIT(4),//客户端Source玩家向服务器发出请求，请求退出队伍

    //REQUEST
    REQUEST_ACCEPT(5),//客户端Source玩家向服务器发出请求，同意Target请求。
    REQUEST_IGNORE(6),//客户端Source玩家向服务器发出请求，拒绝（忽略）Target请求。

    //CLIENT REQUEST
    REQUEST_CLIENT_APPLY_FRIEND(7),//服务器向客户端同步未处理请求，Source为发出来源，Target为该请求ID，ExtMsg为来源名称
    REQUEST_CLIENT_APPLY_TEAM(8);//服务器向客户端同步未处理请求，Source为发出来源，Target为该请求ID，ExtMsg为来
}