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

---

搜尋外掛

這個外掛**並未在最新的 3 個 WordPress 主要版本上進行測試**。開發者可能不再對這個
外掛進行維護或提供技術支援，並可能會與更新版本的 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://tw.wordpress.org/plugins/fluid-player/#description)
 * [使用者評論](https://tw.wordpress.org/plugins/fluid-player/#reviews)
 *  [安裝方式](https://tw.wordpress.org/plugins/fluid-player/#installation)
 * [開發資訊](https://tw.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 或更新版本 **
 *  已測試相容的 WordPress 版本 **6.3.8**
 *  PHP 版本需求 ** 5.4 或更新版本 **
 *  語言
 * [English (US)](https://wordpress.org/plugins/fluid-player/)
 * 標籤:
 * [HTML5 video player](https://tw.wordpress.org/plugins/tags/html5-video-player/)
   [thumbnails](https://tw.wordpress.org/plugins/tags/thumbnails/)[VAST](https://tw.wordpress.org/plugins/tags/vast/)
 *  [進階檢視](https://tw.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/)