video_player: update README (#71)

Signed-off-by: Hidenori Matsubayashi <Hidenori.Matsubayashi@gmail.com>
This commit is contained in:
Hidenori Matsubayashi
2023-08-17 02:48:03 +00:00
committed by GitHub
parent c3df5143cc
commit 0c1388ec55

View File

@ -9,8 +9,7 @@ The implementation of the Video Player plugin for flutter elinux. APIs are desig
This plugin uses [GStreamer](https://gstreamer.freedesktop.org/) internally. This plugin uses [GStreamer](https://gstreamer.freedesktop.org/) internally.
```Shell ```Shell
$ sudo apt install libglib2.0-dev $ sudo apt install libglib2.0-dev libgstreamer1.0-dev
$ sudo apt install libgstreamer1.0-dev
# Install as needed. # Install as needed.
$ sudo apt install libgstreamer-plugins-base1.0-dev \ $ sudo apt install libgstreamer-plugins-base1.0-dev \
gstreamer1.0-plugins-base gstreamer1.0-plugins-good \ gstreamer1.0-plugins-base gstreamer1.0-plugins-good \
@ -31,23 +30,35 @@ dependencies:
``` ```
### Source code ### Source code
Import `video_player` in your Dart code: Import `video_player` in your Dart code:
```dart ```dart
import 'package:video_player/video_player.dart'; import 'package:video_player/video_player.dart';
``` ```
### Customize for your target devices
If you this plugin on your target devices, you will need to customize the pipeline in the source file.So, replace the `videoconvert` element with a H/W accelerated element of your target device to perform well.
#### default:
playbin uri=<file> video-sink="videoconvert ! video/x-raw,format=RGBA ! fakesink"
#### e.g. customization for i.MX 8M platforms:
playbin uri=<file> video-sink="imxvideoconvert_g2d ! video/x-raw,format=RGBA ! fakesink"
### Enable GstEGLImage ### Enable GstEGLImage
If GstEGLImage is enabled on your target device, adding the following code to `<user's project>/elinux/CMakeLists.txt` may improve playback performance. If GstEGLImage is enabled on your target device, adding the following code to `<user's project>/elinux/CMakeLists.txt` may improve playback performance.
``` ```
add_definitions(-DUSE_EGL_IMAGE_DMABUF) add_definitions(-DUSE_EGL_IMAGE_DMABUF)
set(USE_EGL_IMAGE_DMABUF "on") set(USE_EGL_IMAGE_DMABUF "on")
``` ```
### Customize for your target devices
To improve the performance of this plugin, you will need to customize the pipeline in the source file. Please modify the source file and replace the `videoconvert` element with a H/W accelerated element of your target device to perform well.
`bool GstVideoPlayer::CreatePipeline()` in packages/video_player/elinux/gst_video_player.cc
#### default:
```
playbin uri=<file> video-sink="videoconvert ! video/x-raw,format=RGBA ! fakesink"
```
#### i.MX 8M platforms:
```
playbin uri=<file> video-sink="imxvideoconvert_g2d ! video/x-raw,format=RGBA ! fakesink"
```