模型加载

2026-04-13

123 words

1 min

模型在加载时，允许传入加载选项，用于定义模型的位置、缩放等属性

l2d.load({
  path: 'https://model.hacxy.cn/cat-black/model.json',
}).then(() => {
  message.success('模型加载成功');
});

你可以在一个实例中多次调用load方法，以重新加载模型或者切换模型。下面这个例子中：加载完黑猫的3秒后自动切换为白猫

const models = [
  'https://model.hacxy.cn/cat-black/model.json',
  'https://model.hacxy.cn/cat-white/model.json',
];
let current = 0;

l2d.load({ path: models[current] });

let countdown = 3;
const msg = message.info(`${countdown} 秒后切换模型`, { duration: 0 });
const timer = setInterval(async () => {
  countdown--;
  if (countdown > 0) {
    msg.content = `${countdown} 秒后切换模型`;
  }
  else {
    clearInterval(timer);
    msg.destroy();
    current = (current + 1) % models.length;
    l2d.destroy(); // 销毁当前模型模型
    await l2d.load({ path: models[current] }); // 切换到下一个模型
    message.success('模型已切换');
  }
}, 1000);

以下是load方法中所有可传的选项

path

path: string

模型配置文件路径（.model.json 或 .model3.json）

---

position（可选）

optional position?: [number, number]

模型位置偏移 [x, y]，x 正值右移，y 正值上移，范围通常为 -2 ~ 2

示例： [0.5, -0.2]

---

scale（可选）

optional scale?: number

模型缩放比例，1 为原始大小

示例： 0.5

---

logLevel（可选）

optional logLevel?: "error" | "warn" | "info" | "trace"

日志输出级别，默认 'warn'。设为 'trace' 可查看详细加载日志，设为 'error' 可屏蔽警告。