Files
2026-06-21 14:26:15 +08:00

259 lines
7.2 KiB
Python

"""下载任务数据模型
定义下载任务的所有状态、属性和数据结构。
"""
from dataclasses import dataclass, field
from enum import Enum
from typing import Optional
from datetime import datetime
import uuid
class TaskStatus(Enum):
"""任务状态枚举"""
WAITING = "等待中"
DOWNLOADING = "下载中"
MERGING = "合并中"
COMPLETED = "已完成"
FAILED = "失败"
PAUSED = "已暂停"
CANCELLED = "已取消"
class DownloadType(Enum):
"""下载类型枚举"""
VIDEO = "视频"
AUDIO = "音频"
SUBTITLE = "字幕"
THUMBNAIL = "封面"
@dataclass
class VideoInfo:
"""视频信息数据结构"""
title: str = ""
author: str = ""
duration: int = 0 # 秒
upload_date: str = "" # YYYYMMDD 格式
thumbnail_url: str = ""
description: str = ""
webpage_url: str = ""
view_count: int = 0
like_count: int = 0
@property
def duration_str(self) -> str:
"""格式化时长为 HH:MM:SS"""
if not self.duration:
return "未知"
duration = int(self.duration) # yt-dlp 可能返回 float
hours, remainder = divmod(duration, 3600)
minutes, seconds = divmod(remainder, 60)
if hours > 0:
return f"{hours}:{minutes:02d}:{seconds:02d}"
return f"{minutes}:{seconds:02d}"
@property
def upload_date_str(self) -> str:
"""格式化上传日期为 YYYY-MM-DD"""
if not self.upload_date or len(self.upload_date) != 8:
return self.upload_date or "未知"
return f"{self.upload_date[:4]}-{self.upload_date[4:6]}-{self.upload_date[6:8]}"
@dataclass
class VideoFormat:
"""视频格式数据结构"""
format_id: str = ""
ext: str = "" # 文件扩展名,如 mp4, webm
resolution: str = "" # 如 1080p
video_codec: str = "" # 如 avc1, vp9
audio_codec: str = "" # 如 mp4a, opus
fps: int = 0 # 帧率
file_size: int = 0 # 字节
tbr: float = 0.0 # 总比特率 (kbps)
vbr: float = 0.0 # 视频比特率 (kbps)
abr: float = 0.0 # 音频比特率 (kbps)
has_video: bool = True
has_audio: bool = True
is_audio_only: bool = False
note: str = "" # 格式备注,如 "Premium", "HDR"
@property
def resolution_int(self) -> int:
"""获取分辨率高度数值"""
if not self.resolution:
return 0
try:
return int(self.resolution.lower().replace('p', ''))
except ValueError:
return 0
@property
def file_size_str(self) -> str:
"""格式化文件大小"""
if not self.file_size:
return "未知大小"
size = self.file_size
for unit in ['B', 'KB', 'MB', 'GB', 'TB']:
if size < 1024:
return f"{size:.1f} {unit}"
size /= 1024
return f"{size:.1f} PB"
@property
def display_name(self) -> str:
"""用于 UI 显示的格式名称"""
parts = []
# 分辨率/类型
if self.is_audio_only:
parts.append(self.ext.upper())
elif self.resolution:
parts.append(self.resolution.upper())
else:
parts.append(self.ext.upper())
# 编码
if self.video_codec:
parts.append(self.video_codec.upper())
if self.audio_codec and not self.is_audio_only:
parts.append(self.audio_codec.upper())
# 帧率 (仅视频)
if self.fps and not self.is_audio_only:
parts.append(f"{self.fps}FPS")
# 文件大小
parts.append(self.file_size_str)
# 备注
if self.note:
parts.append(self.note)
return " | ".join(parts)
@dataclass
class SubtitleInfo:
"""字幕信息数据结构"""
language: str = "" # 语言代码,如 zh, en
language_name: str = "" # 语言名称,如 中文, English
is_auto: bool = False # 是否为自动生成字幕
ext: str = "vtt" # 字幕格式
url: str = ""
@dataclass
class DownloadProgress:
"""下载进度数据结构"""
downloaded_bytes: int = 0
total_bytes: int = 0
speed: float = 0.0 # 字节/秒
percent: float = 0.0 # 0-100
eta: int = 0 # 预计剩余秒数
status: str = "" # 进度状态描述
@property
def speed_str(self) -> str:
"""格式化下载速度"""
if not self.speed:
return "计算中..."
speed = self.speed
for unit in ['B/s', 'KB/s', 'MB/s', 'GB/s']:
if speed < 1024:
return f"{speed:.1f} {unit}"
speed /= 1024
return f"{speed:.1f} TB/s"
@property
def downloaded_str(self) -> str:
"""格式化已下载大小"""
size = self.downloaded_bytes
for unit in ['B', 'KB', 'MB', 'GB', 'TB']:
if size < 1024:
return f"{size:.1f} {unit}"
size /= 1024
return f"{size:.1f} PB"
@property
def total_str(self) -> str:
"""格式化总大小"""
if not self.total_bytes:
return "未知"
size = self.total_bytes
for unit in ['B', 'KB', 'MB', 'GB', 'TB']:
if size < 1024:
return f"{size:.1f} {unit}"
size /= 1024
return f"{size:.1f} PB"
@property
def eta_str(self) -> str:
"""格式化剩余时间"""
if not self.eta:
return "计算中..."
eta = self.eta
if eta < 60:
return f"{eta} 秒"
elif eta < 3600:
return f"{eta // 60} 分 {eta % 60} 秒"
else:
hours = eta // 3600
minutes = (eta % 3600) // 60
return f"{hours} 时 {minutes} 分"
@dataclass
class DownloadTask:
"""下载任务数据模型
封装单个下载任务的所有信息,包括视频信息、格式选择、
进度跟踪和状态管理。
"""
# 唯一标识
task_id: str = field(default_factory=lambda: str(uuid.uuid4())[:8])
# URL 信息
url: str = ""
is_playlist: bool = False
# 视频信息
video_info: Optional[VideoInfo] = None
# 下载配置
selected_format: Optional[VideoFormat] = None
download_video: bool = True
download_audio: bool = False
download_subtitle: bool = False
download_thumbnail: bool = False
subtitle_language: str = "zh" # 字幕语言代码
subtitle_format: str = "srt" # 字幕文件格式
subtitle_auto: bool = True # 是否使用自动字幕
thumbnail_format: str = "jpg" # 封面图格式
# 输出配置
output_dir: str = ""
output_filename: str = ""
# 状态
status: TaskStatus = TaskStatus.WAITING
progress: DownloadProgress = field(default_factory=DownloadProgress)
error_message: str = ""
# 时间戳
created_at: datetime = field(default_factory=datetime.now)
started_at: Optional[datetime] = None
completed_at: Optional[datetime] = None
# 额外数据
extra_data: dict = field(default_factory=dict)
def reset_progress(self) -> None:
"""重置进度信息"""
self.progress = DownloadProgress()
self.status = TaskStatus.WAITING
self.error_message = ""
self.started_at = None
self.completed_at = None