tencent cloud

您可以直接下面播放器组件 ZIP包，单击页面的 Code > Download ZIP 下载。

1. 首先确认您的电脑上安装了 Git，如果没有安装，可以参见 Git 安装教程 进行安装。
2. 执行下面的命令把超级播放器组件工程代码 clone 到本地。
   

   git clone git@github.com:tencentyun/SuperPlayer_Android.git
   

   
   提示下面的信息表示成功 clone 工程代码到本地。
   

   正克隆到 'SuperPlayer_Android'...
   remote: Enumerating objects: 2637, done.
   remote: Counting objects: 100% (644/644), done.
   remote: Compressing objects: 100% (333/333), done.
   remote: Total 2637 (delta 227), reused 524 (delta 170), pack-reused 1993
   接收对象中: 100% (2637/2637), 571.20 MiB | 3.94 MiB/s, 完成.
   处理 delta 中: 100% (1019/1019), 完成.
   

   
   下载工程后，源码解压后的目录如下：

1. 下载 SDK + Demo 开发包，项目地址为 Android。

2. 把Demo/superplayerkit这个 module 复制到工程中，然后进行下面的配置：

   • 在工程目录下的setting.gradle 导入superplayerkit。
     

     include ':superplayerkit'
     

   • 打开superplayerkit 工程的 build.gradle 文件修改 compileSdkVersion，buildToolsVersion，minSdkVersion，targetSdkVersion 和 rootProject.ext.liteavSdk 的常量值。
     
     

     compileSdkVersion 26
     buildToolsVersion "26.0.2"
        defaultConfig {
        targetSdkVersion 23
        minSdkVersion 19
     }
        dependencies {
        //如果要集成历史版本，可将 latest.release 修改为对应的版本，例如：8.5.290009
        implementation 'com.tencent.liteav:LiteAVSDK_Player:latest.release'
     }
     

     
     请参见上面的步骤，把common模块导入到项目，并进行配置。

3. 通过在 gradle 配置 mavenCentral 库，自动下载更新 LiteAVSDK，打开app/build.gradle，进行下面的配置：
   

   1. 在 dependencies 中添加 LiteAVSDK_Player 的依赖。
      

      dependencies {
       implementation 'com.tencent.liteav:LiteAVSDK_Player:latest.release'
       implementation project(':superplayerkit')
       // 超级播放器弹幕集成的第三方库
       implementation 'com.github.ctiao:DanmakuFlameMaster:0.5.3'
      }
      

      
      如果您需要集成历史版本的 LiteAVSDK_Player SDK ，可以在 MavenCentral 查看历史版本，然后通过下面的方式进行集成：
      

      dependencies {
      // 集成8.5.10033 版本LiteAVSDK_Player SDK
      implementation 'com.tencent.liteav:LiteAVSDK_Player:8.5.10033'
      }
      

   2. 在 app/build.gradle defaultConfig 中，指定 App 使用的 CPU 架构（目前 LiteAVSDK 支持 armeabi 、 armeabi-v7a 和 arm64-v8a，可根据项目需求配置）。
      

      ndk {
       abiFilters "armeabi", "armeabi-v7a", "arm64-v8a"
      }
      

      
      如果之前没有使用过9.4以及更早版本的 SDK 的 下载缓存功能（TXVodDownloadManager 中的相关接口），并且不需要在9.5及后续 SDK 版本播放9.4及之前缓存的下载文件，可以不需要该功能的 so 文件，达到减少安装包的体积，例如：在9.4及之前版本使用了 TXVodDownloadManager 类的 setDownloadPath 和 startDownloadUrl 函数下载了相应的缓存文件，并且应用内存储了 TXVodDownloadManager 回调的 getPlayPath 路径用于后续播放，这时候需要 libijkhlscache-master.so 播放该 getPlayPath 路径文件，否则不需要。可以在 app/build.gradle 中添加：
      

      packagingOptions {
      exclude "lib/armeabi/libijkhlscache-master.so"
      exclude "lib/armeabi-v7a/libijkhlscache-master.so"
      exclude "lib/arm64-v8a/libijkhlscache-master.so"
      }
      

   3. 在工程目录的 build.gradle 添加 mavenCentral 库。
      

      repositories {
       mavenCentral()
      }
      

4. 单击 Sync Now 按钮同步 SDK，如果您的网络连接 mavenCentral 没有问题，很快 SDK 就会自动下载集成到工程里。

