このページでは

qt_add_ios_ffmpeg_libraries

iOSアプリバンドルにFFmpegバイナリを組み込む補助関数。

このコマンドは、Qt6 パッケージのMultimedia コンポーネントに定義されており、次のように読み込むことができます:

find_package(Qt6 REQUIRED COMPONENTS Multimedia)

このコマンドは Qt 6.8 で導入されました。

注: この コマンドはテクノロジープレビュー段階にあり、将来のリリースで変更される可能性があります。

概要

qt_add_ios_ffmpeg_libraries(target)

バージョン指定なしのコマンドが無効になっている場合は、代わりに `qt6_add_ios_ffmpeg_libraries() ` を使用してください。このコマンドと同じ引数セットをサポートしています。

説明

オンラインインストーラから入手した FFmpeg バイナリは、アプリケーションのバンドルに埋め込む必要があります。FFmpeg バイナリを埋め込むには、プロジェクトの CMakeLists.txt ファイル内の実行可能ターゲットにqt_add_ios_ffmpeg_libraries コマンドを追加します。

この関数は、実行可能ターゲットに対して呼び出す必要があります。ライブラリターゲットやインターフェースターゲットでは使用できません。プロジェクトがQt Multimedia にリンクするライブラリである場合、そのライブラリがリンクされる実行可能ファイルがこの関数を呼び出す必要があります。

このコマンドは、アプリケーションターゲットに対していくつかのプロパティを設定します:

  • XCODE_EMBED_FRAMEWORKS:XCode 向けの情報(埋め込む FFmpeg バイナリ)を追加します。
  • XCODE_EMBED_FRAMEWORKS_CODE_SIGN_ON_COPY は ON に設定され、これにより組み込まれた FFmpeg バイナリにコード署名が行われます。
  • XCODE_ATTRIBUTE_LD_RUNPATH_SEARCH_PATHS - バンドル内の埋め込み FFmpeg ライブラリの場所を追加します。

コード署名が必要ない場合は、コマンド `qt_add_ios_ffmpeg_libraries` の前に `QT_NO_FFMPEG_XCODE_EMBED_FRAMEWORKS_CODE_SIGN_ON_COPY` 変数を指定できます:

set(QT_NO_FFMPEG_XCODE_EMBED_FRAMEWORKS_CODE_SIGN_ON_COPY ON)

注: qt_add_ios_ffmpeg_libraries を実行するには、CMake 3.28 以降が必要です。

注: この Qt for iOS パッケージ用に FFmpeg バックエンドがビルドされていない場合、この コマンドは 何も実行しません。

© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.