93 lines
4.8 KiB
Go
93 lines
4.8 KiB
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"`
|
||
}
|