baseplateVisibility

空间场景的初始化属性之一。只有 volume 类型的空间场景才支持设置 baseplateVisibility，它会影响 Volume 下方底板的可见性。

适用范围与设置方式

项目	内容
适用于	仅适用于 volume 类型空间场景。
新场景	通过 initScene 设置。
起始场景	通过 Web App Manifest 设置。
默认值	"automatic"

类型定义

"automatic" | "hidden"

示例

使用 initScene

通过 initScene 设置新场景的 baseplateVisibility

import { initScene } from "@webspatial/react-sdk";

initScene("newSceneName", defaultConfig => {
  return {
    ...defaultConfig,
    type: "volume",
    baseplateVisibility: "hidden",
  };
});
window.open(newSceneUrl, "newSceneName");

使用 Web App Manifest

Manifest 属性命名

在 Web App Manifest 里，建议把 baseplateVisibility 这样的驼峰属性名改成 baseplate_visibility 这样的全小写下划线写法。

通过 Web App Manifest 设置起始场景的 baseplate_visibility

{
  "name": "example app",
  "start_url": "/",
  "xr_main_scene": {
    "type": "volume",
    "baseplate_visibility": "hidden"
  }
}

默认值

"automatic"

可接受的值

取值	含义
"automatic"	底板按需显示。
"hidden"	底板始终隐藏。