跳到正文
本頁目錄

Service(服務系統)

ll/api/service/ · 通用 / 服務端 / 客戶端

概述

Service 模塊提供了用於依賴注入的服務註冊表,以及訪問 Bedrock 引擎內部組件的接口,如 Minecraft、Level、ServerInstance 和 CommandRegistry。

頭文件

頭文件說明
ll/api/service/Service.h服務基類
ll/api/service/ServiceManager.h服務註冊表
ll/api/service/Bedrock.hBedrock 引擎訪問器

核心類

ServiceManager

C++
namespace ll::service {
class ServiceManager {
public:
    static ServiceManager& getInstance();

    template <IsService T>
    Expected<std::shared_ptr<T>> getService();

    template <IsService T>
    event::ListenerPtr subscribeService(std::function<void(std::shared_ptr<T> const&)> const& fn);

    bool registerService(std::shared_ptr<Service> const& service, std::shared_ptr<mod::Mod> const& mod);
    bool unregisterService(ServiceIdView const& id);
};
}

Bedrock 訪問器

C++
namespace ll::service::inline bedrock {
optional_ref<Minecraft> getMinecraft(bool isClientSide = false);
optional_ref<Level> getLevel();
optional_ref<ServerInstance> getServerInstance();
optional_ref<ServerNetworkHandler> getServerNetworkHandler(bool isClientSide = false);
optional_ref<CommandRegistry> getCommandRegistry(bool isClientSide = false);
optional_ref<RakNet::RakPeer> getRakPeer();
optional_ref<NetworkSystem> getNetworkSystem(bool isClientSide = false);
optional_ref<DBStorage> getDBStorage();
optional_ref<ResourcePackRepository> getResourcePackRepository(bool isClientSide = false);
}

使用方法

訪問 Bedrock 實例

C++
#include "ll/api/service/Bedrock.h"

void accessBedrock() {
    auto level = ll::service::getLevel();
    if (level) {
        // 使用 level
    }

    auto serverInstance = ll::service::getServerInstance();
    if (serverInstance) {
        // 使用服务器实例
    }
}

註冊服務

C++
#include "ll/api/service/Service.h"
#include "ll/api/service/ServiceManager.h"

class MyService : public ll::service::ServiceImpl<MyService, 1> {
public:
    void doSomething() {}
    void invalidate() override {}
};

void registerMyService() {
    auto service = std::make_shared<MyService>();
    ll::service::ServiceManager::getInstance().registerService(service, ll::mod::NativeMod::current());
}

使用服務

C++
#include "ll/api/service/ServiceManager.h"

void useService() {
    auto service = ll::service::ServiceManager::getInstance().getService<MyService>();
    if (service) {
        (*service)->doSomething();
    }
}

相關模塊