Skip to main content
每个当前启用的交互章节都有可分享 URL。section 可以指向启用的内置 ID，也可以指向 interactive 自定义资产的 custom-* ID。 Every currently enabled interactive chapter has a shareable URL. section may target an enabled built-in ID or an interactive custom asset’s custom-* ID.

​
URL 格式 / URL Format

深链接使用查询参数，不使用独立的页面路径。这让所有当前启用的交互章节都可以从同一个单页入口直接访问，刷新或分享后仍能恢复状态。 Deep links use query parameters, not separate page paths. This lets every currently enabled interactive chapter use the same single-page entry point, with state restored on refresh or when a shared link is opened.

​
完整章节 ID 列表 / Complete List of Section IDs

以下是 12 个默认内置章节 ID： These are the 12 default built-in section IDs:
scene.disabledCoreAssets 中的内置 ID 暂时不是有效入口；重新激活后恢复。Interactive 自定义资产使用自己的 custom-* ID。Decorative 自定义资产没有详情页或深链接。A built-in ID in scene.disabledCoreAssets is temporarily unavailable and returns when reactivated. Interactive custom assets use their own custom-* IDs. Decorative custom assets have no detail page or deep link.

​
示例 URL / Example URLs

​
浏览器行为 / Browser Behavior

刷新恢复 / Refresh Restores

在章节页面刷新浏览器，页面会自动重新打开同一章节，不会回到空房间。Refreshing the browser while a chapter is open automatically reopens the same chapter — it does not fall back to an empty room.

返回键返回房间 / Back Button Returns to Room

打开章节后，浏览器返回键会关闭内容面板并返回 3D 房间，行为与普通网页导航一致。After opening a chapter, the browser back button closes the content panel and returns to the 3D room, behaving like standard web navigation.

Esc 关闭章节 / Esc Closes Chapter

按键盘 Esc 键可随时关闭当前打开的章节面板，等同于点击面板右上角的关闭按钮。Press Esc at any time to close the currently open chapter panel. This is equivalent to clicking the close button in the panel’s top-right corner.

链接可分享 / Links Are Shareable

你可以直接复制浏览器地址栏中的 URL 分享给他人。接收方打开链接后会直接进入指定章节，无需从房间手动点击进入。Copy the URL from your browser’s address bar and share it directly. Recipients will open directly to the specified chapter without needing to navigate through the room.
1

打开任意章节 / Open Any Chapter

在 3D 房间中点击任意资产，内容面板打开后，浏览器地址栏的 URL 会自动更新，加入对应的 ?section=<id> 参数。Click any asset in the 3D room. Once the content panel opens, the browser address bar automatically updates to include the corresponding ?section=<id> parameter.
2

复制 URL / Copy the URL

直接从地址栏复制 URL。如果需要同时指定语言，可以手动在 URL 中加入 &lang=en 或 &lang=zh。Copy the URL directly from the address bar. If you want to specify a language, manually add &lang=en or &lang=zh to the URL.
3

分享链接 / Share the Link

将链接粘贴到邮件、消息或任意平台。接收方点击链接后会直接看到指定章节的完整内容。Paste the link into an email, message, or any platform. Recipients who click the link will see the specified chapter’s full content immediately.

​
为什么使用查询参数而非独立路径 / Why Query Parameters Instead of Separate Paths

深链接使用查询参数（/?section=music）而非独立页面路径（/music），这一设计有以下优势： Deep links use query parameters (/?section=music) rather than separate page paths (/music). This design choice has several advantages:
  • 无需逐章节配置路由 / No per-chapter routes — 所有启用的交互章节通过同一入口访问，服务端无需为每个 ID 维护独立路由。/ Every enabled interactive chapter is reached from one entry point, with no server-side route per ID.
  • 刷新即可恢复状态 / Refresh restores state — 不依赖复杂的浏览器历史 API 状态管理。/ Works without complex History API state management.
  • 语言参数可直接拼接 / Language parameter composes directly — 语言与章节可同时指定，例如 /?lang=en&section=music。/ Both language and section can be specified in one URL, e.g. /?lang=en&section=music.
  • 渲染器只初始化一次 / Renderer initializes only once — 单页入口确保 3D 场景无论打开哪个章节都无需重建。/ The 3D scene is built once regardless of which chapter is opened.
面向国际受众分享时，始终在链接中包含语言参数。/ Always include the language parameter when sharing with international audiences.例如，将以下链接分享给英语受众，可以确保他们直接看到英文版的音乐章节，无需手动切换语言：For example, share the following link with an English-speaking audience to ensure they land directly on the English version of the music chapter, without needing to manually switch languages:
对于中文受众，使用：For Chinese-speaking audiences, use: