跳到主要内容

defaultSize

空间场景的初始化属性之一，defaultSize 会影响空间场景刚创建完成时的大小；最终结果不一定与 defaultSize 中的值完全一致，因为要优先遵循操作系统的空间计算逻辑。

适用范围与设置方式​

项目内容
适用于window 类型场景支持 width 和 height；volume 类型场景还支持 depth。
新场景通过 initScene 设置。
起始场景通过 Web App Manifest 设置。
默认值无

类型定义​

defaultSize 类型
{
  width?: number | string
  height?: number | string
  depth?: number | string
}

示例​

使用 initScene​

通过 initScene 设置新场景的 defaultSize
import { initScene } from "@webspatial/react-sdk";

initScene("newSceneName", defaultConfig => {
  return {
    ...defaultConfig,
    type: "volume",
    defaultSize: {
      width: 500,
      height: "1000px",
      depth: "1m",
    },
  };
});
window.open(newSceneUrl, "newSceneName");

使用 Web App Manifest​

Manifest 属性命名

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

通过 Web App Manifest 设置起始场景的 default_size
{
  "name": "example app",
  "start_url": "/",
  "xr_main_scene": {
    "default_size": {
      "width": 500,
      "height": "1000px"
    }
  }
}

默认值​

无

可接受的值​

字段可接受的值
width数字（默认单位是 px）或带单位后缀的字符串，比如 "100px"、"2m"。
height数字（默认单位是 px）或带单位后缀的字符串，比如 "100px"、"2m"。
depth数字（默认单位是 px）或带单位后缀的字符串，比如 "100px"、"2m"。