Android 接入指引

<!--网络权限-->
<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
<uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />
<!--点播播放器悬浮窗权限-->
<uses-permission android:name="android.permission.SYSTEM_ALERT_WINDOW" />
<!--存储-->
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
<uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" />

-keep class com.tencent.** { *; }

mControllerCallback.onSwitchPlayMode(SuperPlayerDef.PlayerMode.FULLSCREEN);

<uses-permission android:name="android.permission.SYSTEM_ALERT_WINDOW" />

// 切换悬浮窗触发的代码接口
mSuperPlayerView.switchPlayMode(SuperPlayerDef.PlayerMode.FLOAT);
//单击浮窗返回窗口触发的代码接口
mControllerCallback.onSwitchPlayMode(SuperPlayerDef.PlayerMode.WINDOW);

SuperPlayerModel model = new SuperPlayerModel();
model.appId = "您的 appid";
model.videoId = new SuperPlayerVideoId();
model.videoId.fileId = "您的 fileId"; 
//播放模式，可设置自动播放模式：PLAY_ACTION_AUTO_PLAY，手动播放模式：PLAY_ACTION_MANUAL_PLAY
model.playAction = PLAY_ACTION_MANUAL_PLAY;
//设定封面的地址为网络 url 地址，如果 coverPictureUrl 不设定，那么就会自动使用云点播控制台设置的封面
model.coverPictureUrl = "https://qcloudimg.tencent-cloud.cn/raw/946152ef79a6034786eb868f425b5f85.png" 
mSuperPlayerView.playWithModelNeedLicence(model);

//步骤1:构建轮播的 List<SuperPlayerModel>
ArrayList<SuperPlayerModel> list = new ArrayList<>();
SuperPlayerModel model = new VideoModel();
model = new SuperPlayerModel();
model.videoId = new SuperPlayerVideoId();
model.appid = 1252463788;
model.videoId.fileId = "4564972819219071568"；
list.add(model);
?
model = new SuperPlayerModel();
model.videoId = new SuperPlayerVideoId();
model.appid = 1252463788;
model.videoId.fileId = "4564972819219071679"；
list.add(model);
//步骤2：调用轮播接口
mSuperPlayerView.playWithModelListNeedLicence(list, true, 0);

public void playWithModelListNeedLicence(List<SuperPlayerModel> models, boolean isLoopPlayList, int index);

<activity>
    android:name=".demo.SuperPlayerActivity"
    android:resizeableActivity="true"
    android:supportsPictureInPicture="true"
    android:documentLaunchMode="intoExisting"
    android:excludeFromRecents="true"
    android:configChanges="orientation|keyboardHidden|screenSize|smallestScreenSize|screenLayout">
 
</activity>		

PictureInPictureHelper mPictureInPictureHelper = new PictureInPictureHelper(mContext);
mPictureInPictureHelper.setListener(this);
mPictureInPictureHelper.enterPictureInPictureMode(getPlayerState(),mTXCloudVideoView);

mPictureInPictureHelper.release();

 方法一：
 //步骤1：创建视频 mode
 SuperPlayerModel mode = new SuperPlayerModel();
 //...添加视频源信息
 //步骤2：创建试看信息 mode
 VipWatchModel vipWatchModel = new VipWatchModel("可试看%ss，开通 VIP 观看完整视频",15);
 mode.vipWatchMode = vipWatchModel;
 //步骤3：调用播放视频方法
 mSuperPlayerView.playWithModelNeedLicence(mode);
?
 方法二：
 //步骤1：创建试看信息 mode
 VipWatchModel vipWatchModel = new VipWatchModel("可试看%ss，开通 VIP 观看完整视频",15);
  //步骤2：调用设置试看功能方法
 mSuperPlayerView.setVipWatchModel(vipWatchModel);

public VipWatchModel(String tipStr, long canWatchTime)

 方法一：
 //步骤1：创建视频 mode
 SuperPlayerModel mode = new SuperPlayerModel();
 //...添加视频源信息
 //步骤2：创建水印信息 mode
 DynamicWaterConfig dynamicWaterConfig = new DynamicWaterConfig("shipinyun", 30, Color.parseColor("#80FFFFFF"));
 mode.dynamicWaterConfig = dynamicWaterConfig;
 //步骤3：调用播放视频方法
 mSuperPlayerView.playWithModelNeedLicence(mode);
?
 方法二：
 //步骤1：创建水印信息 mode
 DynamicWaterConfig dynamicWaterConfig = new DynamicWaterConfig("shipinyun", 30, Color.parseColor("#80FFFFFF"));
  //步骤2：调用设置动态水印功能方法
 mSuperPlayerView.setDynamicWatermarkConfig(dynamicWaterConfig);

public DynamicWaterConfig(String dynamicWatermarkTip, int tipTextSize, int tipTextColor)

