3D 讲故事:自定义指南

简介

本指南将向您介绍自定义 3D 故事解决方案的不同方式,从而创建引人入胜的地理定位故事。

您可以通过两种便捷的方法灵活配置他们的故事讲述解决方案。最有用的是,您可以使用 Admin 应用中提供的直观界面,其中包含一个专用的配置面板。在此面板中,用户可以修改整个故事和各个章节的主要属性,例如 imageUrl、标题、日期等。

其次,您可以使用管理应用中的 GUI 微调每个章节的相机设置和焦点选项。对配置感到满意后,用户可以选择下载生成的 JSON 文件。

或者,您也可以直接修改 JSON 文件。 您可以调整 JSON 结构,加载已配置的故事讲述解决方案,并绕过管理控制台。这种双重方法同时提供了方便用户使用的界面和高级 JSON 操作。

开始使用:

启用

创作你自己的故事

故事的总体布局分为一个封面故事和多个章节。 封面和章节均可单独自定义。查看
有关如何使用 Admin 应用和配置文件构建和自定义故事的详细信息。

封面

首先,您需要为整个故事创建一个封面页。这会为您的故事添加概览、封面照片和说明。

使用“管理”应用

首先,为您的故事添加封面页。您可以通过“管理”应用使用以下屏幕执行此操作:

图片

使用 config.json

此外,如果您有配置文件,则可以直接在该文件中添加以下部分:

  • 1. imageUrl:整个故事的主媒体文件(图片、GIF 或视频)的网址。

该网址可以是任何可公开访问的网址,指向您要用作整个故事主媒体的图片、GIF 或视频文件。

  • 2. title:整个故事的标题。
  • 3. date:与故事关联的日期或时间范围。
  • 4. description:故事的简要说明。
  • 5. createdBy:故事的创作者或作者。
  • 6. imageCredit:主图片的功劳。
  • 7. cameraOptions:整个故事的初始镜头设置。

章节

这个故事分为几个章节,每个章节都有自己的一组变量。您可以创建任意数量的章节。首先选择一个地址,然后向这一章节添加以下详细信息。

使用“管理”应用

位置搜索:使用集成式 Google Maps Platform 自动补全搜索栏来查找要显示的位置。

添加位置后,您可以通过点击位置旁边的 Edit 按钮向章节添加详细信息:

图片

添加关于地点的详细信息:

如果您对整体配置感到满意,请下载 json 文件,然后即可在演示版应用中使用该文件。

使用 config.json 进行配置

您可以直接在下载的 config.json 文件中修改以下变量,对每个章节进行自定义:

  • title:章节标题。
  • id:章节的唯一标识符。
  • imageUrl:章节图片的网址。
  • imageCredit:章节图片标注信息。
  • content:章节的文本内容。
  • dateTime:章节特定的日期或时间范围。
  • coords:与该章节关联的地点的坐标。
    • lat:纬度。
    • lng:经度。
  • address:与章节相关的地址。

相机设置

该应用在相机上提供了许多不同的控件。本部分介绍了不同的相机设置以及如何自定义这些设置。

图片

(平移、缩放、倾斜镜头以获得完美的视角)

使用“管理”应用

镜头:调整镜头的移动速度和轨道类型,以打造所选的观看体验。

  • 通过位置标记,您可以选择在特定位置显示图钉或隐藏图钉。

  • 半径对焦可在特定区域周围创建晕影阴影,而无需精确定位具体位置。非常适合显示社区或大致区域。

图片

此图展示了如何通过更改镜头的焦点来展示某个区域,而不是特定点。

使用 config.json

