TimecodeKit

最强大、最精确、最完整的 Swift 库，用于处理 SMPTE/EBU 时间码。 支持 23 种行业时间码帧率，并提供一套与 Apple AV 框架集成的转换、计算和集成工具。

时间码是广播和后期制作中用于寻址视频帧的标准。 它用于视频烧录时间码 (BITC)，并在 DAW（数字音频工作站）或视频播放/编辑应用程序中显示。

支持以下时间码速率和格式。

支持以下视频帧率。（视频速率）

• 时间码之间转换
  • 时间码显示字符串
  • 总经过帧数
  • 实际时钟时间
  • 以任何音频采样率经过的音频采样
  • 有理时间表示法（例如 CMTime 或 Final Cut Pro XML 和 AAF 编码）
  • 英尺 + 帧
• 将时间码和/或帧率转换为有理分数，反之亦然（包括 CMTime）
• 支持将天数作为时间码分量（包括 Cubase 在内的一些 DAW 支持 > 24 小时的时间码）
• 支持子帧
• 数学运算：加、减、乘、除
• 细粒度时间码验证
• 在两个时间码实例之间形成 Range 或 Stride
• 符合 Codable
• 格式化器
  • 一个可以格式化时间码的 Formatter 对象
  • 一个 AttributedString，使用替代属性（例如红色文本颜色）显示无效的时间码组件
• SwiftUI 视图
  • 一个时间码输入文本字段
  • 一个时间码字符串 Text 视图，使用替代属性（例如红色文本颜色）强调无效的时间码组件
• AVAsset 视频文件实用程序，可轻松读取/写入时间码轨道并将 AVPlayer 定位到时间码位置
• 详尽的单元测试，确保准确性

1. 使用 Swift Package Manager 将 TimecodeKit 添加为依赖项。
   • 在应用程序项目或框架中，在 Xcode 中：使用此 URL 将软件包添加到您的目标：https://github.com/orchetect/TimecodeKit
   • 在 Swift Package 中，将其添加到 Package.swift 依赖项

     .package(url: "https://github.com/orchetect/TimecodeKit", from: "2.3.1")

2. 导入库

   import TimecodeKit

请参阅在线文档，了解库的使用方法、入门信息和 1.x → 2.x 迁移指南。

另请查看Examples文件夹，获取示例代码以了解 TimecodeKit 的实际应用。

• 维基百科：SMPTE 时间码

由一群穿着风衣，自称为@orchetect 的 🐹 仓鼠编写。

在 MIT 许可下获得许可。 有关详细信息，请参阅LICENSE。

如果您喜欢使用 TimecodeKit 并希望在经济上为开源做出贡献，GitHub 赞助将不胜感激。 也欢迎反馈和代码贡献。

请勿通过电子邮件联系维护者以获得技术支持。 有几个选项可用于提问和提出功能想法

• 问题和功能想法可以发布到Discussions。
• 如果问题是可验证的错误，并且具有可重现的步骤，则可以将其发布在Issues中。

欢迎贡献。 在提交 PR 之前，请先在 Discussions 中发布。