上传 SDK 是指通过终端（Android、iOS、Web 等）将音视频文件以及字幕、封面图等素材上传到火山引擎视频点播服务，适用于 UGC、PGC、运营后台等终端用户上传内容的使用场景。

• SDK 名称：上传 SDK
• SDK 开发者：北京火山引擎科技有限公司
• 主要功能：支持将音视频文件以及字幕、封面图等素材上传到火山引擎视频点播服务。

接入 SDK

相关信息

• SDK 版本信息：
  • Android 最新版本号：1.46.2.11
  • iOS 最新版本号：1.46.2.8-premium
  • Web 最新版本号：tt-uploader@1.3.9
  • Flutter 最新版本号：1.45.3
  • HarmonyOS NEXT 最新版本号：1.0.2
  • 小程序最新版本号：2.0.0
• SDK 隐私政策：视频点播上传 SDK 隐私政策
• 开发者使用合规规范：视频点播上传 SDK 开发者使用合规规范

功能优势

丰富的文件支持类型

支持视频、图片、文件等多种类型文件的上传。针对不同场景，SDK 具备相应特点以协助接入方完成上传工作：

• 视频上传：采用分片上传，支持设置 Socket 数量实现分片并发上传，显著提升上传效率。
• 图片上传：
  • 采用直连接口，减少与服务端的交互。
  • 支持图片定制，上传时可对图片进行自定义修改，上传修改后的图片并保存至本地。

便捷的使用方式

• 接入便捷，接入方只需调用几个接口即可轻松实现上传逻辑。
• 采用直连接口，减少与服务端的交互，缩短上传总耗时。

分片上传

在传输大文件时，若一次性传输整个文件，网络环境抖动可能导致重传次数增加或上传文件不完整等问题。因此，上传 SDK 在视频上传时采用分片上传方式，降低网络环境对上传质量的影响，同时提高视频文件的上传速度。

断点续传

文件上传过程中，若遇到断网、上层应用中断等特殊情况导致上传停止，下次重新上传时可从中断位置继续。用户无需担心因外部因素影响而重新开始上传。

全链路错误洞察

上传 SDK 对上传过程中产生的所有具体错误进行了明确界定，从文件打开失败到分片上传失败，每个错误都配有相应的错误码。这有助于上层应用精确识别上传过程中具体哪一步出现失败，从而更细致、准确地处理各类错误，提升用户体验。

费用说明

上传 SDK 本身不收取费用。将媒资上传至视频点播服务会产生存储费用，详情请参考媒资存储计费。