KitePlayerSurface

The BASELINE Compose path: the platform player view, wrapped once.

On Android this hosts an io.github.yuroyami.kiteplayer.view.KitePlayerView through AndroidView; on iOS an io.github.yuroyami.kiteplayer.view.KitePlayerUIView through UIKitView. The picture is presented by the platform's own compositor, which is why this is the path for sustained fullscreen playback: the display controller shows the video while the GPU idles. The default renderer adapter is installed from kiteplayer-view-bindings; the widget itself remains backend-agnostic in kiteplayer-view.

The trade is the classic interop hole: the video is not Compose content, so Compose clip, alpha, rotation and shader effects do not apply to its pixels. When video must behave as a true Compose primitive, use KiteVideo from kiteplayer-compose-video and read its cost note.

The player is never owned here: opening media, playing, seeking and closing stay the caller's. Passing null detaches, and this Composable leaving composition only stops the picture, never the playback.

keepDisplayAwake keeps the display from dimming and locking while the player plays video and this surface is on screen, as the platform view's own property of that name does. True by default; the desktop view accepts it and does nothing.

accessibilityVideoLabel and accessibilityStateFormat are what a screen reader says about the video, as the platform view's properties of those names. Null keeps the view's English default. On the web, where this is an empty placeholder, both do nothing.