<com.tencent.rtmp.ui.TXCloudVideoViewandroid:id="@+id/video_view"android:layout_width="match_parent"android:layout_height="match_parent"android:layout_centerInParent="true"android:visibility="gone"/>
//mPlayerView 即步骤3中添加的视频渲染 viewTXCloudVideoView mPlayerView = findViewById(R.id.video_view);//创建 player 对象TXVodPlayer mVodPlayer = new TXVodPlayer(getActivity());//关联 player 对象与视频渲染 viewmVodPlayer.setPlayerView(mPlayerView);
// 播放 URL 视频资源String url = "http://1252463788.vod2.myqcloud.com/xxxxx/v.f20.mp4";mVodPlayer.startVodPlay(url);// 播放本地视频资源String localFile = "/sdcard/video.mp4";mVodPlayer.startVodPlay(localFile);// 从 11.8 版本开始支持播放器 content:// URI 视频资源和 asset 目录视频资源// 播放 content:// URI 视频资源String localFile = "content://xxx/xxx/video.mp4";mVodPlayer.startVodPlay(localFile);// 播放 asset 目录视频资源, 传入的地址必须以 asset:// 开头String localFile = "asset://video.mp4";mVodPlayer.startVodPlay(localFile);
// 推荐使用下面的新接口// psign 即播放器签名,签名介绍和生成方式参见链接:https://www.tencentcloud.com/document/product/266/38099TXPlayInfoParams playInfoParam = new TXPlayInfoParams(1252463788, // 腾讯云账户的appId"4564972819220421305", // 视频的fileId"psignxxxxxxx"); // 播放器签名mVodPlayer.startVodPlay(playInfoParam);// 旧接口,不推荐使用TXPlayerAuthBuilder authBuilder = new TXPlayerAuthBuilder();authBuilder.setAppId(1252463788);authBuilder.setFileId("4564972819220421305");mVodPlayer.startVodPlay(authBuilder);
TXLiveConstants.PLAY_ERR_GET_PLAYINFO_FAIL
事件,反之收到TXLiveConstants.PLAY_EVT_GET_PLAYINFO_SUCC
表示请求成功。onDestroy()
函数,否则可能会产生内存泄露和“Receiver not registered”报警。@Overridepublic void onDestroy() {super.onDestroy();mVodPlayer.stopPlay(true); // true 代表清除最后一帧画面mPlayerView.onDestroy();}
// 开始播放mVodPlayer.startVodPlay(url)
// 暂停播放mVodPlayer.pause();
// 恢复播放mVodPlayer.resume();
// 结束播放mVodPlayer.stopPlay(true);
int time = 600; // int类型时,单位为 秒// float time = 600; // float 类型时单位为 秒// 调整进度mVodPlayer.seek(time);
float time = 600; // float 类型时单位为 秒// 调整进度mVodPlayer.seek(time, true); // 精准 seekmVodPlayer.seek(time, false); // 非精准 seek
long pdtTimeMs = 600; // 单位为 毫秒mVodPlayer.seekToPdtTime(time);
float startTimeInSecond = 60; // 单位:秒mVodPlayer.setStartTime(startTimeInSecond); // 设置开始播放时间mVodPlayer.startVodPlay(url);
可选值 | 含义 |
RENDER_MODE_FULL_FILL_SCREEN | 将图像等比例铺满整个屏幕,多余部分裁剪掉,此模式下画面不会留黑边,但可能因为部分区域被裁剪而显示不全 |
RENDER_MODE_ADJUST_RESOLUTION | 将图像等比例缩放,适配最长边,缩放后的宽和高都不会超过显示区域,居中显示,画面可能会留有黑边 |
可选值 | 含义 |
RENDER_ROTATION_PORTRAIT | 正常播放(Home 键在画面正下方) |
RENDER_ROTATION_LANDSCAPE | 画面顺时针旋转270度(Home 键在画面正左方) |
// 将图像等比例铺满整个屏幕mVodPlayer.setRenderMode(TXLiveConstants.RENDER_MODE_FULL_FILL_SCREEN);// 正常播放(Home 键在画面正下方)mVodPlayer.setRenderRotation(TXLiveConstants.RENDER_ROTATION_PORTRAIT);
setRate
设置点播播放速率来完成,支持快速与慢速播放,如0.5X、1.0X、1.2X、2X等。// 设置1.2倍速播放mVodPlayer.setRate(1.2);
// 设置循环播放mVodPlayer.setLoop(true);// 获取当前循环播放状态mVodPlayer.isLoop();
// 设置静音,true 表示开启静音, false 表示关闭静音mVodPlayer.setMute(true);
// 屏幕截图mVodPlayer.snapshot(new ITXSnapshotListener() {@Overridepublic void onSnapshot(Bitmap bmp) {if (null != bmp) {//获取到截图bitmap}}});
autoPlay
为 NO,此时播放器会正常加载,但视频不会立刻开始播放。mVodPlayer.setAutoPlay(false); // 设置为非自动播放mVodPlayer.startVodPlay(url); // startVodPlay 后会加载视频,加载成功后不会自动播放// ......// 在播放器界面上展示广告// ......mVodPlayer.resume(); // 广告展示完调用 resume 开始播放视频
TXVodPlayConfig mPlayConfig = new TXVodPlayConfig();Map<String, String> headers = new HashMap<>();headers.put("Referer", "${Refer Content}");mPlayConfig.setHeaders(headers);mVodPlayer.setConfig(mPlayConfig);
mVodPlayer.stopPlay(true);mVodPlayer.enableHardwareDecode(true);mVodPlayer.startVodPlay(flvUrl, type);
// 获取多码率数组,TXBitrateItem 类字段含义:index-码率下标;width-视频宽;height-视频高;birate-视频码率ArrayList<TXBitrateItem> bitrates = mVodPlayer.getSupportedBitrates();int index = bitrates.get(i).index; // 指定要播的码率下标mVodPlayer.setBitrateIndex(index); // 切换码率到想要的清晰度// 获取当前播放的码率下标,返回值 -1000 为默认值,表示没有设置过码率标;返回值 -1 表示开启了自适应码流int index = mVodPlayer.getBitrateIndex();
mVodPlayer.setBitrateIndex(int)
切换码率。切换过程中,会重新拉取另一条流的数据,SDK 针对腾讯云的多码率文件做过优化,可以做到切换无卡顿。mVodPlayer.setBitrateIndex(-1); //index 参数传入-1
mVodPlayer.setBitrateIndex(int)
切换其它码率,切换后码流自适应也随之关闭。TXVodPlayConfig mPlayConfig = new TXVodPlayConfig();// 设为true,在IDR对齐时可平滑切换码率, 设为false时,可提高多码率地址打开速度mPlayConfig.setSmoothSwitchBitrate(true);mVodPlayer.setConfig(mPlayConfig);
mVodPlayer.setVodListener(new ITXVodPlayListener() {@Overridepublic void onPlayEvent(TXVodPlayer player, int event, Bundle param) {if (event == TXLiveConstants.PLAY_EVT_PLAY_PROGRESS) {// 加载进度, 单位是毫秒int playable_duration_ms = param.getInt(TXLiveConstants.EVT_PLAYABLE_DURATION_MS);mLoadBar.setProgress(playable_duration_ms); // 设置loading 进度条// 播放进度, 单位是毫秒int progress_ms = param.getInt(TXLiveConstants.EVT_PLAY_PROGRESS_MS);mSeekBar.setProgress(progress_ms); // 设置播放进度条// 视频总长, 单位是毫秒int duration_ms = param.getInt(TXLiveConstants.EVT_PLAY_DURATION_MS);// 可以用于设置时长显示等等// 获取 PDT 时间,播放器高级版 11.6 版本开始支持long pdt_time_ms = param.getLong(TXVodConstants.EVT_PLAY_PDT_TIME_MS);}}@Overridepublic void onNetStatus(TXVodPlayer player, Bundle bundle) {}});
onNetStatus
的NET_STATUS_NET_SPEED
获取当前网速。具体使用方法见 状态反馈(onNetStatus)。PLAY_EVT_PLAY_LOADING
事件后,显示当前网速。PLAY_EVT_VOD_LOADING_END
事件后,对显示当前网速的 view 进行隐藏。mVodPlayer.setVodListener(new ITXVodPlayListener() {@Overridepublic void onPlayEvent(TXVodPlayer player, int event, Bundle param) {if (event == TXLiveConstants.PLAY_EVT_PLAY_LOADING) {// 显示当前网速} else if (event == TXLiveConstants.PLAY_EVT_VOD_LOADING_END) {// 对显示当前网速的 view 进行隐藏}}@Overridepublic void onNetStatus(TXVodPlayer player, Bundle bundle) {// 获取实时速率, 单位:kbpsint speed = bundle.getInt(TXLiveConstants.NET_STATUS_NET_SPEED);}});
TXVodPlayer.getWidth()
和TXVodPlayer.getHeight()
获取当前宽高。mVodPlayer.setVodListener(new ITXVodPlayListener() {@Overridepublic void onPlayEvent(TXVodPlayer player, int event, Bundle param) {}@Overridepublic void onNetStatus(TXVodPlayer player, Bundle bundle) {//获取视频宽度int videoWidth = bundle.getInt(TXLiveConstants.NET_STATUS_VIDEO_WIDTH);//获取视频高度int videoHeight = bundle.getInt(TXLiveConstants.NET_STATUS_VIDEO_HEIGHT);}});// 获取视频宽高,需要在收到播放器的PLAY_EVT_VOD_PLAY_PREPARED 事件回调后才返回值mVodPlayer.getWidth();mVodPlayer.getHeight();
TXVodPlayConfig config = new TXVodPlayConfig();config.setMaxBufferSize(10); // 播放时最大缓冲大小。单位:MBmVodPlayer.setConfig(config); // 把config 传给 mVodPlayer
File sdcardDir = getApplicationContext().getExternalFilesDir(null);if (sdcardDir != null) {//设置播放引擎的全局缓存目录TXPlayerGlobalSetting.setCacheFolderPath(sdcardDir.getPath() + "/txcache");//设置播放引擎的全局缓存目录和缓存大小,//单位MBTXPlayerGlobalSetting.setMaxCacheSize(200);}//使用播放器
TXVodPlayer#setSurface
配置后播放,否则会出现播放异常。// DRM 播放请通过TXVodPlayer#setSurface
配置后播放,否则会出现播放异常mVodPlayer.setSurface(mPlayerView.getHolder().getSurface());// psign 即播放器签名,签名介绍和生成方式参见链接:https://www.tencentcloud.com/document/product/266/42436?from_cn_redirect=1TXPlayInfoParams playInfoParam = new TXPlayInfoParams(${appId}, // 腾讯云账户的 appId${fieId}, // DRM 加密视频的 fileId${psgin}); // 加密视频的播放器签名mVodPlayer.startVodPlay(playInfoParam);
// DRM 播放请通过TXVodPlayer#setSurface
配置后播放,否则会出现播放异常mVodPlayer.setSurface(mPlayerView.getHolder().getSurface());// 步骤一: 设置 Drm 证书提供商环境, 此步骤默认情况下不需要配置// Google Drm 证书提供商环境默认使用 googleapis.com 域名,可通过下面接口设置为 googleapis.cn 域名TXPlayerGlobalSetting.setDrmProvisionEnv(TXPlayerGlobalSetting.DrmProvisionEnv.DRM_PROVISION_ENV_CN); // googleapis.cn 域名证书地址// 步骤二: 通过 TXVodPlayer#startPlayDrm 接口播放TXPlayerDrmBuilder builder = new TXPlayerDrmBuilder();builder.setPlayUrl(${url}); // 设置播放视频的 urlbuilder.setKeyLicenseUrl(${keyLicneseUrl}); /// 设置解密 key urlmVodPlayer.startPlayDrm(builder);
startVodPlay
之前添加字幕和配置字幕样式,在收到 VOD_PLAY_EVT_VOD_PLAY_PREPARED
事件后,调用 selectTrack 选择字幕。 添加字幕后,并不会主动加载字幕, 调用 selectTrack
后,才会加载字幕,字幕选择成功会有 VOD_PLAY_EVT_SELECT_TRACK_COMPLETE
事件回调。// 把TXSubtitleView添加到播放器所在布局xml<com.tencent.rtmp.ui.TXSubtitleViewandroid:id="@+id/subtitle_view"android:layout_width="wrap_content"android:layout_height="wrap_content"/>mSubtitleView = findViewById(R.id.subtitle_view);// 设置字幕渲染目标对象mVodPlayer.setSubtitleView(mSubtitleView);
// 传入 字幕url, 字幕名称, 字幕类型,建议在启动播放前添加mVodPlayer.addSubtitleSource("https://mediacloud-76607.gzc.vod.tencent-cloud.com/DemoResource/subtitleVTT.vtt", "subtitleName", TXVodConstants.VOD_PLAY_MIMETYPE_TEXT_VTT);
// 开始播放视频后,选中添加的外挂字幕, 在收到VOD_PLAY_EVT_VOD_PLAY_PREPARED
事件后调用@Overridepublic void onPlayEvent(TXVodPlayer player, int event, Bundle param) {if (event == TXVodConstants.VOD_PLAY_EVT_VOD_PLAY_PREPARED) {List<TXTrackInfo> subtitleTrackInfoList = mVodPlayer.getSubtitleTrackInfo();for (TXTrackInfo track : subtitleTrackInfoList) {Log.d(TAG, "TrackIndex= " + track.getTrackIndex() + " ,name= " + track.getName());if (TextUtils.equals(track.getName(), "subtitleName")) {// 选中字幕mVodPlayer.selectTrack(track.trackIndex);} else {// 其它字幕不需要的话, 进行deselectTrackmVodPlayer.deselectTrack(track.trackIndex);}}}}// 如果需要,可以监听轨道切换消息mVodPlayer.setVodListener(new ITXVodPlayListener() {@Overridepublic void onPlayEvent(TXVodPlayer player, int event, Bundle param) {if (event == TXVodConstants.VOD_PLAY_EVT_SELECT_TRACK_COMPLETE) {int trackIndex = param.getInt(TXVodConstants.EVT_KEY_SELECT_TRACK_INDEX);int errorCode = param.getInt(TXVodConstants.EVT_KEY_SELECT_TRACK_ERROR_CODE);Log.d(TAG, "receive VOD_PLAY_EVT_SELECT_TRACK_COMPLETE, trackIndex=" + trackIndex + " ,errorCode=" + errorCode);}}@Overridepublic void onNetStatus(TXVodPlayer player, Bundle status) {}});
// 详细参数配置请参考 API 文档TXSubtitleRenderModel model = new TXSubtitleRenderModel();model.canvasWidth = 1920; // 字幕渲染画布的宽model.canvasHeight = 1080; // 字幕渲染画布的高model.fontColor = 0xFFFFFFFF; // 设置字幕字体颜色,默认白色不透明model.isBondFontStyle = false; // 设置字幕字体是否为粗体mVodPlayer.setSubtitleStyle(model);
// 返回音频轨道信息列表List<TXTrackInfo> soundTrackInfoList = mVodPlayer.getAudioTrackInfo();for (TXTrackInfo trackInfo : soundTrackInfoList) {if (trackInfo.trackIndex == 0) {// 通过判断 trackIndex 或者 name 切换到需要的音轨mVodPlayer.selectTrack(trackInfo.trackIndex);} else {// 不需要的音轨进行 deselectTrackmVodPlayer.deselectTrack(trackInfo.trackIndex);}}
// 播放视频 A: 如果将 autoPlay 设置为 true, 那么 startVodPlay 调用会立刻开始视频的加载和播放String urlA = "http://1252463788.vod2.myqcloud.com/xxxxx/v.f10.mp4";playerA.setAutoPlay(true);playerA.startVodPlay(urlA);// 在播放视频 A 的同时,预加载视频 B,做法是将 setAutoPlay 设置为 falseString urlB = @"http://1252463788.vod2.myqcloud.com/xxxxx/v.f20.mp4";playerB.setAutoPlay(false);playerB.startVodPlay(urlB); // 不会立刻开始播放,而只会开始加载视频
public void onPlayEvent(TXVodPlayer player, int event, Bundle param) {// 在视频 A 播放结束的时候,直接启动视频 B 的播放,可以做到无缝切换if (event == PLAY_EVT_PLAY_END) {playerA.stop();playerB.setPlayerView(mPlayerView);playerB.resume();}}
TXVodPlayConfig config = new TXVodPlayConfig();config.setMaxPreloadSize(2); // 预播放最大缓冲大小。单位:MB, 根据业务情况设置去节省流量mVodPlayer.setConfig(config); // 把config 传给 mVodPlayer
TXVodPlayConfig config = new TXVodPlayConfig();config.setMaxBufferSize(10); // 播放时最大缓冲大小。单位:MBmVodPlayer.setConfig(config); // 把config 传给 mVodPlayer
//先设置播放引擎的全局缓存目录和缓存大小File sdcardDir = getApplicationContext().getExternalFilesDir(null);//设置播放引擎的全局缓存目录和缓存大小if (sdcardDir != null) {TXPlayerGlobalSetting.setCacheFolderPath(sdcardDir.getPath() + "/PlayerCache");TXPlayerGlobalSetting.setMaxCacheSize(200); //单位MB}String palyrl = "http://****";//启动预下载final TXVodPreloadManager downloadManager = TXVodPreloadManager.getInstance(getApplicationContext());final int taskID = downloadManager.startPreload(playUrl, 3, 1920*1080, new ITXVodPreloadListener() {@Overridepublic void onComplete(int taskID, String url) {Log.d(TAG, "preload: onComplete: url: " + url);}@Overridepublic void onError(int taskID, String url, int code, String msg) {Log.d(TAG, "preload: onError: url: " + url + ", code: " + code + ", msg: " + msg);}});//取消预下载downloadManager.stopPreload(taskID);
//先设置播放引擎的全局缓存目录和缓存大小File sdcardDir = getApplicationContext().getExternalFilesDir(null);//设置播放引擎的全局缓存目录和缓存大小if (sdcardDir != null) {TXPlayerGlobalSetting.setCacheFolderPath(sdcardDir.getPath() + "/PlayerCache");TXPlayerGlobalSetting.setMaxCacheSize(200); //单位MB}// 启动预下载Runnable task = new Runnable() {@Overridepublic void run() {TXPlayInfoParams playInfoParams = new TXPlayInfoParams(${appId}, "${fileId}","${psign}");// 注意: 耗时操作,请不要在主线程调用!在主线程调用将会抛出非法调用异常。mPreLoadManager.startPreload(playInfoParams, 3, 1920 * 1080, new ITXVodFilePreloadListener() {@Overridepublic void onStart(int taskID, String fileId, String url, Bundle bundle) {// 通过 fileId 换链成功后会回调 onStartLog.d(TAG, "preload: onStart: taskID: " + taskID + ", fileId: " + fileId + ", url: " + url + ",bundle: " + bundle);}@Overridepublic void onComplete(int taskID, String url) {Log.d(TAG, "preload: onComplete: url: " + url);}@Overridepublic void onError(int taskID, String url, int code, String msg) {Log.d(TAG, "preload: onError: url: " + url + ", code: " + code + ", msg: " + msg);}});}};new Thread(task).start();//取消预下载downloadManager.stopPreload(taskID);
TXVodDownloadManager
的视频下载方案实现 HLS 的离线播放。TXVodDownloadManager
暂不支持缓存 MP4 和 FLV 格式的文件。File sdcardDir = context.getExternalFilesDir(null);TXPlayerGlobalSetting.setCacheFolderPath(sdcardDir.getPath() + "/txcache");
TXVodDownloadManager
被设计为单例,因此您不能创建多个下载对象。用法如下:TXVodDownloadManager downloader = TXVodDownloadManager.getInstance();
// QUALITY_240P 240p// QUALITY_360P 360P// QUALITY_480P 480p// QUALITY_540P 540p// QUALITY_720P 720p// QUALITY_1080P 1080p// QUALITY_2K 2k// QUALITY_4K 4k// quality参数可以自定义,取分辨率宽高最小值(如分辨率为1280*720, 期望下载此分辨率的流,quality传入 QUALITY_720P)// 播放器 SDK 会选择小于或等于传入分辨率的流进行下载TXVodDownloadDataSource source = new TXVodDownloadDataSource(1252463788, "4564972819220421305", QUALITY_720P, "pSignxxxx", ""); //pSign 加密视频签名, 通过fileId下载必填downloader.startDownload(source)
downloader.startDownloadUrl("http://1500005830.vod2.myqcloud.com/43843ec0vodtranscq1500005830/00eb06a88602268011437356984/video_10_0.m3u8", "");
downloader.setListener(this);
回调信息 | 说明 |
void onDownloadStart(TXVodDownloadMediaInfo mediaInfo) | 任务开始,表示 SDK 已经开始下载 |
void onDownloadProgress(TXVodDownloadMediaInfo mediaInfo) | 任务进度,下载过程中,SDK 会频繁回调此接口,您可以通过 mediaInfo.getProgress() 获取当前进度 |
void onDownloadStop(TXVodDownloadMediaInfo mediaInfo) | 任务停止,当您调用 stopDownload 停止下载,收到此消息表示停止成功 |
void onDownloadFinish(TXVodDownloadMediaInfo mediaInfo) | 下载完成,收到此回调表示已全部下载。此时下载文件可以给 TXVodPlayer 播放 |
void onDownloadError(TXVodDownloadMediaInfo mediaInfo, int error, String reason) | 下载错误,下载过程中遇到网络断开会回调此接口,同时下载任务停止。错误码位于 TXVodDownloadManager 中 |
错误码 | 数值 | 含义说明 |
DOWNLOAD_SUCCESS | 0 | 下载成功。 |
DOWNLOAD_AUTH_FAILED | -5001 | 向云点播控制台请求视频信息失败,建议检查fileId、psign参数是否正确。 |
DOWNLOAD_NO_FILE | -5003 | 无此清晰度文件。 |
DOWNLOAD_FORMAT_ERROR | -5004 | 下载文件格式不支持。 |
DOWNLOAD_DISCONNECT | -5005 | 网络断开,建议检查网络是否正常。 |
DOWNLOAD_HLS_KEY_ERROR | -5006 | 获取 HLS 解密 Key 失败。 |
DOWNLOAD_PATH_ERROR | -5007 | 下载目录访问失败,建议检查是否有访问下载目录的权限。 |
DOWNLOAD_403FORBIDDEN | -5008 | 请求下载时,鉴权信息不通过,建议检查签名(psign) 是否已过期。 |
TXVodDownloadMediaInfo
对象,您可以访问 URL 或 dataSource 判断下载源,同时还可以获取到下载进度、文件大小等信息。downloader.stopDownload()
方法,参数为downloader.startDownload()
返回的对象。SDK 支持断点续传,当下载目录没有发生改变时,下次下载同一个文件时会从上次停止的地方重新开始。// 获取所有用户的下载列表信息// 接入方可根据下载信息中的userName区分不同用户的下载列表信息// getDownloadMediaInfoList 是耗时接口,请不要在主线程调用List<TXVodDownloadMediaInfo> downloadInfoList = downloader.getDownloadMediaInfoList();if (downloadInfoList == null || downloadInfoList.size() <= 0) return;// 获取默认“default”用户的下载列表List<TXVodDownloadMediaInfo> defaultUserDownloadList = new ArrayList<>();for(TXVodDownloadMediaInfo downloadMediaInfo : downloadInfoList) {if ("default".equals(downloadMediaInfo.getUserName())) {defaultUserDownloadList.add(downloadMediaInfo);}}
// 获取某个fileId相关下载信息// getDownloadMediaInfo 是耗时接口,请不要在主线程调用TXVodDownloadMediaInfo downloadInfo = downloader.getDownloadMediaInfo(1252463788, "4564972819220421305", QUALITYHD);// 获取下载文件总大小,单位:Byte,只针对 fileid 下载源有效。// 备注:总大小是指上传到腾讯云点播控制台的原始文件的大小,转自适应码流后的子流大小,暂时无法获取。int size = downloadInfo.getSize(); // 获取下载文件总大小int duration = downloadInfo.getDuration(); // 获取总时长int playableDuration = downloadInfo.getPlayableDuration(); // 获取已下载的可播放时长float progress = downloadInfo.getProgress(); // 获取下载进度String playPath = downloadInfo.getPlayPath(); // 获取离线播放路径,传给播放器即可离线播放int downloadState = downloadInfo.getDownloadState(); // 获取下载状态,具体参考STATE_xxx常量boolean isDownloadFinished = downloadInfo.isDownloadFinished(); // 返回true表示下载完成
// 获取某个url下载信息, 耗时接口,请不要在主线程调用TXVodDownloadMediaInfo downloadInfo = downloader.getDownloadMediaInfo("http://1253131631.vod2.myqcloud.com/26f327f9vodgzp1253131631/f4bdff799031868222924043041/playlist.m3u8”);
// 删除下载信息boolean deleteRst = downloader.deleteDownloadMediaInfo(downloadInfo);
TXVodDownloadMediaInfo#getPlayPath
获取到下载地址即可进行播放。// getDownloadMediaInfoList 是耗时接口,请不要在主线程调用List<TXVodDownloadMediaInfo> mediaInfoList = TXVodDownloadManager.getInstance().getDownloadMediaInfoList();// 业务侧根据实际需求查找到需要播放的 media 对象for (TXVodDownloadMediaInfo mediaInfo : mediaInfoList) {if (mediaInfo.getDownloadState() == TXVodDownloadMediaInfo.STATE_FINISH) { // 判断是否下载完成mVodPlayer.startVodPlay(mediaInfo.getPlayPath()); // 播放已经下载完成的视频}}
// psign 即播放器签名,签名介绍和生成方式参见链接:https://www.tencentcloud.com/document/product/266/38099TXPlayInfoParams playInfoParam = new TXPlayInfoParams(1252463788, // 腾讯云账户的appId"4564972819220421305", // 视频的fileId"psignxxxxxxx"); // 播放器签名mVodPlayer.startVodPlay(playInfoParam);
TXVodPlayConfig config = new TXVodPlayConfig();config.setEnableAccurateSeek(true); // 设置是否精确 seek,默认 trueconfig.setMaxCacheItems(5); // 设置缓存文件个数为5config.setProgressInterval(200); // 设置进度回调间隔,单位毫秒config.setMaxBufferSize(50); // 最大预加载大小,单位 MBmVodPlayer.setConfig(config); // 把config 传给 mVodPlayer
TXVodPlayConfig config = new TXVodPlayConfig();// 传入参数为视频宽和高的乘积(宽 * 高),可以自定义值传入config.setPreferredResolution(TXLiveConstants.VIDEO_RESOLUTION_720X1280);mVodPlayer.setConfig(config); // 把config 传给 mVodPlayer
TXVodPlayConfig#setMediaType
减少播放器SDK内部播放类型探测,提升启播速度。TXVodPlayConfig#setMediaType
11.2 版本开始支持。TXVodPlayConfig config = new TXVodPlayConfig();config.setMediaType(TXVodConstants.MEDIA_TYPE_FILE_VOD); // 用于提升MP4启播速度// config.setMediaType(TXVodConstants.MEDIA_TYPE_HLS_VOD); // 用于提升HLS启播速度mVodPlayer.setConfig(config);
TXVodPlayConfig config = new TXVodPlayConfig();config.setProgressInterval(200); // 设置进度回调间隔,单位毫秒mVodPlayer.setConfig(config); // 把config 传给 mVodPlayer
// 步骤1: 打开 HttpDNS 解析开关TXLiveBase.enableCustomHttpDNS(true);// 步骤2: 设置 HttpDNS 解析回调, TXLiveBaseListener#onCustomHttpDNSTXLiveBase.setListener(new TXLiveBaseListener() {@Overridepublic void onCustomHttpDNS(String hostName, List<String> ipList) {// 把 hostName 解析到 ip 地址后,保存到 iPList,返回给 SDK 内部。注意:这里不要进行异步操作。// MSDKDnsResolver 是腾讯云提供的 HTTPDNS SDK 解析接口String ips = MSDKDnsResolver.getInstance().getAddrByName(hostname);String[] ipArr = ips.split(";");if (0 != ipArr.length) {for (String ip : ipArr) {if ("0".equals(ip)) {continue;}ipList.add(ip);}}}});
//设置备选播放链接 String backupPlayUrl = "${backupPlayUrl}"; // 备选播放链接 mVodPlayer.setStringOption(TXVodConstants.VOD_KEY_MIMETYPE, TXVodConstants.VOD_PLAY_MIMETYPE_H265); // 指定原始 HEVC 视频编码类型 mVodPlayer.setStringOption(TXVodConstants.VOD_KEY_BACKUP_URL, backupPlayUrl); // 设置 H.264 格式等备选播放链接地址 // 设置原始 HEVC 播放链接 String hevcPlayUrl = "${hevcPlayUrl}"; mVodPlayer.startVodPlay(hevcPlayUrl);
TXVodPlayer#setAudioNormalization
设置音量均衡,响度范围:-70~0 (LUFS),同时支持自定义数值。/**可填预设值(相关类或文件:Android:TXVodConstants;iOS:TXVodPlayConfig.h)关:AUDIO_NORMALIZATION_OFF开:AUDIO_NORMALIZATION_STANDARD(标准)AUDIO_NORMALIZATION_LOW (低)AUDIO_NORMALIZATION_HIGH(高)可填自定义数值:从低到高,范围-70 - 0 LUFS*/mVodPlayer.setAudioNormalization(TXVodConstants.AUDIO_NORMALIZATION_STANDARD); //启动音量均衡mVodPlayer.setAudioNormalization(TXVodConstants.AUDIO_NORMALIZATION_OFF); //关闭音量均衡
事件 ID | 数值 | 含义说明 |
PLAY_EVT_PLAY_BEGIN | 2004 | 视频播放开始 |
PLAY_EVT_PLAY_PROGRESS | 2005 | 视频播放进度,会通知当前播放进度、加载进度 和总体时长 |
PLAY_EVT_PLAY_LOADING | 2007 | 视频播放 loading,如果能够恢复,之后会有 LOADING_END 事件 |
PLAY_EVT_VOD_LOADING_END | 2014 | 视频播放 loading 结束,视频继续播放 |
TXVodConstants.VOD_PLAY_EVT_SEEK_COMPLETE | 2019 | Seek 完成,10.3版本开始支持 |
VOD_PLAY_EVT_LOOP_ONCE_COMPLETE | 6001 | 循环播放,一轮播放结束(10.8 版本开始支持) |
TXVodConstants.VOD_PLAY_EVT_HIT_CACHE | 2002 | 启播时命中缓存事件(11.2 版本开始支持)。 |
TXVodConstants.VOD_PLAY_EVT_VIDEO_SEI | 2030 | 收到 SEI 帧事件( 播放器高级版11.6 版本开始支持)。 |
VOD_PLAY_EVT_HEVC_DOWNGRADE_PLAYBACK | 2031 | 发生 HEVC 降级播放(播放器高级版12.0版本开始支持)。 |
VOD_PLAY_EVT_FIRST_VIDEO_PACKET | 2017 | 播放器收到首帧数据包事件(12.0 版本开始支持)。 |
@Override public void onPlayEvent(TXVodPlayer player, int event, Bundle param) { if (event == TXVodConstants.VOD_PLAY_EVT_VIDEO_SEI) { int seiType = param.getInt(TXVodConstants.EVT_KEY_SEI_TYPE); // the type of video SEI int seiSize = param.getInt(TXVodConstants.EVT_KEY_SEI_SIZE); // the data size of video SEI byte[] seiData = param.getByteArray(TXVodConstants.EVT_KEY_SEI_DATA); // the byte array data of video SEI } }
事件 ID | 数值 | 含义说明 |
PLAY_EVT_PLAY_END | 2006 | 视频播放结束 |
PLAY_ERR_NET_DISCONNECT | -2301 | 网络断连,且经多次重连亦不能恢复,更多重试请自行重启播放 |
PLAY_ERR_HLS_KEY | -2305 | HLS 解密 key 获取失败 |
事件 ID | 数值 | 含义说明 |
PLAY_WARNING_VIDEO_DECODE_FAIL | 2101 | 当前视频帧解码失败 |
PLAY_WARNING_AUDIO_DECODE_FAIL | 2102 | 当前音频帧解码失败 |
PLAY_WARNING_RECONNECT | 2103 | 网络断连, 已启动自动重连 (重连超过三次就直接抛送 PLAY_ERR_NET_DISCONNECT 了) |
PLAY_WARNING_HW_ACCELERATION_FAIL | 2106 | 硬解启动失败,采用软解 |
事件 ID | 数值 | 含义说明 |
PLAY_EVT_VOD_PLAY_PREPARED | 2013 | 播放器已准备完成,可以播放。设置了 autoPlay 为 false 之后,需要在收到此事件后,调用 resume 才会开始播放 |
PLAY_EVT_RCV_FIRST_I_FRAME | 2003 | 网络接收到首个可渲染的视频数据包(IDR) |
事件 ID | 数值 | 含义说明 |
PLAY_EVT_CHANGE_RESOLUTION | 2009 | 视频分辨率改变 |
PLAY_EVT_CHANGE_ROTATION | 2011 | MP4 视频旋转角度 |
事件 ID | 数值 | 含义说明 |
TXLiveConstants.PLAY_EVT_GET_PLAYINFO_SUCC | 2010 | 成功获取播放文件信息 |
TXLiveConstants.PLAY_EVT_GET_PLAYINFO_SUCC
事件后,解析 param 获取视频信息。视频信息 | 含义说明 |
EVT_PLAY_COVER_URL | 视频封面地址 |
EVT_PLAY_URL | 视频播放地址 |
EVT_PLAY_DURATION | 视频时长 |
EVT_DESCRIPTION | 事件说明 |
EVT_PLAY_NAME | 视频名称 |
TXVodConstants.EVT_IMAGESPRIT_WEBVTTURL | 雪碧图 web vtt 描述文件下载 URL,10.2版本开始支持 |
TXVodConstants.EVT_IMAGESPRIT_IMAGEURL_LIST | 雪碧图图片下载 URL,10.2版本开始支持 |
TXVodConstants.EVT_DRM_TYPE | 加密类型,10.2版本开始支持 |
TXVodConstants.EVT_KEY_WATER_MARK_TEXT | 幽灵水印文本内容(11.6 版本开始支持)。 |
mVodPlayer.setVodListener(new ITXVodPlayListener() {@Overridepublic void onPlayEvent(TXVodPlayer player, int event, Bundle param) {if (event == TXLiveConstants.PLAY_EVT_VOD_PLAY_PREPARED) {// 收到播放器已经准备完成事件,此时可以调用pause、resume、getWidth、getSupportedBitrates 等接口} else if (event == TXLiveConstants.PLAY_EVT_PLAY_BEGIN) {// 收到开始播放事件} else if (event == TXLiveConstants.PLAY_EVT_PLAY_END) {// 收到开始结束事件}}@Overridepublic void onNetStatus(TXVodPlayer player, Bundle bundle) {}});
TXVodConstants#VOD_PLAY_EVT_GET_PLAYINFO_SUCC
事件后, 通过 param.getString(TXVodConstants.EVT_KEY_WATER_MARK_TEXT)
获取。详细使用教程参见 超级播放器组件 > 幽灵水印。事件 ID | 数值 | 含义说明 |
PLAY_ERR_NET_DISCONNECT | -2301 | 视频数据错误导致重试亦不能恢复正常播放。如:网络异常或下载数据错误,导致解封装超时或失败。 |
PLAY_ERR_HLS_KEY | -2305 | HLS 解密 key 获取失败。 |
VOD_PLAY_ERR_SYSTEM_PLAY_FAIL | -6004 | 系统播放器播放错误。 |
VOD_PLAY_ERR_DECODE_VIDEO_FAIL | -6006 | 视频解码错误,视频格式不支持。 |
VOD_PLAY_ERR_DECODE_AUDIO_FAIL | -6007 | 音频解码错误,音频格式不支持。 |
VOD_PLAY_ERR_DECODE_SUBTITLE_FAIL | -6008 | 字幕解码错误。 |
VOD_PLAY_ERR_RENDER_FAIL | -6009 | 视频渲染错误。 |
VOD_PLAY_ERR_PROCESS_VIDEO_FAIL | -6010 | 视频后处理错误。 |
VOD_PLAY_ERR_GET_PLAYINFO_FAIL | -2306 | 获取点播文件信息失败,建议检查 AppId、FileId 或 Psign 填写是否正确。 |
评估参数 | 含义说明 |
NET_STATUS_CPU_USAGE | 当前瞬时 CPU 使用率 |
NET_STATUS_VIDEO_WIDTH | 视频分辨率 - 宽 |
NET_STATUS_VIDEO_HEIGHT | 视频分辨率 - 高 |
NET_STATUS_NET_SPEED | 当前的网络数据接收速度,单位:KBps。 |
NET_STATUS_VIDEO_FPS | 当前流媒体的视频帧率 |
NET_STATUS_VIDEO_BITRATE | 当前流媒体的视频码率,单位 bps |
NET_STATUS_AUDIO_BITRATE | 当前流媒体的音频码率,单位 bps |
NET_STATUS_VIDEO_CACHE | 缓冲区(jitterbuffer)大小,缓冲区当前长度为0,说明离卡顿就不远了 |
NET_STATUS_SERVER_IP | 连接的服务器 IP |
mVodPlayer.setVodListener(new ITXVodPlayListener() {@Overridepublic void onPlayEvent(TXVodPlayer player, int event, Bundle param) {}@Overridepublic void onNetStatus(TXVodPlayer player, Bundle bundle) {//获取当前CPU使用率CharSequence cpuUsage = bundle.getCharSequence(TXLiveConstants.NET_STATUS_CPU_USAGE);//获取视频宽度int videoWidth = bundle.getInt(TXLiveConstants.NET_STATUS_VIDEO_WIDTH);//获取视频高度int videoHeight = bundle.getInt(TXLiveConstants.NET_STATUS_VIDEO_HEIGHT);//获取实时速率, 单位:kbpsint speed = bundle.getInt(TXLiveConstants.NET_STATUS_NET_SPEED);//获取当前流媒体的视频帧率int fps = bundle.getInt(TXLiveConstants.NET_STATUS_VIDEO_FPS);//获取当前流媒体的视频码率,单位 bpsint videoBitRate = bundle.getInt(TXLiveConstants.NET_STATUS_VIDEO_BITRATE);//获取当前流媒体的音频码率,单位 bpsint audioBitRate = bundle.getInt(TXLiveConstants.NET_STATUS_AUDIO_BITRATE);//获取缓冲区(jitterbuffer)大小,缓冲区当前长度为0,说明离卡顿就不远了int jitterbuffer = bundle.getInt(TXLiveConstants.NET_STATUS_VIDEO_CACHE);//获取连接的服务器的IP地址String ip = bundle.getString(TXLiveConstants.NET_STATUS_SERVER_IP);}});
TXVodPlayConfig config = new TXVodPlayConfig(); config.setMediaType(TXVodConstants.MEDIA_TYPE_HLS_LIVE); // 指定HLS直播媒资类型 mVodPlayer.setConfig(config); mVodPlayer.startVodPlay(${YOUR_HSL_LIVE_URL});
本页内容是否解决了您的问题?