类型定义

所有类型从 @hls-downloader/shared（或 @logosw/hls-downloader/shared）导出。

Segment

type Segment = {
  uri: string
  [key: string]: any
}

表示单个 HLS 分片，包含 URI 及播放列表中的其他属性。

Playlist

type Playlist = {
  name: string
  bandwidth: number
  uri: string
}

表示主播放列表中的变体流。

ParseHlsResult

type ParseHlsResult =
  | { type: 'playlist'; data: Playlist[]; message?: undefined }
  | { type: 'segment'; data: Segment[]; message?: undefined }
  | { type: 'error'; data?: undefined; message: string }

parseHls() 返回的可辨识联合类型：

• playlist — URL 指向包含变体流的主播放列表
• segment — URL 指向包含分片的媒体播放列表
• error — 解析失败，附带错误信息

HlsDownloaderEvent

enum HlsDownloaderEvent {
  FFMPEG_LOADING = 'ffmpeg-loading',
  FFMPEG_LOADED = 'ffmpeg-loaded',
  STARTING_DOWNLOAD = 'starting-download',
  SOURCE_PARSED = 'source-parsed',
  DOWNLOADING = 'downloading',
  DOWNLOADING_SEGMENTS = 'downloading-segments',
  STICHING_SEGMENTS = 'stiching-segments',
  READY_FOR_DOWNLOAD = 'ready-for-download',
  ERROR = 'error',
}

HlsDownloaderFetchOption

type HlsDownloaderFetchOption = {
  url: string
  headers?: Record<string, string>
}

对 HLS 源发起请求的基础选项。

HlsDownloaderDownloadOption

type HlsDownloaderDownloadOption = {
  filename?: string
  maxRetry?: number
  downloadConcurrency?: number
}

download() 方法的额外选项。

DownloadResult

type DownloadResult = {
  blobURL: string
  totalSegments: number
} | void

download() 的返回值。成功时包含合并文件的 blob URL 和分片总数。失败时返回 void。