Extension:TimedMediaHandler/zh

TimedMediaHandler擴展允許您使用與image文件相同的語法在Wiki頁面中顯示音頻和視頻文件. 它包括Kaltura HTML5 Player和實驗性的VideoJS Player. 支持字幕和字幕（又稱定時文本）以及在多個WebM和其他派生工具以及許多其他功能之間的實時流切換. TMH服務器端支持包括用於上傳HTML5音頻和視頻的選項，用於傳遞內容的多個轉碼配置文件，MIDI文件的回放，用於Ogg和WebM視頻的元數據解析，以及與MediaWiki的jobQueue系統集成以安排轉碼作業.

For new and upcoming developments in 2022, see Extension:TimedMediaHandler/2022 work.

'' Please note that TimedMediaHandler does not currently work with PostgreSQL. See. ''

功能预览
查看Commons:Timed Text页面.

语法简介
在image embed syntax基础上，Timed Media Handler支持：


 * Video.ogv
 * 用原尺寸显示一个视频. 显示一个在视频中点提取的静止图像，和一个用来激活播放器的播放按钮.


 * Audio.oga
 * 为声音文件显示一个占位符，包含一个用于激活播放器的播放按钮.


 * [[File:Midi.mid]]
 * 根據MIDI文件中的音樂指令生成數字音頻，並顯示嵌入式音頻播放器以播放此音頻.


 * Video.ogv
 * 在一个浮动的缩略图里显示视频.


 * 在一个图片库（image gallery）里嵌入视频（每一个截图都会弹出一个用于完整视频的对话框）.
 * 在一个图片库（image gallery）里嵌入视频（每一个截图都会弹出一个用于完整视频的对话框）.


 * Video.ogg
 * 用1分25秒的一帧画面插入视频作为占位图形. 一个单独的数字将默认被理解成秒数. 也可以使用HH:MM:SS，例如1:02:22将是视频的1小时2分22秒.
 * → Note that thumb generation with  is no longer working as of MediaWiki 1.35 (minimum). See.


 * Video.ogg
 * Temporal media fragments displays a video clip starting at 1 minute 25 seconds into the video. A single number is taken as an offset in seconds. You can also include an end time of the form  Which would result in a clip of 5 seconds playing from 1:25 to 1:30. If thumbtime is not provided, the start time will be used for the displayed thumbnail. 也可以使用HH:MM:SS，例如1:02:22将是视频的1小时2分22秒.
 * and  can also be used as query parameters in the URL for a video's file page.


 * 弃用
 * 語法字 noicon 和 noplayer 已棄用，不起作用. 關鍵字disablecontrols可能會被棄用.  （请参见） 它採用以下任何值的逗號分隔列表： options, timedText , fullscreen

客户端支持


这个播放器在大部分现代浏览器上能够工作，支持IE9及更高版本（在MediaWiki's support matrix里有关于现代浏览器的描述）. 移动端支持情况不一，尤其是在iOS上.

自2015年8月起，TimedMediaHandler包括用於Ogg音頻/視頻的JavaScript兼容性代碼，可在Safari，Internet Explorer 10/11和Microsoft Edge瀏覽器中使用.

MediaWiki的第三方用戶可能還希望為Safari / IE / Edge中的本地視頻和音頻播放手動啟用MP4 H.264 / AAC支持，但是使用這些格式時，您可能需要MPEG-LA的專利許可才能進行互聯網廣播.

安装
You will want a recent version of ffmpeg in order to support encoding to WebM (with the latest version of VP8). 有關舊版MediaWiki的安裝說明，請參見以下各節.

The extension will automatically add supported file types (except for mp4) to, so you do not need to manually add video file types.

维基百科媒体编码选项的比较
See for deployment details on planned Wikimedia update from VP8 to VP9.

Sorted by bandwidth tier (grayed items are not currently enabled):

详细选项:

配置
这里展示了一些可能有用的配置变量：

如果需要转码，请确认你的, , 足够大而保证转码工作进行并保存输出. 默认值很可能太小了.

进行转码工作
由于转码工作是资源集中型工作，它们不会再常规工作队列中运行 (查看 ). 相反，它们必须由 参数请求：

如果運行此命令使其永久掛起，則可能需要在LocalSettings.php中設置. 参见.

编码节点
为了能够转码许多视频，你可能想要运行多个连接到主数据库并且直接访问你的文件的编码节点. 您将需要安装ffmpeg.

在Debian和Ubuntu下的最小安装
Plus, add this to your (tested for Devuan ASCII  only):

On older versions of MediaWiki (1.29–1.31)

 * 對於系統管理員而言，版本1.31已被破壞.  The extension now requires, dropped the dependency for the  extension, and the WebVideoTranscode PHP constants are now expressed as string values instead.
 * Note that, although was included in TimedMediaHandler for MediaWiki 1.31 and later, for MediaWiki versions prior to that you will need to download it from the archive page.

In, load the extension with:

Prior to 1.31,  is set with:

Troubleshooting

 * " – failed to map segment from shared object "
 * You need to increase the allowed memory in.


 * " Class 'getID3' not found "
 * You need to install the extension's PHP dependencies using Composer, see the Installation section above.


 * " Unrecognized option 'max_muxing_queue_size' "
 * You may be using ffmpeg 2. You need add  to your.