version 0.22.1

Author: wang-bin

Changelog.md

@@ -1,5 +1,33 @@
 Change log:
 
+## 0.22.1 - 2023-09-30
+
+- `VideoFrame.timestamp()` is alway readable. `TimestampEOS` indicates no more frames
+- Add global option `demuxer.max_errors` to continue on error if error count is less than this value
+- MFT:
+    - Ignore h264 level by default
+    - Fix adapter index if `vendor` property is set, e.g. `MFT:d3d=9:vendor=nv`
+- Add `mem` scheme to play from memory, url format is `mem://addr+size`
+- VDPAU:
+    - Add `interop` property, can be `video`, `output` and `pixmap`. Detail: https://github.com/wang-bin/mdk-sdk/wiki/Decoders#vdpau
+    - Use x11 display provided by user except `pixmap` interop
+- VAAPI: [document is updated](https://github.com/wang-bin/mdk-sdk/wiki/Decoders#vaapi)
+    - Support GLX/EGL texture from dri3 pixmap from drm prime, via option `interop=dri3`, or fallback from `interop=x11` failure. For some drivers(intel iHD driver) it's the only 0-copy solution in GLX context because libva-x11 is broken(vaPutSurface error). `VAEntrypointVideoProc` is requred. Recommend to install `intel-media-va-driver-non-free`, because i965 and free iHD driver may lack of `VAEntrypointVideoProc`.
+    - Support `GL_TEXTURE_EXTERNAL_OES` for `dri3` and `x11` interop, via option `external=1`
+- DXGI:
+    - Fix crash in vm, or no gpu driver
+    - Always try rgba8 if fail to create a rgb10a2 swapchain, fix d3d11 feature level 9.3 create render context error
+- Try the next decoder if a decoder does not produce any frame. MFT jpeg decoder may produce nothing but no error.
+- Fix decode error if previous decoder in decoder list failed
+- Fix open a decoder multiple times before trying the next decoder
+- Fix pause at eof then stop dead lock if `keep_open` is set(music with cover art).
+- Fix incorrect seek request count
+- CUDA: fix crash for some unsupported streams, e.g. av1 12bit
+- FFmpeg: fix crash if a codec is not enabled
+- Add `mdk.pri` for qt qmake projects. All you need is including this file
+- Enable full lto to reduce binary size. Thin lto was used in previous versions.
+
+
 ## 0.22.0 - 2023-08-31
 
 - Add `Player.onMediaStatus(MediaStatus oldValue, MediaStatus newValue)` to simplify user code. `Player.onMediaStatusChanged` is deprecated.

README.Android.md

@@ -18,8 +18,9 @@
 
 ## About SDK for Android
 SDK is built with
-- ffmpeg: https://sourceforge.net/projects/avbuild/files/android/ffmpeg-master-android-clang-lite.tar.xz/download
-- ndk r25, libc++_shared
+- ffmpeg: https://sourceforge.net/projects/avbuild/files/android/ffmpeg-master-android-clang-lite-lto.tar.xz/download
+- ndk r25b for 32bit, ndk 26 for b4bit
+- requires ndk r23 and later because of ndk abi break in r23
 
 SDK can be used by any C or C++11 compiler, e.g. g++, clang
 
@@ -34,7 +35,7 @@ SDK can be used by any C or C++11 compiler, e.g. g++, clang
 ### [Supported Decoders:](https://github.com/wang-bin/mdk-sdk/wiki/Decoders)
 - FFmpeg
 - MediaCodec: FFmpeg mediacodec implementation
-- AMediaCodec: builtin mediacodec implementation, using libmediandk or java api. propertyes: "surface" = "0" or "1", "copy" = "0" or "1" when "surface" is "0", "java" = "0" or "1"(use java or mediandk), "async" = "0" or "1"(android 9.0 is required by async mode)
+- AMediaCodec: builtin mediacodec implementation, using libmediandk or java api
 
 MediaCodec/AMediaCodec decoder will not be destroyed if app go to background, and continues to work when resumed.
 
@@ -43,15 +44,22 @@ MediaCodec/AMediaCodec decoder will not be destroyed if app go to background, an
 - AudioTrack (default)
 
 ### Data Source
-- "content:"
-- "android.resource:"
+- `content:`
+- `android.resource:`
+- `assets:`
 
 ### Use in CMake Projects
 ```
 	include(mdk-sdk-dir/lib/cmake/FindMDK.cmake)
 	target_link_libraries(your_target PRIVATE mdk)
 ```
 
+### Recommended settings
+```cpp
+    SetGlobalOption("JavaVM", JvmPtr); // REQUIRED
+    player.setDecoders(MediaType::Video, {"AMediaCodec", "FFmpeg", "dav1d"});
+````
+
 ## Source code:
 - [some examples using mdk sdk](https://github.com/wang-bin/mdk-examples)
 - [OBS Studio plugin](https://github.com/wang-bin/obs-mdk)

README.Linux.md

@@ -19,8 +19,8 @@
 
 ## About SDK for Linux
 SDK is built by clang 17 with
-- ffmpeg: https://sourceforge.net/projects/avbuild/files/linux/ffmpeg-master-linux-clang-lite.tar.xz/download
-- libc++ 17
+- ffmpeg: https://sourceforge.net/projects/avbuild/files/linux/ffmpeg-master-linux-clang-lite-lto.tar.xz/download
+- libc++ 17. You can use delete libc++.so from sdk and use system libc++
 
 SDK can be used by any C or C++11 compiler, e.g. g++, clang
 
@@ -88,6 +88,18 @@ N videos renderers for 1 player: multiwidnows url
 	target_link_libraries(your_target PRIVATE mdk)
 ```
 
+### Recommended settings
+- Linux:
+```cpp
+    // XInitThreads(); // If using x11. before any x11 api call. some gui toolkits already call this, e.g. qt, glfw
+    SetGlobalOption("X11Display", DisplayPtr); // If using x11. Requred by VAAPI, VDPAU
+    player.setDecoders(MediaType::Video, {"VAAPI", "VDPAU", "CUDA", "hap", "FFmpeg", "dav1d"});
+```
+- Raspberry Pi: use [mdk-sdk-linux.tar.xz](https://sourceforge.net/projects/mdk-sdk/files/nightly/mdk-sdk-linux.tar.xz/download), delete libffmpeg.so.* to use system ffmpeg to support h264, hevc hardware decoder and 0-copy rendering
+```cpp
+    player.setDecoders(MediaType::Video, {"V4L2M2M", "FFmpeg:hwcontext=drm", "FFmpeg"});
+```
+
 ## Source code:
 - [some examples using mdk sdk](https://github.com/wang-bin/mdk-examples)
 - [OBS Studio plugin](https://github.com/wang-bin/obs-mdk)

README.WinRT.md

@@ -18,8 +18,7 @@
 
 ## About SDK for Windows Store
 SDK is built by
-- clang-cl 17, with Windows SDK 10.0.19041.0, MSVC CRT 14.28.29333, [FFmpeg](https://sourceforge.net/projects/avbuild/files/uwp/ffmpeg-master-uwp-vs2022-lite.tar.xz/download)
-- latest VS2022 with [FFmpeg](https://sourceforge.net/projects/avbuild/files/uwp/ffmpeg-master-uwp-vs2022-lite.tar.xz/download)
+- latest VS2022 with [FFmpeg](https://sourceforge.net/projects/avbuild/files/uwp/ffmpeg-master-uwp-vs2022-lite.7z/download)
 
 ### Use in Visual Studio
 #### Install via NuGet (Recommended)
@@ -39,6 +38,11 @@ Once installed or imported, necessary compile flags and link flags will be added
 	target_link_libraries(your_target PRIVATE mdk)
 ```
 
+### Recommended settings
+```cpp
+    player.setDecoders(MediaType::Video, {"MFT:d3d=11", "D3D11", "CUDA", "hap", "FFmpeg", "dav1d"});
+```
+
 
 ### [Runtime Requirements](https://github.com/wang-bin/mdk-sdk/wiki/System-Requirements#uwp)
 Optional:

README.Windows.md

@@ -21,8 +21,7 @@
 
 ## About SDK for Windows Desktop
 SDK is built by
-- clang-cl 17, with Windows SDK 10.0.19041.0, MSVC CRT 14.28.29333, [FFmpeg](https://sourceforge.net/projects/avbuild/files/windows-store/ffmpeg-master-windows-desktop-vs2022-lite.tar.xz/download)
-- latest VS2022 with [FFmpeg](https://sourceforge.net/projects/avbuild/files/windows-store/ffmpeg-master-windows-desktop-vs2022-lite.tar.xz/download)
+- latest VS2022 with [FFmpeg](https://sourceforge.net/projects/avbuild/files/windows-desktop/ffmpeg-master-windows-desktop-vs2022-lite.7z/download)
 
 SDK can be used by any C or C++11 compiler, e.g. vs2015, vs2022, mingw g++, clang
 
@@ -45,6 +44,11 @@ Once installed or imported, necessary compile flags and link flags will be added
 	target_link_libraries(your_target PRIVATE mdk)
 ```
 
+### Recommended settings
+```cpp
+    player.setDecoders(MediaType::Video, {"MFT:d3d=11", "D3D11", "CUDA", "hap", "FFmpeg", "dav1d"});
+```
+
 
 ### [Runtime Requirements](https://github.com/wang-bin/mdk-sdk/wiki/System-Requirements#windows-desktop)
 - Vista+

README.iOS.md

@@ -21,7 +21,7 @@ https://github.com/wang-bin/swiftMDK
 
 ## About SDK for iOS
 SDK is built by Xcode 14 with
-- ffmpeg: https://sourceforge.net/projects/avbuild/files/iOS/ffmpeg-master-iOS-lite.tar.xz/download
+- ffmpeg: https://sourceforge.net/projects/avbuild/files/iOS/ffmpeg-master-iOS-lite-lto.tar.xz/download
 - Minimal system: iOS 8.0
 - Support Metal renderer
 
@@ -45,6 +45,11 @@ Choose any of
 - Add mdk.xcframework to your project(Embed & Sign)
 - install via cocoapods `pod 'mdk'`
 
+
+### Recommended settings
+
+- macOS, iOS: `player.setDecoders(MediaType::Video, {"VT", "hap", "FFmpeg", "dav1d"});`
+
 #### Code Sign
 Choose any of
 - In `Build Settings` add `--deep` to `Other Code Signing Flags`

README.macOS.md

@@ -27,7 +27,7 @@ https://github.com/wang-bin/swiftMDK
 - Support X11 if runtime libraries exist
 
 SDK is built by Xcode 14 with
-- ffmpeg: https://sourceforge.net/projects/avbuild/files/macOS/ffmpeg-master-macOS-lite.tar.xz/download
+- ffmpeg: https://sourceforge.net/projects/avbuild/files/macOS/ffmpeg-master-macOS-lite-lto.tar.xz/download
 
 ### macOS 10.15+
 Executables download from internet are not able to run. Try
@@ -70,6 +70,10 @@ N videos renderers for 1 player: multiwidnows url
 	target_link_libraries(your_target PRIVATE mdk)
 ```
 
+### Recommended settings
+
+- macOS, iOS: `player.setDecoders(MediaType::Video, {"VT", "hap", "FFmpeg", "dav1d"});`
+
 ### Use in Xcode
 Choose any of
 - Add mdk.xcframework to your project(Embed & Sign)

nuget/README.md

@@ -23,7 +23,7 @@
 
 ## About SDK for Windows Desktop & UWP
 SDK is built by
-- latest VS2022 with [FFmpeg](https://sourceforge.net/projects/avbuild/files/windows-store/ffmpeg-master-windows-desktop-vs2022-lite.tar.xz/download)
+- latest VS2022 with [FFmpeg](https://sourceforge.net/projects/avbuild/files/windows-desktop/ffmpeg-master-windows-desktop-vs2022-lite.7z/download)
 
 SDK can be used by any C or C++11 compiler, e.g. vs2015, vs2022, mingw g++, clang
 
@@ -33,6 +33,24 @@ SDK can be used by any C or C++11 compiler, e.g. vs2015, vs2022, mingw g++, clan
 	target_link_libraries(your_target PRIVATE mdk)
 ```
 
+### Qt qmake project
+```qmake
+include($$MDK_SDK_DIR/mdk.pri)
+```
+
+
+### Recommended settings
+```cpp
+    player.setDecoders(MediaType::Video, {"MFT:d3d=11", "D3D11", "CUDA", "hap", "FFmpeg", "dav1d"});
+```
+
+#### Live streams (RTSP, RTMP etc.) low latency
+```cpp
+    player.setProperty("avformat.fflags", "+nobuffer");
+    player.setProperty("avformat.analyzeduration", "10000");
+    player.setProperty("avformat.probesize", "1000");
+    player.setProperty("avformat.fpsprobesize", "0");
+```
 
 ### [Runtime Requirements](https://github.com/wang-bin/mdk-sdk/wiki/System-Requirements#windows-desktop)
 - Vista+
@@ -73,4 +91,4 @@ Optional:
 
 
 Copyright (c) 2016-2023 WangBin(the author of QtAV) <wbsecg1 at gmail.com>
-Free for opensource softwares, non-commercial softwares, QtAV donors and contributors.
+Free for opensource softwares, non-commercial softwares, flutter, QtAV donors and contributors.

nuget/mdk.nuspec

@@ -2,7 +2,7 @@
 <package xmlns="http://schemas.microsoft.com/packaging/2011/08/nuspec.xsd">
   <metadata>
     <id>mdk</id>
-    <version>0.22.0.0</version>
+    <version>0.22.1.0</version>
     <title>MDK</title>
     <authors>Wang Bin</authors>
     <owners>Wang Bin</owners>