// 方式 A：Maven Central / GitHub Packages
implementation "io.github.carguo:gsyvideoplayer-compose:13.1.0"

// 方式 B：本仓库内源码依赖
implementation project(":gsyVideoPlayer-compose")

@Composable
fun MyVideoScreen(url: String) {
    GSYVideoPlayerView(
        modifier = Modifier
            .fillMaxWidth()
            .aspectRatio(16f / 9f),
        setUp = { player ->
            GSYVideoOptionBuilder()
                .setUrl(url)
                .setCacheWithPlay(true)
                .setVideoTitle("Compose Demo")
                .setIsTouchWiget(true)
                .build(player)
            player.startPlayLogic()
        },
        // 默认会自动桥接 onPause/onResume 与离屏 release
        autoPauseResume = true,
        autoReleaseOnDispose = true,
    )
}

GSYAnyVideoPlayerView(
    modifier = Modifier.fillMaxWidth().aspectRatio(16f / 9f),
    factory = { ctx -> SampleControlVideo(ctx) },
    setUp = { player ->
        GSYVideoOptionBuilder().setUrl(url).build(player)
        player.startPlayLogic()
    },
)

GSYVideoPlayerView(
    setUp = { player -> GSYVideoOptionBuilder().setUrl(url).build(player); player.startPlayLogic() },
    setUpKey = url,   // url 变化时再次调用 setUp，否则 update 阶段是 no-op
)

@Composable
fun MyNativeScreen(url: String) {
    val controller = rememberGSYPlayerController(url = url, title = "Native Demo")

    GSYComposePlayer(
        controller = controller,
        modifier = Modifier
            .fillMaxWidth()
            .aspectRatio(16f / 9f),
        showDefaultControls = true,
    )
}

val controller = rememberGSYPlayerController(url = url)
val snap by controller.snapshot

Box(modifier = Modifier.fillMaxSize()) {
    GSYPlayerSurface(controller, Modifier.matchParentSize())   // 画面
    MyOwnControls(snap, controller, Modifier.matchParentSize())// 自绘控制层
}

controller.setUp(builder: GSYVideoOptionBuilder)
controller.setUp(url, cacheWithPlay = false, title = "")

controller.play()
controller.togglePlayPause()
controller.pause()
controller.resume()
controller.seekTo(positionMs: Long)
controller.setSpeed(1.5f, soundTouch = true)
controller.release()

// 全屏（R2 起新增，由 GSY 内核接管，等价于 Java 版 startWindowFullscreen / backFromFull）
controller.enterFullscreen(activity, hideActionBar = true, hideStatusBar = true)
controller.exitFullscreen(activity)              // 返回 Boolean，false 表示当前并不在全屏态
val inFs: Boolean = controller.isFullscreen      // 直读底层标志位

// 用户级 VideoAllCallBack（与内部 dispatcher 链式分发，不再覆盖 events）
controller.setUserVideoAllCallBack(object : GSYSampleCallBack() {
    override fun onClickStartIcon(url: String?, vararg objects: Any?) { /* 用户埋点 */ }
})

// 逃生口：直接拿底层 StandardGSYVideoPlayer 调用尚未封装的方法（必须主线程；release 后 no-op）
controller.withHost { player ->
    player.setSubTitle("https://example.com/sub.srt")        // 字幕
    player.setMirrorRotation(true)                            // 镜像
    player.taskShotPic { bmp -> /* 截图回调 */ }              // 快照
}

val snap: State<GSYPlayerSnapshot> = controller.snapshot
// snap.value -> GSYPlayerSnapshot(state, currentPosition, duration,
//                                 bufferPercent, isPlaying, videoWidth, videoHeight)

Idle  Preparing  Playing  Buffering  Paused  Completed  Error

import com.shuyu.gsyvideoplayer.compose.native_.GSYPlayerEvent

val controller = rememberGSYPlayerController(url = url, autoPlay = true)

