Title: Fluid Player
Author: fluidplayer
Published: <strong>2017 年 4 月 18 日</strong>
Last modified: 2023 年 10 月 18 日

---

搜索插件

**该插件尚未通过WordPress的最新3个主要版本进行测试**。 当与较新版本的WordPress一起
使用时，可能不再受到维护或支持，并且可能会存在兼容性问题。

![](https://s.w.org/plugins/geopattern-icon/fluid-player.svg)

# Fluid Player

 作者：[fluidplayer](https://profiles.wordpress.org/fluidplayer/)

[下载](https://downloads.wordpress.org/plugin/fluid-player.zip)

 * [详情](https://cn.wordpress.org/plugins/fluid-player/#description)
 * [评价](https://cn.wordpress.org/plugins/fluid-player/#reviews)
 *  [安装](https://cn.wordpress.org/plugins/fluid-player/#installation)
 * [开发进展](https://cn.wordpress.org/plugins/fluid-player/#developers)

 [支持](https://wordpress.org/support/plugin/fluid-player/)

## 描述

This plugin is a wrapper around the html5 video player [Fluid Player](https://www.fluidplayer.com)

Once the plugin is installed and activated, you’ll only need to use the any of the[
fluid-player] or [fluid-player-extended] shortcodes at the desired location in your
page or post. The plugin comes with a default sample video, vast file and thumbnail
previews. If no shortcode parameters are provided, the plugin will fallback to the
previously listed values.

For issues please refer to the main Fluid Player repository https://github.com/fluid-
player/fluid-player

## 安装

This section describes how to install the plugin and get it working.

 1. Upload the plugin files to the `/wp-content/plugins/fluid-player` directory, or
    install the plugin through the WordPress plugins screen directly.
 2. Activate the plugin through the ‘Plugins’ screen in WordPress
 3. Include any of the the [fluid-player] or [fluid-player-extended] shortcodes on 
    your website pages/posts. Below is the list of accepted parameters:

 * video : path to actual video to be used by the player. If no value is passed 
   it will fall back to the plugin sample video.
 * vast_file : path to vast file (optional)
 * vtt_file : path to VTT file (optional)
 * vtt_sprite : path to VTT sprites file (optional)
 * layout : the following skins are provided with the player: default/browser, if
   no value is passed it will fall back to ‘default’
 * responsive : toggle responsive behavior, defaults to false
 * auto-play : toggle video autoplay, defaults to false
 * playback-speed-control : Toggle playback speed widget on the control bar, defaults
   to false
 * poster-image : Poster image to be displayed before video playback starts. Video
   screenshot is used most commonly
 * allow-download : Toggle Download button on the control bar, defaults to false
 * logo : Logo url
 * logo-position: logo positioning, default value “top right”
 * logo-opacity : logo opacity, default value 1
 * logo-hyperlink: URL which will open in an new tab when the logo is clicked
 * ad-text : Ad text visible in the top right corner of the video
 * ad-cta-text : CTA hyperlink visible in the bottom left corner of the video
 * html-on-pause-block-width : html banner width, default null
 * html-on-pause-block-height : html banner height, default null

To further customize the video player, you will need to follow the docs at https://
docs.fluidplayer.com/
 You can use [fluid-player-ad-list] to add multiple ad rolls
with different configurations, or you can totally overwrite the plugin parameters
by using [fluid-player-options].

Using [fluid-player-options] is our recommended approach, since it will enable more
compatibility with newer versions of Fluid Player.

Simple shortcode example:

    ```
    [fluid-player
        video="foo.mp4"
        vast_file="vast.xml"
        vtt_file="thumbs.vtt"
        vtt_sprite="thumbs.jpg"
        layout="default"

        auto-play="true"
        allow-download="true"
        playback-speed-control="true"

        responsive="true"
    ]
    ```

Extended shortcode example:

    ```
    [fluid-player-extended vast_file="https://pubads.g.doubleclick.net/gampad/ads?iu=/21775744923/external/single_ad_samples&sz=640x480&cust_params=sample_ct%3Dlinear&ciu_szs=300x250%2C728x90&gdfp_req=1&output=vast&unviewed_position_start=1&env=vp&impl=s&correlator=" responsive="true" layout="default" auto-play="false" allow-download="true" playback-speed-control="true" poster-image="https://www.fluidplayer.com/images/valerian-thumbnail.jpg" logo="https://placekitten.com/64/64" logo-position="top right" logo-opacity=".8" logo-hyperlink="https://www.fluidplayer.com/" ad-text="adText" ad-cta-text="adCTAText" html-on-pause-block-width="100" html-on-pause-block-height="100"]

        [fluid-player-multi-res-video]
            [
                {"label": "720", "url": "https://cdn.fluidplayer.com/videos/valerian-720p.mkv"},
                {"label": "480", "url": "https://cdn.fluidplayer.com/videos/valerian-480p.mkv"}
            ]
        [/fluid-player-multi-res-video]

        [fluid-player-html-block]
            <div>
                <img src="https://placekitten.com/100/100" />
            </div>
        [/fluid-player-html-block]

    [/fluid-player-extended]
    ```

Extended shortcode example with custom adList:

    ```
    [fluid-player-extended responsive="true" layout="default" auto-play="false" allow-download="true" playback-speed-control="true" poster-image="https://www.fluidplayer.com/images/valerian-thumbnail.jpg" logo="https://placekitten.com/64/64" logo-position="top right" logo-opacity=".8" logo-hyperlink="https://www.fluidplayer.com/" ad-text="adText" ad-cta-text="adCTAText"]

        [fluid-player-ad-list]
            [
                { roll: 'preRoll', vastTag: 'https://pubads.g.doubleclick.net/gampad/ads?iu=/21775744923/external/single_ad_samples&sz=640x480&cust_params=sample_ct%3Dlinear&ciu_szs=300x250%2C728x90&gdfp_req=1&output=vast&unviewed_position_start=1&env=vp&impl=s&correlator=' },
                { roll: 'midRoll', timer: '15', vastTag: 'https://pubads.g.doubleclick.net/gampad/ads?iu=/21775744923/external/nonlinear_ad_samples&sz=480x70&cust_params=sample_ct%3Dnonlinear&ciu_szs=300x250%2C728x90&gdfp_req=1&output=vast&unviewed_position_start=1&env=vp&impl=s&correlator=' },
                { roll: 'postRoll', vastTag: 'https://pubads.g.doubleclick.net/gampad/ads?iu=/21775744923/external/single_preroll_skippable&sz=640x480&ciu_szs=300x250%2C728x90&gdfp_req=1&output=vast&unviewed_position_start=1&env=vp&impl=s&correlator=' },
                { roll: 'onPauseRoll', vastTag: 'https://pubads.g.doubleclick.net/gampad/ads?iu=/21775744923/external/nonlinear_ad_samples&sz=480x70&cust_params=sample_ct%3Dnonlinear&ciu_szs=300x250%2C728x90&gdfp_req=1&output=vast&unviewed_position_start=1&env=vp&impl=s&correlator=' },
            ]
        [/fluid-player-ad-list]

        [fluid-player-multi-res-video]
            [
                {"label": "720", "url": "https://cdn.fluidplayer.com/videos/valerian-720p.mkv"},
                {"label": "480", "url": "https://cdn.fluidplayer.com/videos/valerian-480p.mkv"}
            ]
        [/fluid-player-multi-res-video]

    [/fluid-player-extended]
    ```

Extended shortcode example with custom configuration:

    ```
    [fluid-player-extended]

        [fluid-player-options]
        {
            layoutControls: {
                primaryColor:           false,
                playButtonShowing:      true,
                playPauseAnimation:     true,
                fillToContainer:        true,
                autoPlay:               false,
                preload:                false,
                mute:                   false,
                doubleclickFullscreen:  true,
                subtitlesEnabled:       false,
                keyboardControl:        true,
                layout:                 'default',
                allowDownload:          false,
                playbackRateEnabled:    false,
                allowTheatre:           true,
                title:                  false,
                loop:                   false,
                logo: {
                    imageUrl:           null,
                    position:           'top left',
                    clickUrl:           null,
                    opacity:            1
                },
                controlBar: {
                    autoHide:           true,
                    autoHideTimeout:    3,
                    animated:           true,
                    playbackRates:      ['x2', 'x1.5', 'x1', 'x0.5']
                },
                timelinePreview:        {},
                htmlOnPauseBlock: {
                    html:               null,
                    height:             null,
                    width:              null
                },
                playerInitCallback:     (function() {}),
                miniPlayer: {
                    enabled: true,
                    width: 400,
                    height: 225
                }
            },
            vastOptions: {
                adList:                     [
                    { roll: 'preRoll', vastTag: 'https://pubads.g.doubleclick.net/gampad/ads?iu=/21775744923/external/single_ad_samples&sz=640x480&cust_params=sample_ct%3Dlinear&ciu_szs=300x250%2C728x90&gdfp_req=1&output=vast&unviewed_position_start=1&env=vp&impl=s&correlator=' }
                ],
                skipButtonCaption:          'Skip ad in [seconds]',
                skipButtonClickCaption:     'Skip ad <span class="skip_button_icon"></span>',
                adText:                     null,
                adTextPosition:             'top left',
                adCTAText:                  'Visit now!',
                adCTATextPosition:          'bottom right',
                vastTimeout:                5000,
                showPlayButton:             false,
                maxAllowedVastTagRedirects: 1,
                vastAdvanced: {
                    vastLoadedCallback:       (function() {}),
                    noVastVideoCallback:      (function() {}),
                    vastVideoSkippedCallback: (function() {}),
                    vastVideoEndedCallback:   (function() {})
                }
            }
        }
        [/fluid-player-options]

        [fluid-player-multi-res-video]
            [
                {"label": "720", "url": "https://cdn.fluidplayer.com/videos/valerian-720p.mkv"},
                {"label": "480", "url": "https://cdn.fluidplayer.com/videos/valerian-480p.mkv"}
            ]
        [/fluid-player-multi-res-video]

    [/fluid-player-extended]
    ```

## 评价

![](https://secure.gravatar.com/avatar/b7afd1b0efb4f0fc49801cdc747cd4df3dad1b2dd95bd99553fe4464743050ca?
s=60&d=retro&r=g)

### 󠀁[Gracias por hacer algo tan bueno](https://wordpress.org/support/topic/gracias-por-hacer-algo-tan-bueno/)󠁿

 [abelhoyos](https://profiles.wordpress.org/abelhoyos/) 2023 年 4 月 17 日

5 Estrellas para su buen trabajo, los felicito. Muchas gracias. Saludos desde Peru.

![](https://secure.gravatar.com/avatar/1fcc1e2aea9e9b92442b949c4bf8de840fcd9a0c540941aa56ed15072d7951e4?
s=60&d=retro&r=g)

### 󠀁[the best video player plugin](https://wordpress.org/support/topic/the-best-video-player-plugin/)󠁿

 [lleeandra98](https://profiles.wordpress.org/lleeandra98/) 2021 年 3 月 4 日

This plugin really great, and open source can do anything what i needed, i wanna
change this plugin to default media player in wordpress but i haven’t seen people
doing about it before

![](https://secure.gravatar.com/avatar/a428efe4198e3fede33acb9e0221d8b75426f84763c76afacae57896856ce885?
s=60&d=retro&r=g)

### 󠀁[کارش عالیه](https://wordpress.org/support/topic/%da%a9%d8%a7%d8%b1%d8%b4-%d8%b9%d8%a7%d9%84%db%8c%d9%87/)󠁿

 [mr.nosrati](https://profiles.wordpress.org/mrnosrati/) 2019 年 5 月 10 日

واقعا عالیییییییییییییییییییییییییی

![](https://secure.gravatar.com/avatar/711a77396d959afa587f83911c2626594349954b1876efe71d305e89583e8208?
s=60&d=retro&r=g)

### 󠀁[Needs Improvements](https://wordpress.org/support/topic/needs-improvements-8/)󠁿

 [marcojoelmirschutz](https://profiles.wordpress.org/marcojoelmirschutz/) 2018 年
3 月 1 日 3 回复

It needs several improvements to be well evaluated.

![](https://secure.gravatar.com/avatar/e98f5368d0f918f67142baa90b20816f354ea27f715df18f3cc34c5823c18eaa?
s=60&d=retro&r=g)

### 󠀁[Works great](https://wordpress.org/support/topic/works-great-4208/)󠁿

 [jinyus](https://profiles.wordpress.org/jinyus/) 2017 年 8 月 2 日 1 回复

It is a bit barebones but functions well. Html blobk on pause would be a great feature.
And it looks crammed on mobile devices.

 [ 阅读所有5条评价 ](https://wordpress.org/support/plugin/fluid-player/reviews/)

## 贡献者及开发者

「Fluid Player」是开源软件。 以下人员对此插件做出了贡献。

贡献者

 *   [ fluidplayer ](https://profiles.wordpress.org/fluidplayer/)
 *   [ florintudor ](https://profiles.wordpress.org/florintudor/)

[帮助将「Fluid Player」翻译成简体中文。](https://translate.wordpress.org/projects/wp-plugins/fluid-player)

### 对开发感兴趣吗?

您可以[浏览代码](https://plugins.trac.wordpress.org/browser/fluid-player/)，查看
[SVN仓库](https://plugins.svn.wordpress.org/fluid-player/)，或通过[RSS](https://plugins.trac.wordpress.org/log/fluid-player/?limit=100&mode=stop_on_copy&format=rss)
订阅[开发日志](https://plugins.trac.wordpress.org/log/fluid-player/)。

## 更新日志

#### 3.0

 * Introduces fluid-player-ad-list shortcode
 * Introduces fluid-player-options shortcode
 * Updates Fluid Player to v3

#### 2.0

 * Bringing plugin inline with version V2 of Fluid Player

## 额外信息

 *  版本 **3.0.0**
 *  最后更新：**3 年前**
 *  活跃安装数量 **400+**
 *  WordPress 版本 ** 4.6 或更高版本 **
 *  已测试的最高版本为 **6.3.8**
 *  PHP 版本 ** 5.4 或更高版本 **
 *  语言
 * [English (US)](https://wordpress.org/plugins/fluid-player/)
 * 标签
 * [HTML5 video player](https://cn.wordpress.org/plugins/tags/html5-video-player/)
   [thumbnails](https://cn.wordpress.org/plugins/tags/thumbnails/)[VAST](https://cn.wordpress.org/plugins/tags/vast/)
 *  [高级视图](https://cn.wordpress.org/plugins/fluid-player/advanced/)

## 评级

 4.6 星（最高 5 星）。

 *  [  4 条 5 星评价     ](https://wordpress.org/support/plugin/fluid-player/reviews/?filter=5)
 *  [  0 条 4 星评价     ](https://wordpress.org/support/plugin/fluid-player/reviews/?filter=4)
 *  [  1 条 3 星评价     ](https://wordpress.org/support/plugin/fluid-player/reviews/?filter=3)
 *  [  0 条 2 星评价     ](https://wordpress.org/support/plugin/fluid-player/reviews/?filter=2)
 *  [  0 条 1 星评价     ](https://wordpress.org/support/plugin/fluid-player/reviews/?filter=1)

[Your review](https://wordpress.org/support/plugin/fluid-player/reviews/#new-post)

[查看全部评论](https://wordpress.org/support/plugin/fluid-player/reviews/)

## 贡献者

 *   [ fluidplayer ](https://profiles.wordpress.org/fluidplayer/)
 *   [ florintudor ](https://profiles.wordpress.org/florintudor/)

## 支持

有话要说吗？是否需要帮助？

 [查看支持论坛](https://wordpress.org/support/plugin/fluid-player/)

## 捐助

您愿意支持这个插件的发展吗?

 [ 捐助此插件 ](http://example.com/)