worldAlignment

空间场景的初始化属性之一，worldAlignment 会影响空间场景创建后被用户拖拽在垂直方向上移动时的行为。 只有 volume 类型的空间场景才支持 worldAlignment。

适用范围与设置方式

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

类型定义

"automatic" | "gravityAligned"

示例

使用 initScene

通过 initScene 设置新场景的 worldAlignment

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

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

使用 Web App Manifest

Manifest 属性命名

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

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

{
  "name": "example app",
  "start_url": "/",
  "xr_main_scene": {
    "type": "volume",
    "world_alignment": "gravityAligned"
  }
}

默认值

"automatic"

可接受的值

取值	含义
"automatic"	上下移动时会自动倾斜，始终朝向用户。
"gravityAligned"	上下移动时不会自动倾斜，始终和重力方向对齐，更像现实世界中的物体。