本文为您介绍如何将 Android 上传 SDK 集成至您的项目中，包括开发环境要求、前提条件、操作步骤等内容。

开发环境要求 #

• 推荐使用最新版本的 Android Studio。
• 系统版本：要求 minSdkVersion 16 及以上。
• ABI 兼容性：要求设备架构为 armv7 或 arm64。

添加 maven 仓库 #

确保 project 根目录下 build.gradle 文件中的 repositories 中配置了 mavenCentral() 和火山引擎 maven 服务。

allprojects {
    repositories {
        google()
        jcenter()
        mavenCentral()
        maven {
            url "https://artifact.bytedance.com/repository/Volcengine/" // volc public maven repo
        }
    }
}

获取 SDK 最新版本 #

请参见发布历史获取 SDK 最新版本号。

添加 SDK 依赖 #

在 module 目录下 build.gradle 文件中 dependencies 中添加 SDK 依赖。

dependencies {
     ...
    // 推荐使用最新稳定版，版本信息见「获取 SDK 最新版本」小节
    implementation "com.bytedanceapi:ttsdk-ttuploader:x.x.x.x"
    implementation "com.bytedanceapi:ttsdk-ttcommon:x.x.x.x"
    implementation "com.bytedanceapi:ttsdk-ttlicense2:x.x.x.x"
    // 1.40.2.8 之前的版本还需要添加以下 AppLog 依赖，用于上报日志
    // implementation "com.bytedance.applog:RangersAppLog-Lite-cn:6.10.1"
}

权限声明 #

在 AndroidManifest.xml 文件中声明 SDK 需要的权限。

<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
<uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" />
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />

混淆规则 #

在 proguard-rules.pro 文件中配置 SDK 混淆规则。

# 上传模块
-keep class com.pandora.common.applog.**{*;}
-keep class com.pandora.ttuploader2.** {*;}
-keep class com.ss.bduploader.** {*;}
-keep class com.pandora.ttlicense2.**{*;}

后续操作 #

至此，您已完成上传 SDK 的集成准备。后续可参考以下文档，使用 SDK 将视频或素材上传至视频点播服务：

• 上传视频
• 上传素材