GStreamerのソースを表示

[[Category:マルチメディア]]
[[en:GStreamer]]
[[es:GStreamer]]
[[zh-hans:GStreamer]]
GStreamer は GObject の型システムを使って C プログラミング言語で書かれたパイプラインベースのマルチメディアフレームワークです。

プログラマーは GStreamer を使うことで、単純な音声再生や動画再生から録画・録音、ストリーミング、編集まで、様々なメディア処理コンポーネントを作成することができます。パイプライン設計により、動画エディタやストリーミングメディアの配信プログラム、メディアプレイヤーまで幅広いマルチメディアアプリケーションの基礎となります。

クロスプラットフォームになるように設計されているので Linux (x86, PowerPC, ARM), Solaris (Intel, SPARC), macOS, Microsoft Windows, OS/400 上で動作します。GStreamer には [[Python]], C++, Perl, GNU Guile ({{Pkg|guile}}), [[Ruby]] などのプログラミング言語用のバインディングが用意されています。GStreamer はフリーソフトウェアであり、GNU Lesser General Public License でライセンスされています。

== インストール ==

{{Pkg|gstreamer}} パッケージを[[インストール]]してください。

GStreamer を役立てるには、プラグインパッケージのインストールが必要になります:

* {{Pkg|gst-libav}} - 多数のデコーダとエンコーダが含まれている libav ベースのプラグイン。
* {{Pkg|gst-plugins-bad}} - 品質テストやドキュメントが必要とされるプラグイン。
* {{Pkg|gst-plugins-base}} - 重要で典型的な基本セット。
* {{Pkg|gst-plugins-good}} - LGPL ライセンスで配布されている高品質のプラグイン。
* {{Pkg|gst-plugins-ugly}} - 配布に問題がある高品質のプラグイン。
* {{AUR|gst-plugin-libde265}} - gstreamer 用の {{Pkg|libde265}} プラグイン (オープンな h.265 動画コーデックの実装)。

== Usage ==

=== gst-launch-1.0 の使用方法 ===

GStreamer の便利なツールに {{man|1|gst-launch-1.0}} コマンドがあります。これは GStreamer のパイプラインを作成するための非常に多機能なコマンドラインツールです。これは [[FFmpeg]] コマンドと非常によく似ており、多くのことができます。以下はその例です。

MP4 ファイルを MKV に変換する。

 $ gst-launch-1.0 filesrc location=source.mp4 ! qtdemux name=demux matroskamux name=mux ! filesink location=dest.mkv  demux.audio_0 ! queue ! aacparse ! queue ! mux.audio_0  demux.video_0 ! queue ! h264parse ! queue ! mux.video_0

=== Using gst-discoverer-1.0 ===

Another helpful tool is {{man|1|gst-discoverer-1.0}}, which is the GStreamer equivalent of FFmpeg's {{man|1|ffprobe}}.

Get info on a video file:

{{hc|$ gst-discoverer-1.0 file.mp4|2=
Properties:
  Duration: 0:02:55.613000000
  Seekable: yes
  Live: no
  container: Quicktime
    audio: MPEG-4 AAC
      Stream ID: c910ef2fa357f9f4ad365aebc98cfca88d23fdca99d832645f5113efa43b0cd3/002
      Language: <unknown>
      Channels: 2 (front-left, front-right)
      Sample rate: 44100
      Depth: 16
      Bitrate: 125588
      Max bitrate: 125588
    video: H.264 (Constrained Baseline Profile)
      Stream ID: c910ef2fa357f9f4ad365aebc98cfca88d23fdca99d832645f5113efa43b0cd3/001
      Width: 192
      Height: 144
      Depth: 24
      Frame rate: 15000/1001
      Pixel aspect ratio: 1/1
      Interlaced: false
      Bitrate: 107884
      Max bitrate: 107884
}}

== 統合 ==

=== PulseAudio ===

[[PulseAudio]] のサポートは {{Pkg|gst-plugins-good}} パッケージによって提供されます。

=== PipeWire ===

[[PipeWire]] のサポートは {{Pkg|gst-plugin-pipewire}} パッケージで提供されます。

=== KDE / Phonon の統合 ===