// 步骤1：初始化下载数据 参数见下方列表
DownloadMenuListView mDownloadMenuView = findViewById(R.id.superplayer_cml_cache_menu);
mDownloadMenuView.initDownloadData(superPlayerModelList, mVideoQualityList, mDefaultVideoQuality, "default");
?
// 步骤2：设置正在播放的视频选项
mDownloadMenuView.setCurrentPlayVideo(mSuperplayerModel);
?
// 步骤3：设置 video download list 按钮的点击事件
mDownloadMenuView.setOnCacheListClick(new OnClickListener() {
     @Override
     public void onClick(View v) {
       // 跳转到 VideoDownloadListView 所在的 Activity
       startActivity(DownloadMeduListActivity.this,VideoDownloadListActivity.class);
     }
});
?
// 步骤4:通过动画展示 view
mDownloadMenuView.show();

public void initDownloadData(List<SuperPlayerModel> superPlayerModelList,
                             List<VideoQuality> qualityList,
                             VideoQuality currentQuality,
                             String userName)

// 步骤1：绑定控件
VideoDownloadListView mVideoDownloadListView = findViewById(R.id.video_download_list_view);
?
//步骤2: 添加数据  
mVideoDownloadListView.addCacheVideo(mDataList, true);
?

public void addCacheVideo(List<TXVodDownloadMediaInfo> mediaInfoList, boolean isNeedClean)；

// 步骤1：播放视频 superplayerModel的url 变量需要为空，且 videoId 不为空，这样才会通过 PlayWithField 播放，才能在 onPlayEvent 回调中获取到打点信息和雪碧图数据
mSuperplayerView.play(superplayerModel);
?
// 步骤2: PlayWithFileId 播放时候 在 VOD_PLAY_EVT_GET_PLAYINFO_SUCC 回调事件中取得打点信息和雪碧图信息
public void onPlayEvent(TXVodPlayer player, int event, Bundle param) {
    switch (event) {
        case TXVodConstants.VOD_PLAY_EVT_GET_PLAYINFO_SUCC:
?
            // 获取 雪碧图 图片链接 URL
            playImageSpriteInfo.imageUrls = param.getStringArrayList(TXVodConstants.EVT_IMAGESPRIT_IMAGEURL_LIST);
            // 获取 雪碧图 web vtt 描述文件下载 URL
            playImageSpriteInfo.webVttUrl = param.getString(TXVodConstants.EVT_IMAGESPRIT_WEBVTTURL);
            // 获取 打点信息    
           ArrayList<String> keyFrameContentList =
                    param.getStringArrayList(TXVodConstants.EVT_KEY_FRAME_CONTENT_LIST);
            // 获取 打点信息时间信息
            float[] keyFrameTimeArray = param.getFloatArray(TXVodConstants.EVT_KEY_FRAME_TIME_LIST);
?
            // 构建 打点信息数据列表
            if (keyFrameContentList != null && keyFrameTimeArray != null
                    && keyFrameContentList.size() == keyFrameTimeArray.length) {
                for (int i = 0; i < keyFrameContentList.size(); i++) {
                    PlayKeyFrameDescInfo frameDescInfo = new PlayKeyFrameDescInfo();
                    frameDescInfo.content = keyFrameContentList.get(i);
                    frameDescInfo.time = keyFrameTimeArray[i];
                    mKeyFrameDescInfoList.add(frameDescInfo);
                }
            }
            break;
        default:
            break;
　　}
}
?
// 步骤3: 将拿到的打点信息和雪碧图信息通过 updateVideoImageSpriteAndKeyFrame 方法赋值给对应的 view。 
// 雪碧图的 view 对应 VideoProgressLayout 组件中 mIvThumbnail。
// 打点信息的 view 对应 PointSeekBar 组件中的 TCPointView。
updateVideoImageSpriteAndKeyFrame(playImageSpriteInfo,keyFrameDescInfoList);

// 传入 字幕url， 字幕名称， 字幕类型
SubtitleSourceModel subtitleSourceModel = new SubtitleSourceModel();
subtitleSourceModel.name = "ex-cn-srt";
subtitleSourceModel.url = "https://mediacloud-76607.gzc.vod.tencent-cloud.com/DemoResource/TED-CN.srt";
subtitleSourceModel.mimeType = TXVodConstants.VOD_PLAY_MIMETYPE_TEXT_SRT;
model.subtitleSourceModelList.add(subtitleSourceModel);
?
?
// 播放
mSuperPlayerView.playWithModelNeedLicence(model);

// 开始播放视频后，选中添加的外挂字幕
public void onClickSubTitleItem(TXTrackInfo clickInfo) {
    List<TXTrackInfo> subtitleTrackInfoList = mVodPlayer.getSubtitleTrackInfo();
    for (TXTrackInfo trackInfo : subtitleTrackInfoList) {
        if (trackInfo.trackIndex == clickInfo.trackIndex) {
            // 选中字幕
            mVodPlayer.selectTrack(trackInfo.trackIndex);
            mSelectedSubtitleTrackInfo = trackInfo;
        } else {
            // 其它字幕不需要的话， 进行deselectTrack
            mVodPlayer.deselectTrack(trackInfo.trackIndex);
        }
    }
}

TXSubtitleRenderModel model = new TXSubtitleRenderModel();
model.canvasWidth = 1920;  // 字幕渲染画布的宽
model.canvasHeight = 1080;  // 字幕渲染画布的高
model.fontColor = 0xFFFFFFFF; // 设置字幕字体颜色，默认白色不透明
model.isBondFontStyle = false;  // 设置字幕字体是否为粗体
mVodPlayer.setSubtitleStyle(model);
?