JiaoZiVideoPlayer多场景应用案例：列表播放/全屏/小窗口模式
项目地址: https://gitcode.com/gh_mirrors/ji/JiaoZiVideoPlayer 在移动应用开发中，视频播放功能常常需要适应多种复杂场景，如列表滑动播放、全屏切换和悬浮小窗口播放等。JiaoZiVideoPlayer作为一款高度可定制的Android视频框架，提供了灵活的API来满足这些需求。本文将通过实际案例，详细介绍如何在不同场景下集成和使用JiaoZiVideoPlayer，帮助开发者快速实现专业的视频播放功能。
一、列表播放场景实现
列表中的视频播放是社交媒体、资讯类应用的常见需求。JiaoZiVideoPlayer提供了多种列表播放解决方案，支持ListView和RecyclerView等常见列表控件。
1.1 ListView集成
ListView是Android传统的列表控件，JiaoZiVideoPlayer通过自定义Adapter和ViewHolder实现视频项的播放控制。核心实现代码位于app/src/main/java/cn/jzvd/demo/AdapterListView.java，该适配器处理了视频项的创建、绑定和回收逻辑。
在Activity中，通过点击事件启动不同类型的列表播放页面：
public void clickNormal(View view) {
startActivity(new Intent(ActivityListView.this, ActivityListViewNormal.class));
}
public void clickMultiHolder(View view) {
startActivity(new Intent(ActivityListView.this, ActivityListViewMultiHolder.class));
}
public void clickRecyclerView(View view) {
startActivity(new Intent(ActivityListView.this, ActivityListViewRecyclerView.class));
}
上述代码来自app/src/main/java/cn/jzvd/demo/ActivityListView.java，展示了如何通过简单的Intent跳转实现不同列表类型的切换。
1.2 RecyclerView优化方案
对于需要更高效性能的场景，推荐使用RecyclerView实现视频列表。JiaoZiVideoPlayer提供了专门的RecyclerView适配器app/src/main/java/cn/jzvd/demo/AdapterRecyclerView.java，通过复用机制减少资源消耗。
RecyclerView列表布局定义在app/src/main/res/layout/activity_recyclerview_content.xml，其中使用了自定义的视频播放控件：
<cn.jzvd.JzvdStd
android:id="@+id/item_jzvd"
android:layout_width="match_parent"
android:layout_height="200dp"
android:layout_centerInParent="true"/>
二、全屏播放与切换
全屏播放是视频应用的基础功能，JiaoZiVideoPlayer提供了灵活的全屏切换机制，支持自动和手动两种切换方式。
2.1 基础全屏实现
JiaoZiVideoPlayer的标准播放器JzvdStd已经内置了全屏功能，通过点击全屏按钮即可触发切换。核心实现位于jiaozivideoplayer/src/main/java/cn/jzvd/JzvdStd.java，其中处理了屏幕旋转、布局调整等关键逻辑。
2.2 自定义全屏行为
如果需要定制全屏后的UI表现，可以通过继承JzvdStd类实现。例如，app/src/main/java/cn/jzvd/demo/CustomJzvd/JzvdStdShowTitleAfterFullscreen.java实现了全屏后仍然显示标题的功能：
public class JzvdStdShowTitleAfterFullscreen extends JzvdStd {
// 重写全屏相关方法，自定义标题显示逻辑
@Override
public void startWindowFullscreen() {
super.startWindowFullscreen();
// 全屏后显示标题
titleTextView.setVisibility(VISIBLE);
}
}
三、小窗口模式实现
小窗口（悬浮窗）播放允许用户在使用应用其他功能的同时继续观看视频，极大提升了用户体验。JiaoZiVideoPlayer提供了完整的小窗口解决方案。
3.1 基础小窗口实现
小窗口功能的核心实现位于app/src/main/java/cn/jzvd/demo/CustomJzvd/JzvdStdTinyWindow.java，通过以下关键代码实现小窗口的创建和添加：
public void gotoScreenTiny() {
Log.i(TAG, "startWindowTiny " + " [" + this.hashCode() + "] ");
if (state == STATE_NORMAL || state == STATE_ERROR || state == STATE_AUTO_COMPLETE)
return;
ViewGroup vg = (ViewGroup) getParent();
vg.removeView(this);
cloneAJzvd(vg);
CONTAINER_LIST.add(vg);
ViewGroup vgg = (ViewGroup) (JZUtils.scanForActivity(getContext())).getWindow().getDecorView();
FrameLayout.LayoutParams lp = new FrameLayout.LayoutParams(400, 400);
lp.gravity = Gravity.RIGHT | Gravity.BOTTOM;
vgg.addView(this, lp);
setScreenTiny();
}
3.2 小窗口触发与控制
在Activity中，可以通过按钮点击触发小窗口模式：
public void clickTinyWindow(View view) {
jzvdStdTinyWindow.gotoScreenTiny();
}
上述代码来自app/src/main/java/cn/jzvd/demo/ActivityTinyWindow.java，展示了如何在Activity中集成小窗口功能。小窗口的布局定义在app/src/main/res/layout/activity_tiny_window.xml，通过自定义属性控制初始位置和大小。
四、多场景适配最佳实践
4.1 生命周期管理
在多场景切换时，正确管理播放器生命周期至关重要。JiaoZiVideoPlayer提供了便捷的生命周期管理方法，建议在Activity的onPause和onBackPressed中调用：
@Override
protected void onPause() {
super.onPause();
Jzvd.releaseAllVideos();
}
@Override
public void onBackPressed() {
if (Jzvd.backPress()) {
return;
}
super.onBackPressed();
}
4.2 自定义播放控件
JiaoZiVideoPlayer支持深度自定义播放控件，通过继承JzvdStd并覆盖相应方法，可以实现各种个性化需求。例如：
- JzvdStdSpeed：添加倍速播放功能
- JzvdStdMp3：音频播放专用控件
- MyJzvdStd：完全自定义的播放器实现
4.3 性能优化建议
- 列表播放时，使用RecyclerView代替ListView提升性能
- 滑动时暂停非可见区域的视频播放
- 小窗口模式下降低视频分辨率
- 合理使用缓存策略，减少重复网络请求
五、总结
JiaoZiVideoPlayer通过灵活的架构设计和丰富的API，为Android开发者提供了一站式视频播放解决方案。本文介绍的列表播放、全屏切换和小窗口模式只是其功能的冰山一角，更多高级特性如自定义解码器、弹幕支持和DRM加密等，可以通过深入研究官方文档和示例代码进一步探索。
无论是社交应用的短视频流，还是教育应用的课程播放，JiaoZiVideoPlayer都能提供稳定、高效的播放体验，帮助开发者快速实现产品需求。完整的示例代码和更多使用场景可以参考项目中的演示Activity，如ActivityApi.java和ActivityDirectPlay.java等。
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
