任务HUD对接

任务HUD即将玩家当前任务与任务目标显示在HUD上。因此，需要频繁地（或被动地）获取玩家的任务状态来实现该功能。

一，了解接口

1. ITaskHudInfoProvider - 任务对接接口。

public interface ITaskHudInfoProvider extends IFunctionProvider {
    /**
     * 获得目标玩家的简要任务信息
     * 注意！为此方法区别与ITaskInfoProvider，该方法会被频繁调用，因此需要简短且快速地获取信息。
     *
     * @param playerUuid 目标玩家的uuid
     * @return 玩家的任务信息表
     **/
    List<IBriefTaskInfo> getBriefTaskInfoOf(UUID playerUuid);
}

1. IBriefTaskInfo - 简短任务信息接口。

public interface IBriefTaskInfo {
    /**
     * 获得任务名字
     * */
    String getTaskName();

    /***
     * 获得目标信息与状态，其中Key为目标信息，Value为目标状态。
     * 
     * 注意！Key中需包含任务进度信息，例如: 击杀玩家(2/10)
     *      Value中为目标的进度枚举，枚举中包括 NOT_STARTED(未开始)、PROCEED(进行中)、DONE（已完成）。
     * 
     * */
    Map<String, ObjectiveStatusEnum> getObjectiveInfo();
}

二，进行对接

1 创建IBriefTaskInfo

//方法一：你可以实现IBriefTaskInfo接口，自行填充信息

//方法二：利用现有实现SimpleBriefTaskInfo
IBriefTaskInfo info = SimpleBriefTaskInfo.of(taskName)
                                .add(objectiveInfo,objectiveStatus)
                                .add(......);

2 接口对接

public class YourHudInfoProviderImpl implements  ITaskHudInfoProvider{
   
     /**
     * 获得目标玩家的简要任务信息
     * 注意！为此方法区别与ITaskInfoProvider。
     * 该方法会被频繁调用，因此需要简短且快速地获取信息。
     *
     * 若有必要，请进行缓存等。
     *
     * @param playerUuid 目标玩家的uuid
     * @return 玩家的简短任务信息表
     **/
    public List<IBriefTaskInfo> getBriefTaskInfoOf(UUID playerUuid) {
        //TODO 在此进行你的返回玩家简短任务信息代码。
    }
    
}

3 注册接口

在此之前请完成对接指南的阅读

//注册你的提供商类即可
ProviderManager.register(new YourHudInfoProviderImpl());

主动调用更新

为减少频繁调用更新造成的资源消耗，同时保证更新的实时性，该插件提供了主动调用更新。

import team.liuwei.minelastdaysproxy.proxies.task.hud.TaskHudManager;
/**
* 主动对目标玩家进行更新
*
* @param player         目标玩家
* @param briefTaskInfos 需要更新的任务
*/
TaskHudManager.callUpdate(player, list...);

示例代码如下

//步骤一，得到简易信息

//注意，请在传递的过程中注意目标顺序，已完成最先，随后进行中，最后已完成。
SimpleBriefTaskInfo simpleBriefTaskInfo = SimpleBriefTaskInfo.of("今朝一梦");
simpleBriefTaskInfo.add("调查KG的信息", ObjectiveStatusEnum.DONE);
simpleBriefTaskInfo.add("接近KG", ObjectiveStatusEnum.PROCEED);
simpleBriefTaskInfo.add("在没人注意的情况下击杀KG", ObjectiveStatusEnum.NOT_STARTED);
simpleBriefTaskInfo.add("杀死KG的守卫 (0/5)", ObjectiveStatusEnum.NOT_STARTED);

//步骤二，主动更新
TaskHudManager.callUpdate(player, Arrays.asList(simpleBriefTaskInfo));

最终效果如下