// 1) 一次性"边沿事件"流：onPrepared / onAutoComplete / onPlayError / onEnterFullscreen / onQuitFullscreen
LaunchedEffect(controller) {
    controller.events.collect { event ->
        when (event) {
            is GSYPlayerEvent.Prepared      -> Log.d("Demo", "已准备就绪")
            is GSYPlayerEvent.AutoComplete  -> Log.d("Demo", "播放完成")
            is GSYPlayerEvent.Error         -> Log.e("Demo", "播错 what=${event.what} extra=${event.extra}")
            GSYPlayerEvent.EnterFull        -> fullscreen = true   // 由内核接管全屏后回调
            GSYPlayerEvent.QuitFull         -> fullscreen = false
        }
    }
}

// 2) 状态读取——StateFlow 形态，便于在 ViewModel / UseCase 里 collect
LaunchedEffect(controller) {
    controller.stateFlow
        .map { it.isPlaying }
        .distinctUntilChanged()
        .collect { isPlaying -> /* ... */ }
}

// 3) Compose 直接渲染——仍可用 controller.snapshot
val snap: GSYPlayerSnapshot by controller.snapshot

val controller = rememberGSYPlayerController(url = url, autoPlay = true)
val activity = LocalContext.current as Activity
var fullscreen by remember { mutableStateOf(false) }

LaunchedEffect(controller) {
    controller.events.collect { ev ->
        when (ev) {
            GSYPlayerEvent.EnterFull -> fullscreen = true
            GSYPlayerEvent.QuitFull  -> fullscreen = false
            else -> {}
        }
    }
}

BackHandler(enabled = fullscreen) { controller.exitFullscreen(activity) }

Button(onClick = { controller.enterFullscreen(activity) }) { Text("全屏") }

PlayerFactory.setPlayManager(Exo2PlayerManager::class.java)
CacheFactory.setCacheManager(ExoPlayerCacheManager::class.java)

io.github.carguo:gsyvideoplayer-compose:<PROJ_VERSION>

./gradlew :gsyVideoPlayer-compose:publishMavenCentralPublicationToSonatypeRepository \
          closeAndReleaseSonatypeStagingRepository \
          -PPUBLISH_TARGET=mavenCentral

com.shuyu:gsyvideoplayer-compose:<PROJ_VERSION>

./gradlew :gsyVideoPlayer-compose:publishReleasePublicationToGsyvideoplayerRepository \
          -PPUBLISH_TARGET=github

implementation 'com.github.CarGuo.GSYVideoPlayer:gsyVideoPlayer-compose:vX.Y.Z'

gsyVideoPlayer-compose/
└── src/main/java/com/shuyu/gsyvideoplayer/compose/
    ├── common/
    │   └── LifecycleBridge.kt                # 通用 Lifecycle ↔ Compose 桥
    ├── wrapper/
    │   ├── GSYVideoPlayerView.kt             # 模式一：包装 StandardGSYVideoPlayer
    │   └── GSYAnyVideoPlayerView.kt          # 模式一通用版：泛型 NormalGSYVideoPlayer
    └── native_/
        ├── GSYComposeHostPlayer.java         # 隐藏 UI 的 host player（仅留 surface_container）
        ├── GSYPlayerController.kt            # 控制器 + State 同步
        ├── GSYPlayerState.kt                 # State / Snapshot 数据类
        ├── GSYPlayerSurface.kt               # Surface + rememberGSYPlayerController
        └── GSYDefaultControls.kt             # 顶层 GSYComposePlayer + 默认控制条

GSYVideoPlayerView(
    modifier = Modifier.fillMaxWidth().aspectRatio(16f / 9f),
    setUp = { player ->
        GSYVideoOptionBuilder()
            .setUrl(url)
            .setVideoTitle(title)
            .setIsTouchWiget(true)
            .build(player)
    },
)

val controller = rememberGSYPlayerController()
LaunchedEffect(listState, playingIndex) {
    snapshotFlow { listState.firstVisibleItemIndex to (listState.layoutInfo.visibleItemsInfo.lastOrNull()?.index ?: -1) }
        .distinctUntilChanged()
        .collect { (first, last) ->
            if (playingIndex !in first..last) controller.pause()
        }
}

.setVideoAllCallBack(object : GSYSampleCallBack() {
    override fun onPrepared(url: String?, vararg objects: Any?) {
        super.onPrepared(url, *objects)
        // ... 上报埋点 / 更新 UI state
    }
})