Introducción
En esta guía, se explican las diferentes maneras en las que la solución Narración en 3D se puede personalizar, lo que te permite crear historias cautivadoras con ubicación geográfica.
Tienes la flexibilidad de configurar su solución de narración a través de dos métodos convenientes. En primer lugar, puedes usar la IU intuitiva disponible en la app de Admin, que incluye un panel de configuración dedicado. En este panel, los usuarios pueden modificar las propiedades principales, como imageUrl, title, date y otras, para la historia general y los capítulos individuales.
En segundo lugar, puedes ajustar la configuración de la cámara y las opciones de enfoque para cada capítulo con la GUI en la app de Administrador. Una vez satisfechos con su configuración, los usuarios tienen la opción de descargar el archivo JSON generado.
Como alternativa, puedes editar directamente el archivo JSON. Puedes ajustar la estructura JSON, cargar la solución de narración configurada y omitir el panel de control del administrador. Este enfoque doble ofrece una interfaz fácil de usar y una manipulación avanzada de JSON.
Primeros pasos:
Habilitar
Crea tu propia historia
El diseño general de la historia se divide en una historia de portada seguida de capítulos.
Tanto la portada como un capítulo se pueden personalizar de forma individual. Consulta
detalles sobre cómo se pueden compilar y personalizar las historias con la app de Admin
y el archivo de configuración.
Portada
Lo primero que debes hacer es crear una página de portada para la historia general. Esto agrega la descripción general, una foto de portada y una descripción a tu historia.
Usar la aplicación Administrador
Empieza por agregar una página de portada para tu historia. Puedes hacerlo desde la app de Administrador en la siguiente pantalla:
Usa config.json
Además, si tienes el archivo de configuración, puedes agregar directamente estas secciones al archivo:
- 1.
imageUrl: Es la URL del archivo multimedia principal (imagen, GIF o video) de toda la historia.
Puede ser cualquier URL de acceso público que dirija a un archivo de imagen, GIF o video que quieras usar como medio principal para toda la historia.
- 2.
title: Es el título de la historia completa. - 3.
date: Es la fecha o el período asociado con la historia. - 4.
description: Es una breve descripción de la historia. - 5.
createdBy: Es el creador o autor de la historia. - 6.
imageCredit: El crédito de la imagen principal. - 7.
cameraOptions: Son los parámetros de configuración iniciales de la cámara para toda la historia.
Capítulos
La historia está dividida en capítulos, cada uno con su propio conjunto de variables. Puedes crear todos los capítulos que quieras. Primero, selecciona una dirección y, luego, agrega los siguientes detalles al capítulo.
Usar la aplicación Administrador
Búsqueda de ubicación: Usa la barra de búsqueda de Autocomplete integrada de Google Maps Platform para encontrar la ubicación que deseas mostrar.
Una vez que se agrega una ubicación, puedes agregar detalles al capítulo. Para ello, haz clic en el botón Edit junto a la ubicación:
Agrega detalles sobre la ubicación:
Una vez que estés satisfecho con la configuración general, descarga el archivo JSON y podrás usarlo en la app de demostración.
Cómo realizar la configuración con config.json
Puedes editar las siguientes variables directamente en el archivo config.json descargado para personalizar cada capítulo:
title: Es el título del capítulo.id: Es el identificador único del capítulo.imageUrl: Es la URL de la imagen del capítulo.imageCredit: El crédito de la imagen del capítulo.content: Es el contenido de texto del capítulo.dateTime: Es la fecha o el período específico del capítulo.coords: Las coordenadas de la ubicación asociada con el capítulolat: Latitud.lng: Longitud.
address: Dirección relacionada con el capítulo.
Configuración de la cámara
La aplicación ofrece muchos controles diferentes para la cámara. En esta sección, se explican los diferentes parámetros de configuración de la cámara y cómo personalizarlos.
(Desplazamiento lateral, zoom e inclina la cámara para obtener el ángulo de visión perfecto).
Usa la app de Administrador
Cámara: Ajusta la velocidad de movimiento y el tipo de órbita de la cámara para crear la experiencia de visualización elegida.
Marcador de ubicación te permite activar o desactivar la opción de ocultar o mostrar un pin en una ubicación específica.
El foco de radio crea una sombra de viñeta alrededor de un área específica sin fijar una ubicación específica. Es ideal para mostrar un vecindario o un área general.
Aquí se muestra cómo cambiar el enfoque de la cámara para mostrar un área en lugar de un punto específico.
Usa config.json
También puedes personalizar todos los parámetros de la cámara directamente con el archivo de configuración JSON:
cameraOptions: Configuración de la cámara para el capítulo. (obtén más información sobre los ángulos de la cámara).position: El parámetro de posición determina las coordenadas espaciales de la cámara en el entorno 3D. Consta de tres valores: x, y y z. Cada coordenada representa un punto en los ejes x, y, y z, que definen la ubicación de la cámara.heading: El parámetro de orientación hace referencia a la dirección horizontal en la que apunta la cámara. En términos geográficos, representa el ángulo entre la vista de la cámara y la dirección norte. Una orientación de 0 indica que la cámara apunta hacia el norte.pitch: El parámetro de inclinación determina el ángulo vertical de la cámara. Significa la inclinación o inclinación de la vista de la cámara. Una inclinación positiva mira hacia abajo, mientras que una negativa apunta hacia arriba.roll: El parámetro de desplazamiento define la rotación alrededor del eje de la cámara. Representa el movimiento de giro de la cámara. Un giro de 0 indica que no hay rotación, mientras que los valores positivos o negativos denotan una rotación hacia la derecha o la izquierda, respectivamente.
focusOptions: Opciones para enfocarte en un punto específico.focusRadius: Radio de enfoque.showFocus: Es un valor booleano para mostrar u ocultar el enfoque.showLocationMarker: Es un valor booleano que muestra u oculta el marcador de ubicación.
Guarda tu configuración
Por último, haz clic en Guardar posición de la cámara para guardar la posición de la cámara y, luego, haz clic en Salir del modo de edición para guardar el trabajo.
Esta aplicación proporciona una interfaz fácil de usar que te permite personalizar la experiencia 3D. Esta es la app de administración.
El archivo config.json final
El archivo config.json final contiene toda la información necesaria para generar tu experiencia de narración personalizada. Incluye los detalles de la página de portada, los capítulos y la configuración de la cámara. Puedes usar este archivo para perfeccionar tu historia y asegurarte de que se vea y se sienta exactamente como quieres.
Para comenzar,descarga el archivo config.json desde la app de administración o crea uno nuevo desde cero. Luego, abre el archivo en un editor de texto y comienza a editar los valores. Puedes cambiar el texto, las imágenes y hasta la configuración de la cámara para crear una experiencia inmersiva y única para tu público.
Un archivo JSON de descripción general de una historia puede verse de la siguiente manera:
{
"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
}
}
Y un capítulo específico puede verse así. Capítulos es un array y pueden tomar muchos capítulos individuales dentro del array.
"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
}
},
Personalización avanzadas
Puedes profundizar en el código y hacer varias personalizaciones más:
Carga el archivo de configuración desde otra ubicación
De manera predeterminada, la solución carga la configuración de narración desde un archivo local . Sin embargo, esto se puede cambiar con facilidad en config.js:
export async function loadConfig(configUrl) {
try {
// Fetch the configuration data from the specified URL.
const configResponse = await fetch(configUrl);
Configuraciones de la cámara
La cámara se puede personalizar aún más a partir del archivo /utils/cesium.js.
Define una cantidad de variables importantes, como las siguientes:
- RADIUS
- BASE_PITCH_RADIANS
- BASE_HEADING_RADIANS
- BASE_ROLL_RADIANS
- DEFAULT_HIGHLIGHT_RADIUS
Puedes modificar estas variables para obtener varios ángeles y experiencias de cámara.
Conclusión
En este documento, proporcionamos una guía para personalizar la aplicación de narración en 3D. Exploramos las diversas opciones disponibles en la app de Admin y cómo se pueden usar para crear historias de ubicación geográfica envolventes y atractivas. También analizamos el proceso de creación de una historia personalizada con el archivo config.json. Próximos pasos
Ahora que aprendiste a personalizar la aplicación de narración en 3D, puedes empezar a crear tus propias historias. A continuación, te presentamos algunas ideas para comenzar:
- Crea una historia sobre tu ciudad natal o un lugar que hayas visitado.
- Crea un relato sobre un acontecimiento histórico o una persona que te haya inspirado.
- Crea una historia sobre un mundo ficticio o un sueño que hayas tenido.
Las posibilidades son infinitas. Así que deja volar tu imaginación y crea algo realmente especial.