media3-video-playback

Stars13

Forks3

UpdatedJuly 23, 2026 at 11:24

Compact skill for Media3 1.10.1 video surfaces, aspect ratio, first frame, HDR, PiP, and feed-safe handoff.

Installation

Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.

Source

sunnat629

sunnat629/android-media-pack

View GitHub Repository View Creator Repositories

Download

Related occupationsSOC

Based on SOC occupation classification

Software DevelopersComputer and Mathematical Occupations·SOC 15-1252

SKILL.md

readonly

name	media3-video-playback
description	Compact skill for Media3 1.10.1 video surfaces, aspect ratio, first frame, HDR, PiP, and feed-safe handoff.
license	Apache-2.0
metadata	{"author":"Shunnek Labs","version":"1.2","target_media3_version":"1.10.1","last_reviewed":"2026-07-23","keywords":["android","media3","video","surface","playersurface","contentframe","first-frame","hdr","pip"]}

Trigger

Use for video rendering bugs, blink/flicker, wrong crop, first-frame handoff, PiP, HDR, or fullscreen behavior.

Rules

Start with streaming-media-architecture for ownership, KMP split, preload window, and telemetry.
Pin Media3 to 1.10.1 through the version catalog.
Keep Media3 APIs in Android source sets; expose KMP-safe state/events upward.
Use onRenderedFirstFrame plus media identity to remove placeholders.
Do not change surface type while the player is attached.
SurfaceView is PREFERRED everywhere, including inline scrollers. Fall back to TextureView only when SurfaceView cannot satisfy the requirement, for example smooth scroll or transition animation on pre-API 24 devices. TextureView costs more power, has weaker frame timing, and cannot show HDR or secure (DRM) output.
Aspect comes from onVideoSizeChanged, not thumbnail size.

Example

val readyForVideo = state.mediaUri == uri && state.renderedMediaUri == uri
// thumbnail visible while !readyForVideo

media3-compose-ui-material3
media3-analytics-telemetry
streaming-media-architecture

More from this repository

same repository

media3-ads-ima

sunnat629/android-media-pack

Compact skill for Media3 Google IMA CSAI/SSAI ad insertion, AdViewProvider, companions, and ad telemetry.

2026-07-2313

media3-background-playback-service

sunnat629/android-media-pack

Compact skill for Media3 MediaSessionService, MediaController, notification, media buttons, and service lifetime.

2026-07-2313

media3-workmanager-offline-ops

sunnat629/android-media-pack

Compact skill for Media3 offline downloads with DownloadService, DownloadManager, Requirements, and the WorkManagerScheduler role of media3-exoplayer-workmanager.

2026-07-2313

media3-bandwidth-abr

sunnat629/android-media-pack

Compact skill for Media3 bandwidth estimation, ABR limits, load control, network constraints, and preload contention.

2026-07-2313

media3-cast-integration

sunnat629/android-media-pack

Compact skill for Media3 CastPlayer.Builder, automatic local/remote handoff, MediaRouteButton, and Cast session lifecycle.

2026-07-2313

media3-datasources-networking

sunnat629/android-media-pack

Compact skill for Media3 HTTP DataSource, OkHttp/Cronet/HttpEngine, cache, headers, auth, and custom DataSource decisions.

2026-07-2313

name	media3-video-playback
description	Compact skill for Media3 1.10.1 video surfaces, aspect ratio, first frame, HDR, PiP, and feed-safe handoff.
license	Apache-2.0
metadata	{"author":"Shunnek Labs","version":"1.2","target_media3_version":"1.10.1","last_reviewed":"2026-07-23","keywords":["android","media3","video","surface","playersurface","contentframe","first-frame","hdr","pip"]}

Trigger

Use for video rendering bugs, blink/flicker, wrong crop, first-frame handoff, PiP, HDR, or fullscreen behavior.

Rules

Start with streaming-media-architecture for ownership, KMP split, preload window, and telemetry.
Pin Media3 to 1.10.1 through the version catalog.
Keep Media3 APIs in Android source sets; expose KMP-safe state/events upward.
Use onRenderedFirstFrame plus media identity to remove placeholders.
Do not change surface type while the player is attached.
SurfaceView is PREFERRED everywhere, including inline scrollers. Fall back to TextureView only when SurfaceView cannot satisfy the requirement, for example smooth scroll or transition animation on pre-API 24 devices. TextureView costs more power, has weaker frame timing, and cannot show HDR or secure (DRM) output.
Aspect comes from onVideoSizeChanged, not thumbnail size.

Example

val readyForVideo = state.mediaUri == uri && state.renderedMediaUri == uri
// thumbnail visible while !readyForVideo

media3-compose-ui-material3
media3-analytics-telemetry
streaming-media-architecture