# Stories

## **Overview**

The Story Mode feature enables users to create guided, narrative-driven experiences through a configurable slideshow system. Users can build a sequence of slides, each associated with a specific location in the scene. As the slideshow progresses, the camera automatically teleports to the location defined for each slide, presenting the content in a structured and immersive manner. Each slide can be customized with timing and descriptive text, allowing users to control both the pacing and context of the story. When played, the slideshow advances automatically based on the configured settings, looping continuously to support repeated playback.

## Features

* Create and manage a sequence of slides within Story Mode
* Assign a specific world location to each slide
* Automatically teleport the camera to the slide’s location during playback
* Configure the duration of each slide individually
* Add custom text or descriptions to provide context or narration
* Play and loop the slideshow automatically based on user-defined settings

## How to Use&#x20;

To begin using **Story Mode**, open the **Actions** menu and select **Stories**. This action launches the Story Mode interface, which appears as a dedicated panel along the bottom of the screen. The panel serves as the primary workspace for creating, configuring, and managing slideshow-based story content, providing access to all controls required to build and play your story sequence.

<figure><img src="/files/QFgNLRdN6SzFbRzk9EyN" alt=""><figcaption></figcaption></figure>

Click the **plus (+) button** to capture a snapshot of your current camera view. This snapshot is added as a new entry in the **Stories slot** on the bottom panel.

<figure><img src="/files/EGcKizMzQaf3or6yVXGG" alt=""><figcaption></figcaption></figure>

Once a new item is added to the **Stories** slot, a thumbnail is displayed for that entry. You can assign a title directly to the story, and if needed, click the **camera icon** to retake the thumbnail, which will replace it with a snapshot of your current view. When you are ready, click the thumbnail to open the slideshow tab on the right of the screen

<figure><img src="/files/W3GP27rZPUmC0NhrB1vo" alt=""><figcaption></figcaption></figure>

Before proceeding, you must add **at least one slide** using the **Add (+)** button in the top-right corner. Clicking this button saves your **current camera position and orientation** for the slide. When the slideshow is played—or when you navigate to this slide—the camera will automatically teleport back to this saved view.\
Make sure your camera view is set exactly as desired **before** adding the slide.

<figure><img src="/files/VCvohim1Y3DS4rBEJKfu" alt=""><figcaption></figcaption></figure>

You can now **add a title and description** for the slide using the fields on the right panel.

* **Title**: Enter a short, descriptive name for the slide (e.g., *Park View*). This helps identify the slide within the story and provides context during playback.
* **Description**: Add supporting text to explain what the viewer is seeing or why this location is important. This text is shown alongside the slide while the story is playing.

Both the title and description are saved with the slide and will be displayed whenever this slide is active during the slideshow.

<figure><img src="/files/QMdYrH3SW3zPm9sEJFf1" alt=""><figcaption></figcaption></figure>

At the bottom of the panel, you can **control slideshow playback**. From here, you can play or pause the slideshow, manually navigate between slides using the **Previous** and **Next** buttons, and adjust the **slideshow duration**. As the slideshow progresses, the camera will automatically teleport to each slide’s saved location when that slide becomes active, while the corresponding slide content updates in the panel.

<figure><img src="/files/uRQgjPcJ2OUI5pZKUobH" alt=""><figcaption></figcaption></figure>

If you want to remove a slide from the slideshow, click the **trash icon** located at the top of the slide panel. This will delete the currently selected slide from the story.

<figure><img src="/files/sQzGmtjtTNjDG7B1bndo" alt=""><figcaption></figcaption></figure>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.aeroai.io/siega-features/actions/stories-1.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
