API 参考

SpatialSession

为 C++ 与 PySide6 应用作用域持有 Spatial 插件注册。

继承自 QObject

explicit SpatialSession(QObject* host = nullptr, QObject* parent = nullptr)

bool activate(QString* error = nullptr): 激活已注册的 Spatial 插件；重复调用为空操作。
bool deactivate(QString* error = nullptr): 暂停追踪视图并释放粒子代理，不销毁交付对象。
bool isActive() const
SpatialView* createView(QWidget* parent = nullptr): 激活时创建指定父对象的视图；父对象为空时由调用方直接持有。
bool attachView(SpatialView* view): 追踪调用方已有视图，包括自定义子类，不改变父对象或所有权。
ParticleLayer* createParticleLayer(particles::ParticleBackdrop* backdrop, QObject* parent = nullptr): 激活时为借用粒子源创建调用方持有的适配器。
bool prepareWindow(windowing::Window* window): 不创建 GPU 上下文地准备隐藏窗口；停用时返回 false。
bool prepareWindow(windowing::Window* window, QSurface::SurfaceType surfaceType)

Qt 基类完整成员：QObject