Skip to main content

快速入门

本指南将帮助你从零开始创建第一个 OSC2 场景。

访问 OSC2 Studio

  1. 打开浏览器,访问 osc2studio.online
  2. 点击首页的 "Launch Studio →" 按钮,或导航栏的 "启动编辑器" 链接
  3. 进入 /app/ 后,你将看到登录页面

登录 / 注册

注册账号

  1. 点击"注册"选项卡
  2. 输入邮箱地址和密码
  3. 点击注册按钮,完成注册后自动登录

游客登录

  • 点击"游客登录"按钮,无需注册即可体验编辑器功能
  • 游客模式下部分功能受限(无法保存到云端)

界面概览

登录后,编辑器界面分为以下几个区域:

区域功能
左侧面板工作空间:管理场景和地图文件
中央区域编辑器:编写 OSC2 代码
右侧面板场景预览:3D 可视化场景
底部面板问题面板:显示验证错误和警告
顶部工具栏新建、保存、验证、预览控制

创建第一个场景

步骤 1:新建场景文件

  1. 在左侧工作空间面板中,点击 "+ 新建场景" 按钮
  2. 输入文件名,例如 my-first-scenario.osc
  3. 点击确认,文件将出现在工作空间列表中

步骤 2:编写场景代码

双击打开 my-first-scenario.osc,在编辑器中输入以下代码:

import std.base

scenario my_first_scenario:
do serial:
car: vehicle with:
speed: 36 km/h
position: lane at(1, 0, 0) of Road_0

编辑器将自动高亮语法关键字并提供代码补全建议。

步骤 3:验证场景

点击工具栏的 "验证" 按钮(或按 Ctrl+Shift+V),验证结果将显示在底部问题面板中。如果代码正确,将显示"验证通过"。

步骤 4:预览场景

点击 "预览" 按钮,右侧面板将加载 3D 场景。你可以使用播放控制按钮播放、暂停和回放场景。

下一步