资讯详情 GSYVideoPlayer 如何在 Compose Native 模式自绘播放控制层并订阅 events 与 stateFlow
📅 2026/11/16 10:17:12
GSYVideoPlayer 如何在 Compose Native 模式自绘播放控制层并订阅 events 与 stateFlow【免费下载链接】GSYVideoPlayerVideo players (IJKplayer, ExoPlayer, MediaPlayer), HTTPS, 16k page size, danmaku (bullet chat) support, external subtitles, support for filters, watermarks, and GIF screenshots, pre-roll and mid-roll ads, multiple simultaneous playback, basic seeking/dragging, volume and brightness adjustment, play-while-cache support项目地址: https://gitcode.com/GitHub_Trending/gs/GSYVideoPlayer当业务要求播放 UI 完全由 Compose 重绘、但仍要复用 GSYVideoPlayer 的多内核与渲染管线时gsyVideoPlayer-compose模块的 Native 模式GSYPlayerControllerGSYPlayerSurface是文档给出的对应路径画面由GSYPlayerSurface承载内部是AndroidView中的隐藏 UI host player控制层则用任意 Compose 组件自绘播放状态不再走 callback而是通过controller.snapshotComposeState、controller.stateFlowStateFlow和controller.eventsSharedFlow 边沿事件三条通道订阅。本文按「引入依赖 → 搭最小 Native 屏幕 → 自绘控制层 → 验证与约束」的顺序把这条路径走通。适用前提来自 doc/COMPOSE_USE.md模块版本 v13.1.0 起随主版本发布外部坐标io.github.carguo:gsyvideoplayer-compose:13.1.0环境要求minSdk ≥ 23、Kotlin 2.0.x、AGP 8.6、JDK 17模块内部已通过compose-bom 2024.06.00统一 Compose 依赖版本并使用 Compose Compiler Gradle Plugin无需再单独指定composeCompilerVersion。一、引入依赖// 方式 AMaven Central / GitHub Packages implementation io.github.carguo:gsyvideoplayer-compose:13.1.0 // 方式 B本仓库内源码依赖在仓库内开发/调试时用 implementation project(:gsyVideoPlayer-compose)模块本身已api依赖gsyVideoPlayer-java无需重复引入如果你要用 EXO/Ali 内核还需按原 GSY 的方式额外引入对应坐标。二、Native 模式的三个构件构件职责rememberGSYPlayerController(url, autoPlay, ...)创建并记忆GSYPlayerController传了url时内部以LaunchedEffect执行controller.setUp(url, ...)离开 Composition 时自动dispose()GSYPlayerSurface(controller, modifier)纯渲染层只承载画面不绘制任何控制 UI可在其上叠加任意 Compose 控制层controller.snapshot/stateFlow/events状态订阅三通道StateGSYPlayerSnapshotCompose 渲染用、StateFlowGSYPlayerSnapshot协程/ViewModel 用、SharedFlowGSYPlayerEvent一次性边沿事件如果不想自绘顶层封装GSYComposePlayer(controller, showDefaultControls true)一行就能得到「画面 默认控制条」。自绘控制层的做法就是不用它自己在同一个Box里把GSYPlayerSurface和你的控件 Composable 叠在一起参考模块结构见 GSYDefaultControls.kt 顶部注释。三、步骤 1建 controller、挂 Surface、接上两条订阅以下代码与 doc/COMPOSE_USE.md 第三节示例及 FullFeatureNativeActivity.kt 的写法一致url使用仓库 demo 数据中的测试地址DemoVideoUrls.java 的SAMPLE_GSY替换成自己的视频地址即可import android.util.Log import androidx.compose.foundation.layout.Box import androidx.compose.foundation.layout.fillMaxSize import androidx.compose.runtime.Composable import androidx.compose.runtime.LaunchedEffect import androidx.compose.runtime.getValue import androidx.compose.ui.Modifier import com.shuyu.gsyvideoplayer.compose.native_.GSYPlayerEvent import com.shuyu.gsyvideoplayer.compose.native_.GSYPlayerSurface import com.shuyu.gsyvideoplayer.compose.native_.rememberGSYPlayerController import kotlinx.coroutines.flow.distinctUntilChanged import kotlinx.coroutines.flow.map // DemoVideoUrls.SAMPLE_GSY仓库 Compose Demo 共用的测试样片 private const val URL https://res.exexm.com/cw_145225549855002 Composable fun NativeCustomControlsScreen() { // 传 url 即自动 setUpautoPlay true 表示 attach 完成后自动 startPlayLogic val controller rememberGSYPlayerController(url URL, autoPlay true) val snap by controller.snapshot // 1) 边沿事件一个 LaunchedEffect 即可处理多种事件无需多个 setter LaunchedEffect(controller) { controller.events.collect { event - when (event) { is GSYPlayerEvent.Prepared - Log.d(GSY, 已准备就绪此时可取 duration/videoSize) is GSYPlayerEvent.Error - Log.e(GSY, 播放失败 what${event.what} extra${event.extra}) GSYPlayerEvent.AutoComplete - Log.d(GSY, 播放完成) else - Unit } } } // 2) StateFlow 形态适合在 ViewModel / UseCase 里 collect LaunchedEffect(controller) { controller.stateFlow .map { it.isPlaying } .distinctUntilChanged() .collect { isPlaying - Log.d(GSY, isPlaying$isPlaying) } } // 3) 画面层自绘控制层叠加在它之上见下一节 Box(Modifier.fillMaxSize()) { GSYPlayerSurface(controller, Modifier.matchParentSize()) } }GSYPlayerSnapshot的字段GSYPlayerState.ktstateIdle/Preparing/Playing/Buffering/Paused/Completed/Error与内核GSYVideoView.CURRENT_STATE_*一一对应、currentPosition、duration、bufferPercent、isPlaying、videoWidth/videoHeight以及netSpeed、isCacheReady、speed、isLocked等扩展字段。四、步骤 2自绘控制层完整可运行参照是 CustomControlsThemeComposeActivity.ktDemo 列表中第 24 项「自定义主题 Controls」渐变浮层 自定义播放按钮 Slider拖拽 seek 点画面切换浮层显隐完全用 Compose 控件替代GSYDefaultControls。其骨架如下url替换为自己的地址Composable fun ScreenWithOwnControls(url: String) { val controller rememberGSYPlayerController() val snap by controller.snapshot var overlayVisible by remember { mutableStateOf(true) } var dragging by remember { mutableStateOf(false) } var dragValue by remember { mutableFloatStateOf(0f) } // 用完整 builder 配置与 Java 端链式 builder 相同的一套 GSYVideoOptionBuilder LaunchedEffect(Unit) { val builder GSYVideoOptionBuilder() .setUrl(url) .setVideoTitle(Custom Controls Demo) .setIsTouchWiget(false) // 内核自带的手势 UI 关闭手势交给自绘层 controller.setUp(builder, autoPlay true) } Box( modifier Modifier .fillMaxWidth() .aspectRatio(16f / 9f) .background(Color.Black) .pointerInput(Unit) { detectTapGestures(onTap { overlayVisible !overlayVisible }) } ) { GSYPlayerSurface(controller controller, modifier Modifier.fillMaxSize()) // 自绘控制层全部由 snap 驱动 if (overlayVisible) { Box(Modifier.fillMaxSize()) { // 中央播放/暂停按钮 Box( Modifier.align(Alignment.Center), contentAlignment Alignment.Center ) { Box( Modifier .size(64.dp) .clip(CircleShape) .background(Color.White.copy(alpha 0.85f)) .pointerInput(Unit) { detectTapGestures(onTap { controller.togglePlayPause() }) } ) } // 底部进度条拖拽中只更新本地预览抬手才一次性 seekTo val maxMs snap.duration.coerceAtLeast(1L).toFloat() Slider( value if (dragging) dragValue else snap.currentPosition.toFloat().coerceIn(0f, maxMs), onValueChange { dragging true; dragValue it }, onValueChangeFinished { controller.seekTo(dragValue.toLong()) // 抬手提交避免每帧 seek 卡顿 dragging false }, valueRange 0f..maxMs, modifier Modifier.align(Alignment.BottomCenter) ) Text( ${snap.currentPosition}/${snap.duration} ms · buffer ${snap.bufferPercent}%, color Color.White, modifier Modifier.align(Alignment.BottomStart) ) } } } }几点与自绘直接相关的取舍均来自源码注释与 demo 实现seek 的提交时机模块自带的 GSYDefaultControls.kt 同样是「拖拽期间只改本地预览状态、onValueChangeFinished才一次性controller.seekTo」自绘层照此实现即可避免每帧 seek 造成卡顿。需要内核尚未封装的能力字幕、镜像、截图、滤镜等时用controller.withHost { player - ... }逃生口例如player.setSubTitle(...)。两个硬约束必须在主线程调用禁止在 block 里调player.setVideoAllCallBack(...)——那会把 controller 内部稳定的 dispatcher 顶掉导致events/setOnXxx/setUserVideoAllCallBack全部失效。需要用户级VideoAllCallBack时改用controller.setUserVideoAllCallBack(callback)它与内部 dispatcher 链式分发、互不覆盖。全屏controller.enterFullscreen(activity, hideActionBar, hideStatusBar)由 GSY 内核接管等价 Java 版startWindowFullscreen期间内核会克隆 host 接管渲染events照常 emitGSYPlayerEvent.EnterFull/QuitFullexitFullscreen(activity)返回false表示当前并不在全屏态。参考 ListWithFullscreenActivity.kt。五、结果验证仓库 app 模块的入口Compose DemoComposeDemoListActivity.kt汇总了 24 个可运行的 Compose Activity其中与本文任务直接相关的是项入口验证点8 · Full-Feature NativeFullFeatureNativeActivity.kt完整自绘控件速率 / Seek / 错误 Retry / 完成态LaunchedEffect里 collectevents处理Prepared/Error24 · 自定义主题 ControlsCustomControlsThemeComposeActivity.kt完全自绘控件替代默认控制条渐变浮层 Slider seek 多主题7 · Detail NativeDetailNativeActivity.ktNative 模式详情页形态按以下信号判断接入是否正确均为源码注释与文档明确给出的行为不是固定日志起播后stateFlow/snapshot中isPlaying变为truestate经过Preparing进入Playing缓冲时是Buffering流元信息就绪时events发出GSYPlayerEvent.Prepared此时可获取 duration/videoSize 等拖动滑块松手后 seek 生效events会发出SeekCompletesnapshot.currentPosition随播放推进snapshot 为 500ms 低频轮询同步进度条可能略有滞后属正常播放失败时events发出GSYPlayerEvent.Error(what, extra)携带原始MediaPlayer.OnError的 what/extra据此在自绘层显示重试入口demo 中重试调controller.retry()。注意events的边沿语义replay 0、extraBufferCapacity 16、溢出策略DROP_OLDEST见 GSYPlayerController.kt。订阅前发生的事件不会重放错过即错过所以「是否正在播放、播到哪了」这类连续状态要读stateFlow/snapshot不要试图从events里还原状态。六、约束与易错点旧版setOnError/setOnComplete/setOnPrepared已标记Deprecated保留可用新代码推荐eventsstateFlow。rememberGSYPlayerController的autoPauseResume默认为true宿主ON_PAUSE自动GSYVideoManager.onPause()、ON_RESUME自动恢复悬浮窗 / PiP 等需要后台持续播放的业务显式传false。离开 Composition 时 controller 自动dispose()之后所有 setter /setUp均为 no-opwithHost在 released 后直接返回null。snapshot与stateFlow同源同值仅 commit 时机略有差异Compose snapshot 在下一帧提交StateFlow 立即可见。内核切换与原版一致、不受 Compose 模块影响PlayerFactory.setPlayManager(Exo2PlayerManager::class.java)等按原 GSY 方式配置即可EXO 多源切换可参考 ExoSwitchSourceComposeActivity.kt。能力缺口与已知问题的完整清单见 doc/COMPOSE_BACKLOG.md「何时选 Native、何时选 Wrapper」的决策矩阵在 doc/COMPOSE_USE.md 第九节——简言之需要 Compose 原生 UI 流式驱动选 Native存量 Java/XML 业务想最快平移选 Wrapper。【免费下载链接】GSYVideoPlayerVideo players (IJKplayer, ExoPlayer, MediaPlayer), HTTPS, 16k page size, danmaku (bullet chat) support, external subtitles, support for filters, watermarks, and GIF screenshots, pre-roll and mid-roll ads, multiple simultaneous playback, basic seeking/dragging, volume and brightness adjustment, play-while-cache support项目地址: https://gitcode.com/GitHub_Trending/gs/GSYVideoPlayer创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考