arteurope

1. Overview

The Scene Recorder generates a list of scenes, each scene contains:

• scrollTo: ID of the <section> element to scroll to at the start of the scene
• duration: duration of the scene in seconds (automatically calculated)
• triggers: list of actions within the scene (text, audio, video)

Basic principle:

The first trigger of a scene starts the timeline (time: 0). All following triggers are relative to this scene time. Audio and video timings are always separate from the scene time.

2. Scene Structure

Example of a typical scene in JSON:

{
  "scrollTo": "sectionID",
  "duration": 8,
  "triggers": [
    {
      "time": 0,
      "text": "Here comes the text",
      "audio": "../files/audio.mp3",
      "audioStart": 0,
      "audioEnd": 8,
      "audioVolume": 0.8
    },
    {
      "time": 2,
      "video": "videoPlayer1",
      "videoSrc": "../files/loop.mp4",
      "loopVideo": true
    }
  ]
}

Field explanations:

3. Example – Immediate Audio Comment

Scenario: Scroll to textScene1, audio starts immediately, lasts 8 seconds, then the scene ends.

{
  "scrollTo": "textScene1",
  "duration": 8,
  "triggers": [
    {
      "time": 0,
      "text": "Mid-century armchair",
      "audio": "../files/Dose-Commentary.mp3",
      "audioStart": 0,
      "audioEnd": 8,
      "audioVolume": 0.8
    }
  ]
}

• time: 0 → starts immediately after scroll
• duration: 8 → ends after 8 seconds
• Audio plays for exactly 8 seconds
• Scene can transition smoothly to the next scene

4. Rules for Correct Scenes

• First trigger = time 0 → avoids idle time at the start of the scene.
• Scene duration = longest trigger → audio or video duration determines scene end.
• Audio and video timings are separate → time = when triggered in scene, audioStart/audioEnd = portion in audio file
• Always scroll to scrollTo → ensures a clean scene entry.
• Undo / editing → changes can be corrected in the recorder before export.