SDK 简介

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

• SDK 名称：上传 SDK

• SDK 开发者：北京火山引擎科技有限公司

• 主要功能：支持将音视频文件以及字幕、封面图等素材上传到火山引擎视频点播服务。

接入 SDK

相关信息

• SDK 版本信息：
  • Android 最新版本号：1.40.2.8
  • iOS 最新版本号：1.40.2.10-premium
  • Web 最新版本号：tt-uploader@1.0.28
  • 小程序最新版本号：2.0.0
• SDK 隐私政策：视频点播上传 SDK 隐私政策
• 开发者使用合规规范：视频点播上传 SDK 开发者使用合规规范

功能优势

支持类型丰富

支持视频、图片、文件等文件的上传，不同的场景 SDK 有不同的特点来帮助接入方完成上传工作：

• 视频上传：采用分片上传，可以设置 socket 数量对分片进行并发上传，极大提高上传效率。
• 图片上传：
  • 采用直连接口，减少与服务端的交互；
  • 可定制化图片，上传时可选择对图片做自定义修改，然后上传修改后的图片，并保存到本地。

使用简单

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

分片上传

在传输大文件时，如果一次性传输整个文件，那么在网络环境发生抖动时就会导致重传次数增加或者上传文件不完整等情况。所以，上传 SDK 在视频上传时采用了分片上传的方式，降低网络环境对上传质量的影响，同时提高了视频文件上传的速度。

断点续传

在文件上传时如果发生断网、上层应用中断的特殊情况，使文件上传行为停止。那么在下次重新上传时，可以从终止的地方继续上传。您可以不用担心外部影响导致上传工作重新开始。

全链路数据洞察

上传 SDK 内部对上传过程中产生的所有具体错误都有明确的定义，从文件打开失败到分片上传失败，每个错误都有相应的错误码。这样可以使上层应用更清楚的知道上传中的哪一步失败了，使上层应用对各种错误的处理更加细致准确，进而提高用户体验。