Service(服務系統)
ll/api/service/ · 通用 / 服務端 / 客戶端
概述
Service 模塊提供了用於依賴注入的服務註冊表,以及訪問 Bedrock 引擎內部組件的接口,如 Minecraft、Level、ServerInstance 和 CommandRegistry。
頭文件
| 頭文件 | 說明 |
|---|---|
ll/api/service/Service.h | 服務基類 |
ll/api/service/ServiceManager.h | 服務註冊表 |
ll/api/service/Bedrock.h | Bedrock 引擎訪問器 |
核心類
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();
}
}相關模塊
- Event(事件系統) —
ServiceRegisterEvent、ServiceUnregisterEvent