Clip - BlendDuck

Clip is a container for visual and audio elements, with its own duration and transition effects.

Properties

Property	Type	Default	Description
id	string	`uuid()`	A unique identifier for the clip.
duration	number	`5`	The length of the clip in seconds.
durationLock	boolean	`false`	A boolean indicating whether the duration is locked or can be adjusted in the editor.
transition	string	`none`	The type of transition effect when moving to the next clip（e.g., `none`, `fade`, `wipe`, `flip`, `slide`, `clock`)
elements	array	`[]`	An array of Element objects contained within the clip
audios	array	`[]`	An array of AudioPlay objects for audio tracks in the clip
background	object	`null`	Optional background settings for the clip, which can override the project’s theme

Usage

Here’s an example of how to create and customize a Clip using the BlendDuck SDK:

import BlendDuck, { Clip, Text, AudioPlay } from "@blendduck/node-sdk";

const clip = new Clip(5); // Create a 5-second clip
clip.transition = 'fade';

// Add a text element to the clip
const textElement = new Text();
textElement.text = "Hello, BlendDuck!";
clip.addElement(textElement);

// Add an audio track to the clip
const audio = new AudioPlay({ url: "https://s.blendduck.com/audios/motivation.mp3" });
clip.addAudioPlay(audio);

// Set a custom background for this clip
clip.background = {
  color: {
    type: "color",
    color: "#00ff33ff"
  }
};

Get the final JSON representing of the Clip

const json = clip.toJSON();

You can create Clip by JSON directly

const clip = Clip.fromJSON(json)