商城对接

一，现阶段你需要对接三个接口，分别如下

1. IShopCurrencyProvider 玩家货币接口

2. IShopPlayerStoreProvider 玩家库存接口

3. IShopTradeProvider 商城交易接口

接口细则如下

public interface IShopCurrencyProvider extends IFunctionProvider {
    /**
     * 获得目标玩家的余额
     */
    long getBalance(String playerName);

    /**
     * 设置目标玩家余额
     */
    long setBalance(String playerName, long newBalance);

    /**
     * 取出（消耗）目标玩家钱
     */
    long withdrawMoney(String playerName, long value);

    /*
     * 存入(增加)目标玩家钱
     * */
    long depositMoney(String playerName, long value);


    /**
     * 获取玩家余额
     *
     * @param offlinePlayer 以OfflinePlayer形式传入
     */
    default long getBalance(OfflinePlayer offlinePlayer) {
        return getBalance(offlinePlayer.getName());
    }

    /*
     * 判断玩家是否有足够的余额
     * */
    default boolean hasEnoughBalance(String playerName, long value) {
        return getBalance(playerName) >= value;
    }
}

public interface IShopPlayerStoreProvider extends IFunctionProvider {
    /**
     * 获得目标的库存物品
     */
    Collection<IStoreItem> getStoreItem(UUID uuid);
}

public interface IShopTradeProvider extends IFunctionProvider {
    /**
     * 获得可以交易的物品
     */
    Collection<ITradeItem> getTradeItem();

    /**
     * 玩家尝试购买
     *
     * @param tradeItemShortName 交易物品的shortName
     */
    void tryPurchase(UUID thePlayer, String tradeItemShortName);
}

二，了解枚举、接口类

在开发过程中，你将会遇到这些接口、枚举。

public enum StoreItemEnum {
    skin,//皮肤
    passport;//通行证
}

//该接口表示为库存物品的最小单元
public interface IStoreItem {
    /**获得该库存物品的类型*/
    StoreItemEnum getType();

    /*获得物品
    * 若为皮肤，则传回皮肤名字即可
    * 若为通行证，则传回通行证ID
    * */
    String getItem();

    /**
     * 获得入库(购买)时间
     * */
    String getStorageDate();
}

//该接口是库存物品的接口，包含了价格信息，与用于回调的ShortName
public interface ITradeItem extends IStoreItem {

    /*
    * 获取ShortName以便于回调
    * */
    String getShortName();

    /*
     * 获得物品的价格
     * */
    long getPrice();

    /**
     * 交易物品无需返回存储时间
     */
    default String getStorageDate() {
        throw new RuntimeException("trade item doesnt have storage data!");
    }
}