Android operator parity with the iOS baseline

[erik-sutton95]

OpenPocketCine's iOS app is the operator baseline. Android already has the connection spine (BLE → camera Wi-Fi → DUML → live HEVC) and a real Compose shell, but it is not a 1:1 monitor yet.

This thread is the parent for Android operator-visible parity. Pick one workstream at a time. Do not open a single mega-PR.

Related: roadmap index · ANDROID.md · docs/ROADMAP.md (dual-platform parity is Later)

What already works on Android

• First-pair wizard and saved-camera home, matched to iOS copy
• BLE pair, SoftAP join, UDP datalink, live enable once (not 1 Hz spam)
• HEVC live view (MediaCodec SurfaceView) for Pocket 4 / 4 Pro
• Record, ISO, shutter 1/N, expo auto/manual, WB auto + kelvin + tint, AF-S/AF-C, color, 1080/4K + fps, audio channel / wind NR / directional / vocal
• Gimbal stick, tap-to-focus box, GRID / CROSS / GUIDES overlays
• Record button, lock, timecode, dual batteries, DISP 1/2 (hide chrome vs rec + timecode)

Protocol encode still comes from Swift (OpenPocketCineAndroidFacade). Kotlin owns BLE, Wi-Fi, UDP, decode, and Compose.

Workstreams

Treat each checkbox as its own shippable slice.

1. GPU looks

• Decoded-frame bus (MediaCodec → ImageReader / SurfaceTexture) so assists can see pixels
• Ship official Rec.709 cubes in Android assets (same redistributable files as iOS)
• LUT, peaking, false color, zebra, mirror — chips already exist as stubs in LiveViewScreen.kt

2. Scopes

• WAVE, HISTO, PARADE, VECTOR, LIGHTS, AUDIO meters
• Reuse LiveColorScience / AudioLevelMeter from the Swift core (JNI), do not copy OpenZCine Android
• Depends on workstream 1's frame tap

3. Remaining camera writes

• Zoom (pinch, chip, D-Log2 → D-Log hop) — telemetry exists (zoomFactorRaw), no write
• EV tile when Auto (Face Priority can follow later)
• FOV, ISO auto ceiling, shutter angle vs 1/N
• Extend AndroidSessionWire.CommandKind past 35 using existing Commands.swift builders

4. Osmo Nano on Android

• AVC/H.264 live view — JNI already detects AVC CSD; HevcDecoder.kt is hardcoded HEVC
• Drop “Waiting for HEVC…” copy for Nano

5. Face AF + ActiveTrack

• Face boxes and gimbal lock-on on the same frame tap as looks
• Face Priority EV (core already exists: FacePriorityExposure.swift)

6. Media library

• Call unused JNI enterPlayback, HTTP catalog, thumbs, player, LUT preview
• Frame.io is a follow-on, after a real internet-hop path. Do not bundle it here.
• Current Android media screen is honest empty-state copy only

7. Chrome, Operator Setup, recovery

• Portrait layout policy, DISP swipe, chrome Edit-view
• Haptics, record confirm, stick sensitivity, keep-awake already partial
• IBM Plex + Sora
• Adopt FeedWatchdog / SessionRecovery instead of failLink → FAILED
• Handshake poll like iOS (Android still Thread.sleep(350) × 20)

Out of scope here

• Google Play listing (separate product step)
• Copying OpenZCine USB-C / HDMI / Nikon paths (ANDROID.md)
• 1:1 pixel clone of every iOS animation

Done when

An operator can run a Pocket 4 / 4 Pro (and Nano AVC) session on Android with the same control writes, monitor assists, media review, and reconnect behavior they get on iOS — minus Play distribution and Frame.io.

Concrete threads: Nano · reliability audit

[erik-sutton95]

Maintainer tasks:

• Parent: Android operator parity with the iOS baseline #70
• Android: decoded-frame bus and GPU looks #72 decoded-frame bus + GPU looks
• Android: scopes (WAVE, HISTO, PARADE, VECTOR, LIGHTS, AUDIO) #73 scopes (blocked on Android: decoded-frame bus and GPU looks #72)
• Android: remaining camera writes (zoom, EV, FOV, ISO limit, shutter angle) #74 remaining camera writes
• Android: Osmo Nano AVC live view #75 Nano AVC
• Android: face AF, ActiveTrack, and Face Priority EV #76 face AF / Face Priority (blocked on Android: decoded-frame bus and GPU looks #72)
• Android: media library and playback #77 media library
• Android: monitor chrome, Operator Setup, and session recovery #78 chrome + recovery