Scene-based Content
Principle of Scenes
Scenes are a fundamental concept in video editing and storytelling. They allow for the logical grouping of video cuts to represent a coherent segment of the narrative. Here are the key principles:
- Video Cuts: A video is divided into multiple cuts, which are individual segments of footage.
- Scene Composition: Cuts can be combined to form a scene. For example, a dialog between two characters can be represented using the "shot/reverse shot" technique, where alternating shots show each character speaking.
- Scene Re-use: The same scene can appear multiple times in a video. For instance, a flashback within a dialog may reuse a previously shown scene.
- Cut Lists: Some video editing software can generate cut lists, which can be imported into the Curator for easier scene management.
- Group and Item Assignment: Groups (e.g., characters, props) and items (e.g., specific costumes, objects) can be assigned to a scene to enrich its context and interactivity.
Basic Flow
The process of integrating scene-based content involves the following steps:
- Load Episode Information: At the start of the content, the integrator loads basic episode metadata, such as title, duration, and available scenes.
- User Interaction: The user can pause the video or press a trigger button at any point to interact with the content.
- Request Scene Data: The application sends a request to the scenes API, optionally including parameters like
filterTime
orfilterTimecode
to specify the current timecode. - Fetch and Display Items: The API returns the linked items for the scene, such as characters, props, or locations. These items are then fetched in detail and displayed to the user for interaction or exploration.
Example Code
// Example: Fetching scenes based on timecode
const axios = require('axios');
async function fetchScenes(timecode) {
try {
const response = await axios.get('https://api.jayplatform.com/scenes', {
params: {
filterTimecode: timecode
}
});
console.log('Scenes:', response.data);
} catch (error) {
console.error('Error fetching scenes:', error);
}
}
// Usage
fetchScenes('00:10:15'); // Fetch scenes at 10 minutes and 15 seconds
Related API Requests
Creative Applications of Data Structures
Creative applications allow integrators to enhance the user experience by leveraging existing data structures to add more context and interactivity to scenes. These applications include:
Create a Look of an Actor: By linking a character to multiple costumes within the same group, integrators can showcase different appearances of an actor in a scene. For example, a character might wear a formal outfit in one part of the scene and a casual outfit in another. This feature is particularly useful for creating immersive storytelling or enabling users to explore character details.
Showcase a Set: By linking a location to multiple props within the same group, integrators can provide a detailed view of the set. For instance, a living room scene might include props like furniture, decorations, and personal items. This feature helps users explore the environment and understand the context of the scene more deeply.