简介
本指南将向您介绍自定义 3D 故事讲述解决方案的不同方式,让您能够创作出引人入胜的地理定位故事。
您可以通过两种便捷的方法灵活地配置故事讲述解决方案。首先,您可以使用 Admin 应用中提供的直观界面,其中包含专用配置面板。在此面板中,用户可以修改整个故事和各个章节的主要属性,例如 imageUrl、title、date 等。
其次,您可以使用管理员应用中的 GUI 微调每个章节的摄像头设置和对焦选项。对配置感到满意后,用户可以选择下载生成的 JSON 文件。
或者,您也可以直接修改 JSON 文件。 您可以调整 JSON 结构、加载已配置的故事讲述解决方案,以及绕过管理控制台。这种双重方法既提供了方便用户使用的界面,又提供了高级 JSON 操作。
使用入门:
启用
创作你自己的故事
故事的整体布局分为封面故事和章节。
封面和章节可单独自定义。查看
有关如何使用管理员应用和配置文件构建和自定义故事的详细信息。
封面
您首先需要为整个故事创建一个封面页。此操作会为您的故事添加概览、封面照片和说明。
使用管理员应用
首先,请为故事添加封面。您可以在“管理”应用中使用以下屏幕执行此操作:
使用 config.json
此外,如果您有配置文件,则可以直接在该文件中添加以下部分:
- 1.
imageUrl
:整个故事的主媒体文件(图片、gif 或视频)的网址。
可以是任何可公开访问的网址,且指向您要用作整个故事的主媒体的图片、GIF 或视频文件。
- 2.
title
:整个故事的标题。 - 3.
date
:与故事关联的日期或时间范围。 - 4.
description
:故事的简要说明。 - 5.
createdBy
:故事的创作者或作者。 - 6.
imageCredit
:主图片的演职员表。 - 7.
cameraOptions
:整个故事的初始相机设置。
章节
故事分为多个章节,每个章节都有自己的一套变量。您可以根据需要创建任意数量的章节。 首先选择一个地址,然后将以下详细信息添加到章节中。
使用管理员应用
营业地点搜索:使用集成的 Google Maps Platform 自动补全搜索栏查找要显示的地点。
添加位置后,您可以点击该位置旁边的修改按钮,为章节添加详细信息:
添加有关该位置的详细信息:
对整体配置感到满意后,下载 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
: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 故事应用的指南。我们探索了“管理”应用中可用的各种选项,以及如何使用这些选项来创作引人入胜的沉浸式地理位置故事。我们还讨论了使用 config.json 文件创建自定义故事的过程。后续步骤
现在,您已经学习了如何自定义 3D 故事应用,接下来可以开始创建自己的故事了。以下这些方法可帮助您顺利入门:
- 创作有关您的家乡或去过的地方的故事。
- 讲述一个关于历史事件或者某个曾给你启发的人的故事。
- 创作一个关于虚构世界或你梦想的故事。
无限可能!尽情发挥您的想象力 创作一些特别的东西吧