Extension:EmbedVideo/ja

EmbedVideo拡張機能では、24以上の人気動画共有サービスの動画クリップを多言語・多国で埋め込むためのパーサー機能 を追加しています. また、ビデオとオーディオのメディアハンドラを追加し、標準の ファイルリンクを埋め込み型のHTML5 およびタグに変換することをサポートします.


 * プロジェクトのホームページ
 * GitLab の説明文書


 * ソース コード
 * GitLab のソースコード


 * バグ
 * GitLabの課題


 * ライセンス条件
 * EmbedVideoは、The MIT Licenseの下でリリースされています.


 * GDPRに準拠したEmbedVideoのフォーク
 * GitHub のソースコード - EmbedVideo のプライバシーをより重視したバージョンに焦点を合わせています. なお、YouTube、Spotify、Vimeo、Archive.orgのみ対応で、 以外の全てのパーサー機能は削除されています.

使用法


メディアハンドラ
ローカルにアップロードされたコンテンツの場合、ページへの表示方法は画像と同じです. この機能に関する完全なリファレンスは、画像構文のドキュメントを参照してください.

この例では、HTML5のタグを使って、ページ内に動画を表示します.



メディア内の開始と終了のタイムスタンプを指定するには、startとendパラメータを使用します. タイムスタンプの形式は、ss, :ss, mm:ss, hh:mm:ss, or dd:hh:mm:ssのいずれかとすることが可能です.



タグ
EmbedVideo パーサー関数は、以下のいずれかの方法で呼び出されることを想定しています.



— 古典的なパーサタグ


ただし、必要であれば、パイプの間に何も入れず、オプションの引数を空白にすることもできる.





— テンプレート用パーサータグ
パーサーのタグは、key=valueのペアを使用できるため、テンプレート化しやすく、可読性も高くなります.



— URL用パーサータグ
パーサータグは タグと似ていますが、その最初のパラメータは、サービスを自動的に決定するために解析されるURLです.



— タグフック
のタグフックを使えば、簡単に動画を埋め込むことができます. ID/URLはタグの間に入力され、パラメータはタグの引数として追加することができます.

また、サービスIDをタグとして使用することもできます（他の拡張機能がまだこのタグを使用していないことが前提です）.



例


例えば、YouTubeの動画は、 のサービスセレクタを使用します. IDだけのいづれかを指定することができます. または完全なURLを指定する.

同じ動画を右寄せの大きなサムネイルで、説明文付きで表示する場合.

YouTubeで動画を特定の時間に開始させる場合は、 (URL引数)パラメータを利用します. カスタムURLから残りのURL引数を取り出して、 に入れます. すべての動画サービスが追加のURL引数をサポートしているわけではなく、またURL引数のキーが異なる場合がありますので、ご注意ください. https://www.youtube.com/watch?v=eAORm-8b1Eg&start=76

URL引数で動画を切り刻み、ループさせることができる. https://www.youtube.com/watch?v=eAORm-8b1Eg&start=160&end=180&loop=1



ビデオリンクタグのサポート
バージョン2.5から、未整備のVideoLink拡張のタグに対応しました.

オリジナルの拡張機能のドキュメントより.

VideoLink拡張機能は、記事中にYouTube動画を埋め込むことができ、ユーザーが動画リンクをクリックしたときに最初に表示される埋め込み動画プレーヤーで、リンク先の複数の動画を再生することが可能です.

&lt;evlplayer /&gt;はページ内のプレーヤーを表示する場所を指定し、2のパーサー関数で特定のビデオを読み込むリンクを作成できます.



— ビデオコンテナ用タグフック
このタグは、ビデオプレーヤーコンテナをページ内に配置するために使用されます.

また、デフォルトコンテンツの代わりに、デフォルトでコンテナを埋める動画を設定することも可能です.

注意すべき重要な点は、 と の属性は、コンテナに含まれるビデオにのみ影響し、実際のコンテナには影響しないことです. コンテナのスタイリングには、 または の属性を使用してください.