1. 下载 SDK + Demo 开发包，项目地址为 Android。
2. 导入 SDK/LiteAVSDK_Player_XXX.aar（其中 XXX 为版本号）到 app 下面的 libs 文件夹以及复制 Demo/superplayerkit 这个 module 到工程中。
3. 在工程目录下的 setting.gradle 导入superplayerkit。
   

   include ':superplayerkit'
   

4. 打开superplayerkit工程的 build.gradle 文件修改 compileSdkVersion，buildToolsVersion，minSdkVersion，targetSdkVersion 和 rootProject.ext.liteavSdk 的常量值。
   
   

   compileSdkVersion 26
   buildToolsVersion "26.0.2"
   defaultConfig {
    targetSdkVersion 23
    minSdkVersion 19
   }
   dependencies {
    implementation(name:'LiteAVSDK_Player_8.9.10349', ext:'aar')
   }
   

   
   请参见上面的步骤，把common模块导入到项目，并进行配置。
   • 配置 repositories
     

     repositories {
      flatDir {
              dirs '../app/libs'
      }
     }
     

5. 在app/build.gradle中添加依赖：
   

   compile(name:'LiteAVSDK_Player_8.9.10349', ext:'aar')
   implementation project(':superplayerkit')
   // 超级播放器弹幕集成的第三方库
   implementation 'com.github.ctiao:DanmakuFlameMaster:0.5.3'
   

6. 在项目build.gradle中添加：
   

   allprojects {
    repositories {
            flatDir {
                    dirs 'libs'
            }
    }
   }
   

7. 在 app/build.gradle defaultConfig 中，指定 App 使用的 CPU 架构（目前 LiteAVSDK 支持 armeabi 、 armeabi-v7a 和 arm64-v8a）。
   

   ndk {
    abiFilters "armeabi", "armeabi-v7a", "arm64-v8a"
   }
   

   
   如果之前没有使用过9.4以及更早版本的 SDK 的 下载缓存功能（TXVodDownloadManager 中的相关接口），并且不需要在9.5及后续 SDK 版本播放9.4及之前缓存的下载文件，可以不需要该功能的 so 文件，达到减少安装包的体积，例如：在9.4及之前版本使用了 TXVodDownloadManager 类的 setDownloadPath 和 startDownloadUrl 函数下载了相应的缓存文件，并且应用内存储了 TXVodDownloadManager 回调的 getPlayPath 路径用于后续播放，这时候需要 libijkhlscache-master.so 播放该 getPlayPath 路径文件，否则不需要。可以在 app/build.gradle 中添加：
   

   packagingOptions {
   exclude "lib/armeabi/libijkhlscache-master.so"
   exclude "lib/armeabi-v7a/libijkhlscache-master.so"
   exclude "lib/arm64-v8a/libijkhlscache-master.so"
   }
   

8. 单击 Sync Now 按钮同步 SDK，完成超级播放器的集成工作。

如果您不想集成 aar 库，也可以通过导入 jar 和 so 库的方式集成 LiteAVSDK：

1. 下载 SDK + Demo 开发包，项目地址为 Android，下载完成后进行解压。在 SDK 目录找到SDK/LiteAVSDK_Player_XXX.zip（其中 XXX 为版本号），解压得到 libs 目录，里面包含 jar 文件和 so 文件夹，文件清单如下：
   
2. 把Demo/superplayerkit这个 module 复制到工程中，然后在工程目录下的 setting.gradle 导入superplayerkit。
   

   include ':superplayerkit'
   

3. 把 步骤1 解压得到的 libs 文件夹复制superplayerkit工程根目录。
4. 修改superplayerkit/build.gradle文件：
   
   

   compileSdkVersion 26
   buildToolsVersion "26.0.2"
   defaultConfig {
    targetSdkVersion 23
    minSdkVersion 19
   }
   

   
   请参见上面的步骤，把common模块导入到项目，并进行配置。
   • 配置 sourceSets，添加 so 库引用代码。
     

     sourceSets{
          main{
                  jniLibs.srcDirs = ['libs']
          }
     }
     

   • 配置 repositories，添加 flatDir，指定本地仓库路径。
     

     repositories {
      flatDir {
              dirs 'libs'
      }
     }
     

5. 在 app/build.gradle defaultConfig 中，指定 App 使用的 CPU 架构（目前 LiteAVSDK 支持 armeabi 、 armeabi-v7a 和 arm64-v8a）。
   

   ndk {
    abiFilters "armeabi", "armeabi-v7a", "arm64-v8a"
   }
   

6. 单击 Sync Now 按钮同步 SDK，完成 超级播放器的集成工作。

