You need to enable JavaScript to run this app.
导航

接入 H.265

最近更新时间2023.11.03 17:38:11

首次发布时间2021.04.14 14:20:55

本文为您介绍 H.265 接入的使用说明。

SDK 依赖

建议您使用高级版 SDK,包含了基于大数据沉淀的 H.265 硬解机型黑名单,仅需集成少量代码即可对接大数据机型画像,同时包含基于机型画像的档位灵活切换软硬解策略,有效避免播放失败、花屏、黑屏等问题。

dependencies {
    //... your own dependencies...
    def ttsdk_version = "x.x.x.x" // 推荐使用最新稳定版,具体版本号请见发布历史
    implementation "com.bytedanceapi:ttsdk-player_premium:$ttsdk_version" // 高级版
    def applog_version = "5.3.0"
    implementation "com.bytedance.applog:RangersAppLog-Lite-cn:$applog_version"
    implementation 'com.squareup.okhttp3:okhttp:3.0.0'
}

设置播放 H.265 数据源

说明

详细说明请参考快速开始的设置播放数据源

本地视频源

使用本地视频源方式播放点播视频,需要将 videoFile 属性设置为本地的播放地址。代码示例如下所示。

// 使用 H265 编码的本地视频源
File videoFile = new File("/sdcard/Download/video.MP4");
ttVideoEngine.setLocalURL(videoFile.getAbsolutePath());
ttVideoEngine.play()

Http URL 视频源

// enable MDL (数据加载模块)
ttVideoEngine.setIntOption(PLAYER_OPTION_ENABLE_DATALOADER,1);

// 使用 H265 编码的 URL 视频源
String videoUrl = "https://yourdomain.com/video.mp4";
// 缓存key 推荐使用 url md5
String key = Md5.md5(videoUrl);
ttVideoEngine.setDirectUrlUseDataLoader(videoUrl, key);
ttVideoEngine.play()

VideoID 视频源

// enable MDL (缓存模块)
ttVideoEngine.setIntOption(PLAYER_OPTION_ENABLE_DATALOADER, 1); 
// enable 缓存 video model
ttVideoEngine.setIntOption(PLAYER_OPTION_USE_VIDEOMODEL_CACHE, 1);

String videoId = "your video id"; // AppServer 下发
// AppServer 下发 H265 的 PlayAuthToken
String playAuthToken = "your video id's play auth token"; // AppServer 下发
ttVideoEngine.setVideoID(videoId);
ttVideoEngine.setPlayAuthToken(playAuthToken);

ttVideoEngine.play();

说明

  1. AppServer 在下发的 PlayAuthToken 中签入 H265 播放策略。您可通过服务端 SDK,获取临时安全凭证 PlayAuthToken,其中参数取值与获取播放地址中取值相同。
  2. 客户端使用该 PlayAuthToken 来播放时,即可拉取 H265 的播放源进行播放。