— 動画リンク用パーサー機能
タグでサポートされているすべての属性に加え、これらの特定の属性が （および ）タグに適用されます. 後方互換性を維持するため、 を定義しない場合は と見なされます.



動画リンク例
ビデオリストの作成は、ビデオリンクがyoutube、youtubevideolistのサービスを利用して、その場でプレイリストを作成することができます.



サポートされるサービス
バージョン2.x以降、EmbedVideoは以下のサービスからのビデオコンテンツの埋め込みに対応しています.

設定


バージョン履歴

 * v2.9.0
 * Fix stored XSS in AudioTransformOutput and VideoTransformOutput.
 * Fix autoResize on mobile.
 * Fix video caption escaping the container.
 * Handle multiple video sizes per page in resize.
 * Move beam service to mixer.
 * Add a default link title for #evl/#vlink.
 * Add spotify playlist embeds.
 * Add facebook video embeds.
 * Fix centering of videos.
 * Add Microsoft Stream service.
 * Add title to iframes.
 * Add API help messages for 1.33 compatibility.
 * Fix static analysis issues.
 * Fix Twitch embeds.


 * v2.8.0
 * Renamed hitbox.tv to smashcast.tv.
 * Updated Nico Video embed code.
 * Added support for Twitch clips.
 * Fix issues with Twitch VODs.
 * Removed unused $wgFFmpegLocation that was interferring with TimedMediaHandler.
 * Added Polish translation.


 * v2.7.4
 * Added support for playlist to evlplayer
 * Added support for youtube video list
 * Updated Documentation for evlplayer
 * Added missing dependency for evlplayer in extension.json


 * v2.7.3
 * Default Twitch VOD to autoplay=false by default
 * Allow videos to be sized in 1:1 aspect ratios for special use cases.


 * v2.7.2
 * Added feature to evlplayer to allow default video content


 * v2.7.1
 * Fixed issue with youku videos not embedding properly on https enabled wikis.


 * v2.7.0
 * Added SoundCloud support
 * Added ability to use service name as a parser tag (if not defined previously)


 * v2.6.1
 * Added new configuration options to disable adding media handlers and file extensions.
 * https://gitlab.com/hydrawiki/extensions/EmbedVideo/issues/76
 * Fixed an uninitialized array.
 * https://gitlab.com/hydrawiki/extensions/EmbedVideo/issues/77
 * Fixed undefined indexes in the AudioHandler class.
 * https://gitlab.com/hydrawiki/extensions/EmbedVideo/issues/78
 * Fixed class properties that were unintentionally declared as static.
 * https://gitlab.com/hydrawiki/extensions/EmbedVideo/issues/75
 * Fixed RTL language issues with CSS.
 * https://gitlab.com/hydrawiki/extensions/EmbedVideo/pull/73



開発者向け注記
ビデオクリップのインジェクション機構として（拡張タグではなく）パーサ関数を使用する主な利点は、パーサ関数が（ 形式の）テンプレートパラメータを利用できることです. 例えば、YouTubeの動画をサムネイルサイズで、画像のように右寄せでたくさん作っていることに気づいたとします. というテンプレートを作って、これを入れることができるかもしれません.

そして、このように呼び出すのです.



バグ報告
GitLabプロジェクトページにイシュー・トラッカーが設置されています.

貢献する
バグレポート、機能リクエスト、パッチはいつでも歓迎します. 十分な関心があれば、GitLabプロジェクトに新しい貢献者を追加することができます.

<span id="See_also">

関連項目

 * Extension:EmbedVideo (fork): EmbedVideoのフォーク — この拡張機能の、よりプライバシーを重視したバージョンです. なお、YouTube、Spotify、Vimeo、Archive.orgのみ対応していますが、新しいサービスはGitHubからリクエストすることが可能です. さらに、 以外のすべてのパーサー関数と、、などのパーサータグが削除されます.

外部リンク

 * ファンダムヘルプWiki /