[[KDE#Phonon]] を見て下さい。

=== ハードウェアアクセラレーション ===

[[ハードウェアビデオアクセラレーション]]を見てください。
GStreamer は自動的に正しい API を検出し、使用します [https://gstreamer.freedesktop.org/documentation/tutorials/playback/hardware-accelerated-video-decoding.html] システム [[インストール]] に依存します。
* [[VA-API]] をサポートするために必要な {{pkg|gstreamer-vaapi}}
* NVDECODE/NVENCODE をサポートするために必要な {{pkg|gst-plugins-bad}} と {{pkg|nvidia-utils}}

==== ドライバのホワイトリストは無視する ====

GStreamer [https://gitlab.freedesktop.org/gstreamer/gstreamer-vaapi/-/blob/master/gst/vaapi/gstvaapipluginutil.c#L952 は、VA-API ドライバのホワイトリスト]を使用しています。ホワイトリストを無視して他のドライバのサポートを許可するには、[[環境変数]] に {{ic|1=GST_VAAPI_ALL_DRIVERS=1}} を設定してください。

==== VA-API のサポート状況を確認する ====

VA-API サポートを確認するには

{{hc|$ gst-inspect-1.0 vaapi|2=
Plugin Details:
  Name                     vaapi
  Description              VA-API based elements
  Filename                 /usr/lib/gstreamer-1.0/libgstvaapi.so
  Version                  ''version''
  License                  LGPL
  Source module            gstreamer-vaapi
  Source release date      ''date''
  Binary package           gstreamer-vaapi
  Origin URL               <nowiki>https://archlinux.org/</nowiki>

  vaapijpegdec: VA-API JPEG decoder
  vaapimpeg2dec: VA-API MPEG2 decoder
  vaapih264dec: VA-API H264 decoder
  vaapivc1dec: VA-API VC1 decoder
  vaapih265dec: VA-API H265 decoder
  vaapipostproc: VA-API video postprocessing
  vaapidecodebin: VA-API Decode Bin
  vaapisink: VA-API sink
  vaapih265enc: VA-API H265 encoder
  vaapih264enc: VA-API H264 encoder

  10 features:
  +-- 10 elements
}}

==== NVDECODE/NVENCODE 対応の確認 =====

NVDECODE/NVENCODE の対応状況を確認するには

{{hc|$ gst-inspect-1.0 nvcodec|2=
Plugin Details:
  Name                     nvcodec
  Description              GStreamer NVCODEC plugin
  Filename                 /usr/lib/gstreamer-1.0/libgstnvcodec.so
  Version                  ''version''
  License                  LGPL
  Source module            gst-plugins-bad
  Source release date      ''date''
  Binary package           GStreamer Bad Plugins (Arch Linux)
  Origin URL               <nowiki>https://archlinux.org/</nowiki>

  nvh265enc: NVENC HEVC Video Encoder
  nvh264enc: NVENC H.264 Video Encoder
  nvvp9dec: NVDEC vp9 Video Decoder
  nvvp8dec: NVDEC vp8 Video Decoder
  nvh265dec: NVDEC h265 Video Decoder
  nvh265sldec: NVDEC H.265 Stateless Decoder
  nvjpegdec: NVDEC jpeg Video Decoder
  nvh264dec: NVDEC h264 Video Decoder
  nvh264sldec: NVDEC H.264 Stateless Decoder
  nvmpeg4videodec: NVDEC mpeg4video Video Decoder
  nvmpeg2videodec: NVDEC mpeg2video Video Decoder
  nvmpegvideodec: NVDEC mpegvideo Video Decoder

  12 features:
  +-- 12 elements
}}

==== デコーダーランクを設定する ====

{{Accuracy|Is {{ic|avdec_av1}} プラグインはの中に存在しない？ [https://gstreamer.freedesktop.org/documentation/plugins_doc.html plugin list].}}

一部の [[NVIDIA]] ユーザーは {{Pkg|gst-libav}} が [https://gstreamer.freedesktop.org/documentation/nvcodec/index.html nvcodec] デコーダよりも  Libav デコーダを優先してしまい、ハードウェアアクセラレーションを阻害してしまうことがあります。その為 {{ic|GST_PLUGIN_FEATURE_RANK}} があります。[[環境変数]] を使ってデコーダーのランク付けを行い、この問題を緩和することができます。詳しくは [https://gstreamer.freedesktop.org/documentation/gstreamer/running.html#environment-variables ドキュメント] の "GST_PLUGIN_FEATURE_RANK" をご覧ください。例えば

 GST_PLUGIN_FEATURE_RANK=nvmpegvideodec:MAX,nvmpeg2videodec:MAX,nvmpeg4videodec:MAX,nvh264sldec:MAX,nvh264dec:MAX,nvjpegdec:MAX,nvh265sldec:MAX,nvh265dec:MAX,nvvp9dec:MAX など。

AV1 ハードウェアをサポートしていない場合や、無効にしたい場合、上記のリストに {{ic|avdec_av1:NONE}} と {{ic|av1dec:NONE}} を追加して下さい。（例えば {{Pkg|webkit2gtk}} 系ブラウザなど）

== 参照 ==

* [[サウンドシステム]]
* http://gstreamer.freedesktop.org/