media/model/dto/video/video_dto.go

package video

import "github.com/gogf/gf/v2/frame/g"

// ConcatReq 视频拼接请求（JSON body / URL 方式）
type ConcatReq struct {
	g.Meta    `path:"/concat" method:"post" tags:"视频拼接" summary:"视频拼接(URL模式)" dc:"从视频URL下载并拼接"`
	VideoURLs []string `json:"video_urls" v:"required#视频URL列表不能为空" dc:"视频URL列表(按此顺序拼接)"`
	Method    string   `json:"method" dc:"拼接方式(auto/fast/reencode)" d:"auto"`
	Upload    bool     `json:"upload" dc:"是否上传到MinIO" d:"false"`
}

// ConcatAsyncReq 视频拼接-异步请求（URL模式）
type ConcatAsyncReq struct {
	g.Meta      `path:"/concat/async" method:"post" tags:"视频拼接" summary:"视频拼接-异步(URL模式)" dc:"异步拼接视频，立即返回taskId，完成后通过callback_url通知结果"`
	VideoURLs   []string `json:"video_urls" v:"required#视频URL列表不能为空" dc:"视频URL列表(按此顺序拼接)"`
	Method      string   `json:"method" dc:"拼接方式(auto/fast/reencode)" d:"auto"`
	Upload      bool     `json:"upload" dc:"是否上传到MinIO" d:"false"`
	CallbackURL string   `json:"callback_url" v:"required#回调地址不能为空" dc:"回调地址，拼接完成后POST结果到该地址"`
}

// ConcatUploadReq 视频拼接请求（文件上传模式）
type ConcatUploadReq struct {
	g.Meta `path:"/concat/upload" method:"post" tags:"视频拼接" summary:"视频拼接(文件上传)" dc:"上传视频文件并拼接(至少2个视频)"`
	Method string `json:"method" dc:"拼接方式(auto/fast/reencode)" d:"auto"`
	Upload bool   `json:"upload" dc:"是否上传到MinIO" d:"false"`
}

// ConcatUploadAsyncReq 视频拼接-异步请求（文件上传模式）
type ConcatUploadAsyncReq struct {
	g.Meta      `path:"/concat/upload/async" method:"post" tags:"视频拼接" summary:"视频拼接-异步(文件上传)" dc:"异步拼接上传的视频，立即返回taskId，完成后通过callback_url通知结果"`
	Method      string `json:"method" dc:"拼接方式(auto/fast/reencode)" d:"auto"`
	Upload      bool   `json:"upload" dc:"是否上传到MinIO" d:"false"`
	CallbackURL string `json:"callback_url" v:"required#回调地址不能为空" dc:"回调地址，拼接完成后POST结果到该地址"`
}

// ConcatRes 视频拼接响应
type ConcatRes struct {
	OutputPath  string  `json:"outputPath" dc:"输出文件路径"`
	FileSize    int64   `json:"fileSize" dc:"文件大小(字节)"`
	Duration    float64 `json:"duration" dc:"总时长(秒)"`
	DurationStr string  `json:"durationStr" dc:"可读时长"`
	MethodUsed  string  `json:"methodUsed" dc:"实际使用的拼接方式"`
	InputFiles  int     `json:"inputFiles" dc:"输入文件数"`
	FileURL     string  `json:"fileURL" dc:"MinIO访问地址（上传后返回）"`
}

// ---------- 异步拼接任务 ----------

// CreateConcatTaskRes 创建异步拼接任务响应
type CreateConcatTaskRes struct {
	TaskID string `json:"taskId" dc:"任务ID"`
}

// GetConcatTaskReq 查询异步拼接任务请求
type GetConcatTaskReq struct {
	g.Meta `path:"/concat/task/{taskId}" method:"get" tags:"视频拼接" summary:"查询拼接任务结果" dc:"根据taskId查询异步拼接任务的结果"`
	TaskID string `json:"taskId" dc:"任务ID"`
}

// GetConcatTaskRes 查询异步拼接任务响应
type GetConcatTaskRes struct {
	TaskID            string `json:"taskId" dc:"任务ID"`
	Status            string `json:"status" dc:"状态: pending/running/success/failed"`
	FileURL           string `json:"fileURL,omitempty" dc:"MinIO文件访问路径"`
	FileSize          int64  `json:"fileSize,omitempty" dc:"文件大小(字节)"`
	FileName          string `json:"fileName,omitempty" dc:"文件名"`
	FileFormat        string `json:"fileFormat,omitempty" dc:"文件格式"`
	FileAddressPrefix string `json:"fileAddressPrefix,omitempty" dc:"MinIO地址前缀"`
	MethodUsed        string `json:"methodUsed,omitempty" dc:"实际使用的拼接方式"`
	DurationStr       string `json:"durationStr,omitempty" dc:"拼接后时长"`
	ErrorMessage      string `json:"errorMessage,omitempty" dc:"错误信息"`
	CreatedAt         int64  `json:"createdAt" dc:"创建时间戳"`
}

// ---------- 上传工具 ----------

// UploadFileBytesReq 上传文件请求(字节流)
type UploadFileBytesReq struct {
	FileName     string `json:"fileName" dc:"文件名"`
	FileBytes    []byte `json:"fileBytes" dc:"文件字节流"`
	FileStoreURL string `json:"fileStoreURL" dc:"文件存储路径"`
}

// UploadFileBytesRes 上传文件响应
type UploadFileBytesRes struct {
	FileURL           string `json:"fileURL" dc:"上传地址"`
	FileSize          int    `json:"fileSize" dc:"文件大小"`
	FileName          string `json:"fileName" dc:"文件名称"`
	FileFormat        string `json:"fileFormat" dc:"文件格式"`
	FileAddressPrefix string `json:"fileAddressPrefix"`
}