259 lines
7.2 KiB
Python
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
|