Extension:EmbedVideo/ja

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


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


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


 * バグ
 * GitLabの課題


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


 * GDPR準拠のForge
 * 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の動画は、 のサービスセレクタを使用します. You can specify either the raw 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拡張のタグに対応しました.

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

The VideoLink extension allows embedding of YouTube videos in articles; allowing for multiple linked videos to be played in a single embedded video player, first shown when a user clicks on a video link.

The &lt;evlplayer /&gt; specifies where the player should appear within the page, and the parser function allows creation of links that load a specific video.

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

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

An important caveat to make note of, is that the  and   attributes only effect the video that is being included into the container, and not the actual container. For styling of the container, please use the  or   attributes.

— Parser function for video links
In addition to all of the attributes supported by the  tag, these specific attributes apply to the   (and  ) tags. To maintain backwards compatibility, if you do not define a  then   is assumed.

動画リンク例
Creating a video list allows video links to create a playlist on the fly using the youtube and youtubevideolist service.

サポートされるサービス
As of version 2.x, EmbedVideo supports embedding video content from the following services:

バージョン履歴

 * 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

開発者向け注記
The major benefit of using a parser function as the injection mechanism for video clips (as opposed to an extension tag) is that parser functions can utilize template parameters (of the form ). For example, say you found yourself making a lot of YouTube videos in thumbnail size, right-aligned like an image. You might make a template called, which could contain this:

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

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

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

関連項目

 * EmbedVideoのフォーク — この拡張機能の、よりプライバシーを重視したバージョンです. Note that only YouTube, Spotify, Vimeo and Archive.org is supported, but new services can be requested through GitHub. Moreover every parser function but   and the parser tags like,  etc. are removed.

外部リンク

 * ファンダムヘルプWiki /