-
Notifications
You must be signed in to change notification settings - Fork 122
Home
Android 播放器 SDK 是腾讯云开源的一款播放器组件,简单几行代码即可拥有类似腾讯视频强大的播放功能。包括横竖屏切换、清晰度选择、手势、小窗等基础功能,还支持视频缓存,软硬解切换,倍速播放等特殊功能。相比系统播放器,支持格式更多,兼容性更好,功能更强大。同时还支持直播流(flv+rtmp)播放,具备首屏秒开、低延迟的优点,清晰度无缝切换、直播时移等高级能力。
Android 播放器 SDK 完全免费开源,不对播放地址来源做限制,可以放心使用。
本文档部分内容为腾讯云专属能力,使用前请开通 腾讯云 相关服务,未注册用户可注册账号 免费试用。
- 下载 SDK + Demo 开发包,下载地址为 (Android)。
- 导入
SDK/LiteAVSDK_XXX.aar以及Demo/app/libs/lib_tcsuperplayer.aar到工程中去。 - 在
app/build.gralde中添加依赖:
compile(name: 'LiteAVSDK_Professional', ext: 'aar') compile(name: 'lib_tcsuperplayer', ext: 'aar') // 超级播放器弹幕集成的第三方库 compile 'com.github.ctiao:DanmakuFlameMaster:0.5.3'
- 在项目
build.gralde中添加:
...
allprojects {
repositories {
flatDir {
dirs 'libs'
}
...
}
}
...
- 权限声明
<!--网络权限--> <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" />
!
lib_tcsuperplayer.aar以 moudle 方式开源,您可在 Demo/lib_tcsuperplayer 中找到所有源代码。
播放器主类为SuperPlayerView,创建后即可播放视频。
mSuperPlayerView = findViewById(R.id.main_super_player_view); SuperPlayerModel model = new SuperPlayerModel(); model.videoURL = "http://200024424.vod.myqcloud.com/200024424_709ae516bdf811e6ad39991f76a4df69.f20.mp4"; mSuperPlayerView.playWithMode(model);
运行代码,可以看到视频在手机上播放,并且界面上大部分功能都处于可用状态。
上面的示例代码只有一种清晰度,如果要添加多个清晰度,也非常简单。以直播为例,打开 直播控制台,找到需要播放放的直播流,进入详情。
这里有不同清晰度、不同格式的播放地址。推荐使用 FLV 地址播放,代码如下:
SuperPlayerModel superPlayerModel = new SuperPlayerModel(); superPlayerModel.videoURL = "http://5815.liveplay.myqcloud.com/live/5815_89aad37e06ff11e892905cb9018cf0d4.flv"; superPlayerModel.multiVideoURLs = new ArrayList<>(); superPlayerModel.multiVideoURLs.add(new SuperPlayerUrl("超清","http://5815.liveplay.myqcloud.com/live/5815_89aad37e06ff11e892905cb9018cf0d4.flv")); superPlayerModel.multiVideoURLs.add(new SuperPlayerUrl("高清","http://5815.liveplay.myqcloud.com/live/5815_89aad37e06ff11e892905cb9018cf0d4_900.flv")); superPlayerModel.multiVideoURLs.add(new SuperPlayerUrl("标清","http://5815.liveplay.myqcloud.com/live/5815_89aad37e06ff11e892905cb9018cf0d4_550.flv")); mSuperPlayerView.playWithMode(superPlayerModel);
在播放器中即可看到这几个清晰度,单击即可立即切换。
直播清晰度
播放器开启时移非常简单,您只需要在播放前配置好 appId:
playerModel.appId = 1252463788;
? appId 在【腾讯云控制台】>【账号信息】中查到。
播放的直播流就能在下面看到进度条。往后拖动即可回到指定位置,单击【返回直播】可观看最新直播流。
! 时移功能处于公测申请阶段,如您需要可 提交工单 申请使用。
设置清晰度除了填写 url 外,更简单的使用方式是采用 fileId 播放。fileId 在一般是在视频上传后,由服务器返回:
如果文件已存在腾讯云,则可以进入 点播视频管理 ,找到对应的文件。点开后在右侧视频详情中,可以看到 appId 和 fileId。
视频管理
播放 fileId 的代码如下:
//通过fileid方式的视频信息配置 SuperPlayerModel model = new SuperPlayerModel(); model.appid = 1252463788; // 默认的app id model.fileid = "5285890781763144364"; // 视频的fileid; // 开始播放 mSuperPlayerView.playWithMode(model);
视频在上传后,后台会自动转码(所有转码格式请参考 转码模板。转码完成后,播放器会自动显示多个清晰度。
在播放长视频时,雪碧图和打点信息有助于观众找到该兴趣的点。使用腾讯云服务 API,能快速对视频处理。
任务执行成功后,播放器的界面会增加新的元素。
小窗播放可以悬浮在所有 Activity 之上播放。使用小窗播放非常简单,只需要在开始播放前调用下面代码即可:
// 播放器配置 SuperPlayerGlobalConfig prefs = SuperPlayerGlobalConfig.getInstance(); // 开启悬浮窗播放 prefs.enableFloatWindow = true; //设置悬浮窗的初始位置和宽高 SuperPlayerGlobalConfig.TXRect rect = new SuperPlayerGlobalConfig.TXRect(); rect.x = 0; rect.y = 0; rect.width = 810; rect.height = 540; // ...其他配置
当不需要播放器时,调用 resetPlayer 清理播放器内部状态,释放内存。
mSuperPlayerView.resetPlayer();
完整功能可扫码下载视频云工具包体验,或直接运行工程 Demo。
Android二维码下载