TikTokDownload项目中的视频命名参数详解

TikTokDownload是一个开源的抖音视频下载工具，它提供了灵活的配置选项来自定义下载视频的命名规则。本文将详细介绍该工具在抖音单个视频下载时支持的命名参数及其使用方法。

命名参数基础语法

在TikTokDownload配置文件中，命名规则通过naming字段定义，采用{参数名}的占位符形式。基础语法示例如下：

naming: '{create}_{desc}'

完整参数列表

TikTokDownload支持以下命名参数：

1. create - 视频创建时间戳
2. desc - 视频描述文本
3. nickname - 发布者昵称
4. uid - 发布者用户ID
5. aweme_id - 视频唯一标识符
6. duration - 视频时长(秒)
7. width - 视频宽度(像素)
8. height - 视频高度(像素)
9. ratio - 视频宽高比
10. music - 背景音乐名称
11. play - 视频播放量
12. digg - 点赞数
13. comment - 评论数
14. share - 分享数
15. download - 下载数

高级用法示例

组合多个参数

naming: '{create}_{nickname}_{desc}_{digg}赞'

示例输出：20240622_张三_周末出游_1500赞.mp4

处理特殊字符

当视频描述包含特殊字符时，建议使用正则表达式过滤：

naming: '{create}_{desc.replace(/[\\/:*?"<>|]/g, "")}'

日期格式化

虽然工具本身不直接支持日期格式化，但可以通过后续处理脚本将时间戳转换为易读格式。

最佳实践建议

1. 唯一性：建议至少包含aweme_id或create参数，确保文件名唯一
2. 可读性：适当组合nickname和desc参数提高文件可识别性
3. 简洁性：避免使用过多参数导致文件名过长
4. 兼容性：注意Windows系统对文件名的特殊字符限制

注意事项

1. 参数区分大小写，必须使用小写形式
2. 当某些参数值为空时，占位符会被替换为空字符串
3. 文件名总长度不应超过操作系统限制(通常255字符)
4. 特殊字符可能在不同操作系统上导致问题

通过合理组合这些命名参数，用户可以创建既具有描述性又便于管理的视频文件命名方案，极大提升下载后的文件管理效率。