com.germ.germplugin.api

Class GermClientAPI

java.lang.Object

com.germ.germplugin.api.GermClientAPI

public class GermClientAPI
extends java.lang.Object

萌芽客户端API

提供与客户端进行数据交互的异步方法

使用CompletableFuture进行异步处理，避免阻塞主线程

使用示例：

         CompletableFuture<Set<String>> future = reqPlayingSounds(player);
         future.whenComplete((playing, throwable) -> {
             if (!playing.contains("bgm")) {
                 GermPacketAPI.playSound(player, "bgm");
             }
         });
 

Constructor Summary

Constructors

Constructor and Description
GermClientAPI()

Method Summary

Modifier and Type	Method and Description
protected static void	receive(long id, RespondDataDTO dataDTO) 接收客户端响应数据 框架内部使用，用于处理客户端返回的数据
static java.util.concurrent.CompletableFuture<RespondDataDTO>	req(org.bukkit.entity.Player player, java.lang.String name, java.lang.String data) 向客户端发送数据请求 通用的客户端数据请求方法，返回异步结果
static java.util.concurrent.CompletableFuture<java.lang.String>	reqPlaceholderValue(org.bukkit.entity.Player player, java.lang.String variable) 请求玩家客户端指定变量的值
static java.util.concurrent.CompletableFuture<java.util.Set<java.lang.String>>	reqPlayingSounds(org.bukkit.entity.Player player) 请求玩家当前正在播放的声音列表

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

GermClientAPI

public GermClientAPI()

Method Detail

reqPlayingSounds

public static java.util.concurrent.CompletableFuture<java.util.Set<java.lang.String>> reqPlayingSounds(org.bukkit.entity.Player player)

请求玩家当前正在播放的声音列表

Parameters:

player - 目标玩家

Returns:

包含正在播放声音名称的CompletableFuture

reqPlaceholderValue

public static java.util.concurrent.CompletableFuture<java.lang.String> reqPlaceholderValue(org.bukkit.entity.Player player,
                                                                                           java.lang.String variable)

请求玩家客户端指定变量的值

Parameters:

player - 目标玩家

variable - 变量名

Returns:

包含变量值的CompletableFuture

req

public static java.util.concurrent.CompletableFuture<RespondDataDTO> req(org.bukkit.entity.Player player,
                                                                         java.lang.String name,
                                                                         java.lang.String data)

向客户端发送数据请求

通用的客户端数据请求方法，返回异步结果

Parameters:

player - 目标玩家

name - 请求类型名称

data - 请求数据

Returns:

包含响应数据的CompletableFuture

receive

protected static void receive(long id,
                              RespondDataDTO dataDTO)

接收客户端响应数据

框架内部使用，用于处理客户端返回的数据

Parameters:

id - 请求ID

dataDTO - 响应数据