PlaylistEmbed

PlaylistEmbed displays a video player with a scrollable playlist sidebar.

import { PlaylistEmbed } from "@seeen/embed/playlist";

<PlaylistEmbed
  videos={[
    { id: "1", title: "Episode 1", src: "https://example.com/ep1.m3u8", duration: 342 },
    { id: "2", title: "Episode 2", src: "https://example.com/ep2.m3u8", duration: 518 },
  ]}
/>

Props

Prop	Type	Required	Description
initialIndex	number	optional	Zero-based index of the video to play first. Defaults to `0`.
overlays	CtaOverlay[]	optional	CTA image overlays applied to every video in the playlist.
videos	VideoItem[]	required	Ordered list of videos in the playlist.

VideoItem

Prop	Type	Required	Description
aspectRatio	string	optional	Aspect ratio string from the API, e.g. `"16:9"` or `"9:16"`.
description	string	optional	Optional description of the video content.
duration	number	optional	Duration in seconds. Used in playlist UI.
id	string | number	required	Unique identifier for the video.
poster	string	optional	URL of the poster image shown before playback begins.
shareSocialMediaIcons	SocialMediaIcon[]	optional	Social share icons shown in the share popover.
sponsor	Sponsor	optional	Sponsor shown on the end card.
src	string	required	URL of the video source. HLS (`.m3u8`) and MP4 are supported.
startTime	number	optional	Start playback at this position in seconds. Useful for moment clips.
thumbnailStoryboardUrl	string	optional	URL of a WebVTT thumbnail storyboard used for scrubber previews.
title	string	required	Display title of the video.