URL可以是点播文件播放地址，也可以是直播拉流地址，传入相应 URL 即可播放相应视频文件。

SuperPlayerModel model = new SuperPlayerModel();
model.appId = 1400329073; // 配置 AppId
model.url = "http://your_video_url.mp4";   // 配置您的播放视频url
mSuperPlayerView.playWithModel(model);

视频 FileId 在一般是在视频上传后，由服务器返回：

1. 客户端视频发布后，服务器会返回 FileId 到客户端。
2. 服务端视频上传时，在 确认上传 的通知中包含对应的 FileId。

如果文件已存在腾讯云，则可以进入 媒资管理 ，找到对应的文件，查看 FileId。如下图所示，ID 即表示 FileId：

注意

通过 FileID 播放时，需要首先使用 Adaptive-HLS(10) 转码模板对视频进行转码，或者使用超级播放器签名 psign 指定播放的视频，否则可能导致视频播放失败。转码教程和说明可参见 用超级播放器播放视频，psign 生成教程可参见 psign 教程。

若您在通过 FileID 播放时出现“no v4 play info”异常，则说明您可能存在上述问题，建议您根据上述教程调整。同时您也可以直接获取源视频播放链接，通过 URL 播放 的方式实现播放。

未经转码的源视频在播放时有可能出现不兼容的情况，建议您使用转码后的视频进行播放。

//在未开启防盗链进行播放的过程中，如果出现了“no v4 play info”异常，建议您使用Adaptive-HLS(10)转码模板对视频进行转码，或直接获取源视频播放链接通过url方式进行播放。

SuperPlayerModel *model = [[SuperPlayerModel alloc] init];
model.appId = 1400329071;// 配置 AppId
model.videoId = [[SuperPlayerVideoId alloc] init];
model.videoId.fileId = @"5285890799710173650"; // 配置 FileId
//私有加密播放需填写 psign， psign 即超级播放器签名，签名介绍和生成方式参见链接：https://intl.cloud.tencent.com/document/product/266/38099
//model.videoId.pSign = @"eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJhcHBJZCI6MTQwMDMyOTA3MSwiZmlsZUlkIjoiNTI4NTg5MDc5OTcxMDE3MzY1MCIsImN1cnJlbnRUaW1lU3RhbXAiOjEsImV4cGlyZVRpbWVTdGFtcCI6MjE0NzQ4MzY0NywidXJsQWNjZXNzSW5mbyI6eyJ0IjoiN2ZmZmZmZmYifSwiZHJtTGljZW5zZUluZm8iOnsiZXhwaXJlVGltZVN0YW1wIjoyMTQ3NDgzNjQ3fX0.yJxpnQ2Evp5KZQFfuBBK05BoPpQAzYAWo6liXws-LzU"; 
[_playerView playWithModel:model];

单击返回，即可返回至窗口播放模式。

//单击后触发下面的接口
mControllerCallback.onBackPressed(SuperPlayerDef.PlayerMode.FULLSCREEN);
onSwitchPlayMode(SuperPlayerDef.PlayerMode.WINDOW);

锁屏操作可以让用户进入沉浸式播放状态。

//单击后触发的接口
toggleLockState();

打开弹幕功能后屏幕上会有用户发送的文字飘过。

// 步骤一：向弹幕View中添加一条弹幕
addDanmaku(String content, boolean withBorder);
// 步骤二：打开或者关闭弹幕
toggleBarrage();

超级播放器提供播放过程中截取当前视频帧功能，您可以把图片保存起来进行分享。单击图片4处按钮可以截屏，您可以在 mSuperPlayer.snapshot 接口进行保存截取的图片。

mSuperPlayer.snapshot(new TXLivePlayer.ITXSnapshotListener() {
 @Override
 public void onSnapshot(Bitmap bitmap) {
       //在这里可以保存截图
 }
});

用户可以根据需求选择不同的视频播放清晰度，如高清、标清或超清等。

//单击后触发的显示清晰度view代码接口
showQualityView();
//单击清晰度选项的回调接口为
mListView.setOnItemClickListener(new AdapterView.OnItemClickListener() {
 @Override
 public void onItemClick(AdapterView<?> parent, View view, int position, long id) {
   // 清晰度ListView的单击事件
   VideoQuality quality = mList.get(position);
   mCallback.onQualitySelect(quality);
 }
});
//最终改变清晰度的回调
@Override
public void onQualityChange(VideoQuality quality) {
  mFullScreenPlayer.updateVideoQuality(quality);
  mSuperPlayer.switchStream(quality);
}