mpv_kit 0.1.4
mpv_kit: ^0.1.4 copied to clipboard
Complete, low-overhead Dart FFI bindings for libmpv (mpv 0.42, client API 2.6): the full client API, mpv_node conversion, an isolate-safe event loop and a typed high-level Player. Rendering lives in m [...]
0.1.4 #
- Documented the independent vendor provenance re-verification in
native/patches/UPSTREAM.md: the official mpv v0.42.0 release tarball (sha256bcfebbfa…5070dd) with the seven mpv_kit patches applied matchesnative/mpvexactly. No code changes.
0.1.3 #
- Fixed:
Player/Mpvcreation no longer hard-fails on libmpv builds whose option semantics differ from mpv 0.42. mpv 0.42 changedhwdec-extra-framesfrom an integer to a choice (auto); on older binaries that value is rejected withMPV_ERROR_OPTION_ERRORand the whole player creation aborted (51 tests failed in this configuration). A new compat table (Mpv._optionValueCompat) maps such values to their semantically equivalent predecessors (auto->6), recorded inMpv.compatOptionFallbacksfor diagnostics and consumed by the hwdec-extra-frames auto-tune. Unknown values still fail loudly, so typos in user options are not masked. - Fixed (Windows): loading libmpv by explicit path (
path:argument orMPV_KIT_LIBMPV_PATH) failed with Win32 error 126 whenever dependency DLLs lived next to the target (Dart'sDynamicLibrary.opendoes not useLOAD_WITH_ALTERED_SEARCH_PATH). The directory is now prepended to the processPATHbefore loading, so the bundle's dependency closure (avcodec-62.dll etc.) resolves. - Added: mpv 0.42's D3D11 render constants (
MPV_RENDER_PARAM_D3D11_INIT_PARAMS(21),MPV_RENDER_PARAM_D3D11_FBO(22) andMPV_RENDER_API_TYPE_D3D11) inbindings.dart, audited againstrender_d3d11.hwith REA. The current native-window composition path does not use them; they unblock a future direct render-API backend. - Tests: stream-bridge tests now skip (instead of fail) on stock libmpv builds without mpv_kit patch 0006; the hwdec auto-tune test accepts the compat-equivalent value on older binaries.
- Validated on Dart 3.14.0 / Flutter 3.50.0 with
ffi2.2.0,hooks2.2.0,code_assets2.2.0 andlints6.1.0; the SDK constraint stays^3.10.0(hooks2.x floor).
0.1.2 #
- Changed:
ffilower bound raised to^2.2.0(resolves with the currentpath,crypto,ffi,path_provider,file_picker,shared_preferences,desktop_drop,cross_file,intlandloggerreleases in one app; no runtime dependency added, public API unchanged).
0.1.1 #
- Changed: at 1080p and below,
Playernow caps mpv 0.42'shwdec-extra-framesto2instead of leaving it atauto. mpv 0.42 sizes the hwdec surface pool from the VO queue; with the 8-slot Windows frame ring that added about 50 MiB of working set at 1080p. Measured on Windows x64 (RTX 4060), full example app, local 1080p H.264, default hardware decode, 10 minutes: peak working set 294 -> 234 MiB. 4K/8K keepauto, and a value supplied throughoptions(or changed at runtime) is never overridden.
0.1.0-dev.10 #
- Upgraded the bundled client API to mpv 0.42.0 (client API 2.6).
mpvProperties/mpvCommands/mpvOptionswere regenerated: 160 properties, 101 commands and 748 options, includingenv,libplacebo-version,sub-lines,dropped-files,disc-menu-active,discnavandupdate-clipboard; the removedtime-startproperty is gone. - Breaking (generated API):
MpvOptions.hwdecExtraFramesis now aMpvOption<String>(autoor a number), because mpv 0.42 changed the option from an integer to a choice.Playernow passesauto, which sizes the extra decoder frames from the VO's frame retention instead of always keeping six. Playersetscurl-enabled=noexplicitly: mpv 0.42 enables the libcurl backend by default when built with FFmpeg 8.1.3, and the old network behavior is kept unless an app opts in.- Named commands use the
_namekey introduced by client API 2.6 (nameremains accepted). - mpv 0.42 defaults
tls-verify=yes; no code overrides it.track-listis filtered by the selected edition and hides dependent tracks, anddemuxer-hysteresis-bytesnow takes effect. - Optical-disc playback (CD, DVD-Video menus, DVD-Audio, Blu-ray/UHD HDMV)
is available with the GPL full bundle from
mpv_kit_libs.
0.1.0-dev.9 #
- Added:
defaultHwdecForBackend(os, apiToken)(exported): the native D3D11 render backend prunes thevulkanhwdec entry, whose probe can only fail on a D3D11 render API;MpvVideoController.createapplies it while the core is idle and only whenhwdecwas not overridden. - Added:
StreamBridge.readTimeout(30 s) bounds oneread/seekanswer; a source that never replies no longer blocks mpv's demuxer thread forever (the request is answered as failed and reported like other source errors). - Changed:
MpvVideonever requests a render size above the video's own pixel size (capRenderSize, default true), so a 1080p video in a 4K window no longer allocates a 4K shared-image ring.
0.1.0-dev.8 #
- Fixed: the event drain is bounded (256 events or 2 ms per turn, continued
from a zero-duration timer) so a log flood cannot hold the isolate and
starve timers/platform channels; it still empties the queue to
MPV_EVENT_NONE. - Fixed: a reply event that cannot be decoded now completes its awaiting
future with
MpvException(operation: 'decode_event')instead of leavingopen/seek/screenshotpending forever. - Changed:
Playerre-reads every bound property when mpv reportsMPV_EVENT_QUEUE_OVERFLOW, so state is current after dropped discrete events. TheeventQueueOverflowsdoc no longer mixes the event ring with the separate log buffer. - Changed:
openPlaylistsubmits allloadfile ... appendcommands before awaiting their replies, so the playlist property is not reparsed once per URL (O(N^2) in the drain). If one entry fails, the later ones are already queued; the first error is still thrown. Synchronousevents,MpvState.streamandobservePropertylisteners run inside the drain and must not block (documented).
0.1.0-dev.7 #
- Version bump only; no API or behaviour changes in this package.
0.1.0-dev.6 #
- Changed: software decoding at 8K and above now uses at most 8 threads
(
vd-lavc-threads), the same cap as 4K. mpv's automatic value is up to 16 frame threads, and each thread holds a full frame: measured on 8K HEVC Main10 50 fps (16-thread x64,hwdec=no), peak RSS 3433 -> 2213 MiB (-1.2 GiB) for about 8% less decode throughput (20.6 -> 18.9 s of video decoded per 20 s). 12 threads was not a better trade: 525 MiB more for 2% throughput. Values at 4K and below are unchanged, and avd-lavc-threadsyou set yourself is still never changed.
0.1.0-dev.5 #
- Added:
Player.demuxerCacheState(MpvDemuxerCacheState,MpvSeekableRange): bytes queued ahead and in total, buffered duration, source read rate and seekable ranges fromdemuxer-cache-state. Observed only from the first access; the parser never throws on malformed nodes. - Added:
Player.eventQueueOverflows, fired when mpv's event queue for the client overflowed (discrete events such as log messages were dropped; property values and command replies are not lost). - Changed: software decoding uses at most 4 threads up to 1080p and 8 up to
4K (
vd-lavc-threads, set per file before the decoder starts; 8K keeps mpv's automatic count). Measured on a 16-thread x64: 1080p peak RSS 153 -> 82 MiB, 4K60 484 -> 303 MiB, both still decoding at well over their frame rate. Avd-lavc-threadsyou set yourself is never changed. - Changed: the frame-size demuxer budget no longer goes below mpv's own 150 MiB default (640x360 got 21 MiB, which could starve readahead with high-bitrate audio). Local files only fill a few MiB of it.
- Added:
autoTuneDemuxerparameter onPlayer()andPlayer.wrap(defaulttrue, unchanged behaviour);falsekeeps the configureddemuxer-max-bytes/demuxer-max-back-bytesfor every file.
0.1.0-dev.4 #
- Changed:
MpvLibrary.open(and soMpv.create/PlayerwithlibraryPath) is strict about explicitly named libraries. An explicitpath, else a non-emptyMPV_KIT_LIBMPV_PATH, is tried alone; if it fails to load (missing file, unresolved dependency, incompatible client API) it throwsMpvLibraryNotFoundcarrying the loader's reason instead of silently falling back to the next candidate (which ran the wrong libmpv). The platform default names are only tried when neither is given. Signatures are unchanged. - Fixed: disposing an
Mpvwhile clients created from it were still alive hung forever;dispose()now disposes those clients first. - Fixed: custom stream protocols always answer a claimed request: a source
whose
sizegetter throws, or a URI that is not valid UTF-8, fails the load instead of freezing it, and an opener that does not complete within 30 s fails withloadingFailed(a source arriving later is closed). - Changed:
Playerno longer hardware-decodes FFV1 by default (hwdec-codecsexcludesffv1, mpv #18255); override it throughoptions. - Changed (behavior):
Playernow defaultshwdecto a per-platform, zero-copy-first list instead of one shared list: Windowsvulkan,d3d11va,d3d11va-copy,auto-safe, Linuxvulkan,vaapi,auto-safe, macOSvideotoolbox,auto-safe, otherauto-safe(wasvulkan,d3d11va-copy,auto-safeeverywhere). An explicithwdecinoptionsstill wins. See ADR 0006.
0.1.0-dev.3 #
- No API changes; released together with mpv_kit_libs 0.1.0-dev.3.
0.1.0-dev.2 #
- Fixed: reading
audioDevicesno longer crashes on machines without an audio output device (fixed in libmpv, see mpv_kit_libs). The device tests now run on every CI target.
0.1.0-dev.1 #
- Music and audio state for drop-in replacement of media_kit:
metadata(tags, ICY titles),audioParams,audioDevices/setAudioDevice,bufferedPosition,setLoopMode/loopMode(MpvLoopMode),setReplayGain,MpvTrack.isAlbumArt. Seedocs/MIGRATING_FROM_MEDIA_KIT.md. - Known issue: reading
audioDeviceson a machine without any audio output device (e.g. headless CI VMs) crashes inside mpv's CoreAudio / WASAPI device enumeration. Device listing is lazy, so playback never triggers it; machines with an audio device are unaffected. Mpv: bindings for the full libmpv 0.41 client API (client API 2.5): commands (sync, async, abortable), properties viampv_node, property observers as streams, typed events, hooks, log messages, sub-clients.- Isolate-safe event loop driven by mpv's wakeup callback through
NativeCallable.listener. - Secure defaults (
Mpv.secureDefaultOptions): config files, scripts, ytdl, OSC and default key bindings disabled unless requested. Player: typed high-level player withMpvState<T>state streams, playlist, track, subtitle, audio/video adjustment and screenshot commands,errorsandlogsstreams, andaddDisposeHookfor render contexts.MpvOptions: typedMpvOption<T>for every option of the bundled libmpv, withMpv.getOptionValue/Mpv.setOptionValue.mpvProperties,mpvCommands,mpvOptions: catalog generated from mpv's documentation.- Custom stream protocols served from Dart (
Mpv.registerStreamProtocol,MpvStreamSource,MpvMemoryStreamSource) on libmpv builds with the mpv_kit stream bridge (patch 0006). MpvLibrary: libmpv lookup via explicit path,MPV_KIT_LIBMPV_PATHor platform default names, with a client API version check.