您还可以使用 json 配置文件直接自定义所有相机参数:

  • cameraOptions:章节的相机设置。(详细了解镜头角度

    • position:位置参数用于确定 3D 环境中相机的空间坐标。它包含三个值:x、y 和 z。每个坐标都代表 x 轴、y 轴和 z 轴上的一个点,用于定义镜头的位置。

    • heading:朝向参数是指相机所指向的水平方向。在地理上,它表示镜头视图与北方方向之间的角度。方向角为 0 表示镜头指向正北。

    • pitch:俯仰参数用于确定镜头的垂直角度。它表示镜头视野的倾斜度或倾斜度。正的音高表示向下,而负的音高表示向上。

    • roll:滚动参数定义围绕镜头轴的旋转。它表示相机的扭转运动。旋转值为 0 表示不旋转,正值或负值分别表示向右或向左旋转。

  • focusOptions:用于聚焦特定时间点的选项。

  • focusRadius:对焦的半径。

  • showFocus:用于显示或隐藏焦点的布尔值。

  • showLocationMarker:用于显示或隐藏位置标记的布尔值。

保存配置

最后,点击保存镜头位置以保存镜头位置,然后点击退出修改模式以保存您的工作

图片

此应用提供了一个方便用户使用的界面,让您可以自定义 3D 体验。这是 Admin 应用。

最终的 config.json

最终的 config.json 文件包含生成您的自定义故事讲述体验所需的所有信息。其中包含封面详细信息、章节和相机设置。您可以使用此文件对您的故事进行微调,并确保其外观和风格完全符合您的预期。

如需开始使用,请从“管理”应用下载 config.json 文件,或从头开始创建一个新文件。然后,在文本编辑器中打开该文件并开始修改值。您可以更改文字、图片甚至相机设置,为您的受众群体打造沉浸式独特体验。

故事概览 JSON 文件可能如下所示:

{
  "properties": {
    "imageUrl": "https://storage.googleapis.com/gmp-3d-tiles-storytelling/assets/images/317-300x160.jpg",
    "title": "Title",
    "date": "1967",
    "description": ""his is where you put descriptions",
    "createdBy": "Add author",
    "imageCredit": "Add image credit",
    "cameraOptions": {
      "position": {
        "x": -2708127.031960028,
        "y": -4260747.583520751,
        "z": 3886346.825328216
      },
      "heading": -1.5708,
      "pitch": -0.785398,
      "roll": 0
    }
  }

具体章节可如下所示。章节是一个数组,数组中可以包含多个单独的章节。

"chapters": [
    {
      "title": "The Jimmy Hendrix Experience",
      "id": 4,
      "imageUrl": "https://storage.googleapis.com/gmp-3d-tiles-storytelling/assets/images/401-300x160.jpg",
      "imageCredit": "Hunter",
      "content": "XYZZZ",
      "dateTime": "Aug 10-12 1967",
      "coords": {
        "lat": 37.7749,
        "lng": -122.4194
      },
      "address": "The Filmore | 1805 Geary Blvd",
      "cameraOptions": {
        "position": {
          "x": -2706472.5713478313,
          "y": -4261528.277488908,
          "z": 3885143.750529967
        },
        "heading": 0,
        "pitch": 0,
        "roll": 0
      },
      "focusOptions": {
        "focusRadius": 3000,
        "showFocus": false,
        "showLocationMarker": true
      }
    },

高级自定义

您可以深入了解代码,并可以进行其他几项自定义:

从其他位置加载配置文件

该解决方案开箱即可从本地文件加载故事讲述配置。不过,您可以在 config.js 中轻松更改此网址:

export async function loadConfig(configUrl) {
  try {
    // Fetch the configuration data from the specified URL.
    const configResponse = await fetch(configUrl);

相机配置

您可以通过 /utils/cesium.js 文件进一步自定义相机。它定义了许多重要变量,例如:

  • 半径
  • BASE_PITCH_RADIANS
  • BASE_HEADING_RADIANS
  • BASE_ROLL_RADIANS
  • DEFAULT_HIGHLIGHT_RADIUS

您可以随意调整这些变量,以获取各种镜头角度和体验。

总结

在本文档中,我们介绍了如何自定义 3D Storytelling 应用。我们已经探讨了 Admin 应用中提供的各种选项,以及如何使用它们来创建引人入胜的沉浸式地理定位故事。我们还讨论了使用 config.json 文件创建自定义故事的过程。后续步骤

现在,您已经学习了如何自定义 3D Storytelling 应用,可以开始创建自己的故事了。以下这些方法可帮助您顺利入门:

  • 创作一个关于您的家乡或您去过的地点的故事。
  • 创作关于历史事件或鼓舞人心的人的故事。
  • 创作关于虚构世界或梦想的故事。

有无限可能!所以放任自己的想象力,创作出真正独一无二的作品