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

开发环境要求

• 推荐使用 Android Studio 最新版本。
• 仅支持基于 armv7 或 arm64 架构的真实设备。暂不支持模拟器。
• Android 版本需为 5.0（API 级别 21）及以上。
• 编译时需使用 JDK 11 及其以下版本。

获取 License

视频点播通过 License 管理播放器 SDK 及其增值服务的使用权限和时间。在项目测试阶段，您可以在视频点播控制台申请免费的测试 License。您需完成创建应用、申请免费测试 License、绑定 License 与应用，详细操作步骤，请见应用管理和播放器 License。

集成 SDK

步骤 1：添加 maven 仓库

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

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

操作后的示意图如下：

步骤 2：添加 SDK 依赖

在 module 目录下 build.gradle 文件中的 dependencies 中添加播放器 SDK 依赖。播放器 SDK 分为基础版、高级版和企业版，各版本之间存在功能差异。请根据购买的 License 选择对应的版本。

dependencies {
    //... your own dependencies...
    // 将 x.x.x.x 替换成最新版本号
    implementation "com.bytedanceapi:ttsdk-player_premium:x.x.x.x" 
    // 1.40.2.8 之前的版本还需要添加以下 AppLog 依赖，用于上报日志
    // implementation "com.bytedance.applog:RangersAppLog-Lite-cn:6.15.4"
    // 用于获取视频源
    implementation 'com.squareup.okhttp3:okhttp:4.2.1'
}

dependencies {
    //... your own dependencies...
    // 将 x.x.x.x 替换成最新版本号
    implementation "com.bytedanceapi:ttsdk-player_standard:x.x.x.x"
    // 1.40.2.8 之前的版本还需要添加以下 AppLog 依赖，用于上报日志
    // implementation "com.bytedance.applog:RangersAppLog-Lite-cn:6.15.4"
    // 用于获取视频源
    implementation 'com.squareup.okhttp3:okhttp:4.2.1'
}

步骤 3：添加 Java 8 支持

在 module 目录下的 build.gradle 文件中添加 Java 8 支持，示例代码如下：

android {
    // ...
  compileOptions {
        sourceCompatibility JavaVersion.VERSION_1_8
        targetCompatibility JavaVersion.VERSION_1_8
    }
}

操作后的示意图如下：

步骤 4：声明权限

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

<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.WAKE_LOCK" />
<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" />
<uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />

步骤 5：配置混淆规则

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

# 点播模块
-keep class com.ss.ttm.** {*;} 
-keep class com.ss.ttvideoengine.** {*;} 
-keep class com.ss.mediakit.** {*;} 
-keep class com.ss.texturerender.** {*;}
-keep class com.bytedance.**{*;}
-keep class com.pandora.ttlicense2.**{*;}
-keep class com.pandora.common.applog.**{*;}
-keep class com.pandora.vod.VodSDK {*;} 
-keep class com.bytertc.volcbaselog.VolcBaseLogConfig{*;}
-keep class com.bytertc.volcbaselog.VolcBaseLogNative{*;}

后续操作

至此，您已完成播放器 SDK 的集成。接下来可使用播放器 SDK 播放视频。详情请见快速开始。