开发者 |
kostalski
bradmax |
---|---|
更新时间 | 2024年9月25日 19:41 |
捐献地址: | 去捐款 |
PHP版本: | 4.2 及以上 |
WordPress版本: | 6.6.2 |
版权: | GPLv3 or later |
版权网址: | 版权信息 |
[bradmax_video url="https://bradmax.com/static/video/tos/big_buck_bunny.m3u8" duration="596" poster="https://bradmax.com/static/images/startsplash.jpg"]
[bradmax_video url="http://example.com/hls_stream.m3u8" autoplay="true"]
Mute
Causes the video starts with muted sound. This option is usefull for starting video automatically with "autoplay" option.
[bradmax_video url="http://example.com/hls_stream.m3u8" autoplay="true" mute="true"]
Duration
Defines length of video stream in seconds. Can contain fraction of second. It is required for displaying duration of video before staring playback.
[bradmax_video url="http://example.com/hls_stream.m3u8" duration="100.1"]
Poster
Defines image to show as placeholder before the video plays.
[bradmax_video url="http://example.com/hls_stream.m3u8" poster="http://example.com/wp-content/uploads/poster.jpg"]
Pip
Enables additional button in player skin for enabling/disabling Picture-in-Picture mode. When PIP mode is enabled then player is detached from browser and user can watch video over other screens.
Note: This feature requires player at last v2.12.0 version. If you are using older customized player (changed colors, skin, etc.), then you have to generate new one on bradmax.com page.
PIP button appears after starting playback. Before it is blocked by browser.
[bradmax_video url="http://example.com/hls_stream.m3u8" pip="true"]
Chapters & Time markers
Defines additional info for video chapters. Such information will be presented on progress bar. Format for video chapters is similar to Youtube chapters in description.
Each chapter entry should be in separated line or separated from other entries using semicolon (;). Entry begins with start time of chapter and folowed by label for chapter.
Chapters use "chapters" attribute name and time markers "time_markers".
[bradmax_video url="https://bradmax.com/static/video/tos/440272.mpd" duration="100.1" chapters=" 0:00 - Intro 0:23 - 1. Preparations 3:18 - 2. Simulation 7:18 - 3. Defense 8:48 - 4. Forgiveness 9:38 - Credits " time_markers=" 1:40 - Decoy 3:20 - Simulation start 5:30 - They are comming ... 8:08 - Rope slide 11:14 - Credits rope slide "]
Example for semicolons instead of new lines - all in one line. Sometimes wordpress can have problems with multiline in shortcodes. Using semicolons will solve it.
[bradmax_video url="https://bradmax.com/static/video/tos/440272.mpd" duration="100.1" chapters="0:00 - Intro ; 0:23 - 1. Preparations ; 3:18 - 2. Simulation ;7:18 - 3. Defense ; 8:48 - 4. Forgiveness ; 9:38 - Credits"]
Class
Defines CSS class, which should be added into player box on page (customizing view on WordPress page).
[bradmax_video url="http://example.com/hls_stream.m3u8" class="my-custom-player-css-class"]
Style
Defines CSS style string, which should be added into player for on page (customizing view on WordPress page).
[bradmax_video url="http://example.com/hls_stream.m3u8" style="width:400px;height:200px;border:solid 1px gray"]
Subtitles
Defines list of subtitles files (one file per language) for video. Subtitles files has to be in SRT or VTT format (file extension .srt or .vtt). Format for subtitles list subtitles="LANG_CODE=FILE_LINK LANG_CODE=FILE_LINK ...", where LANG_CODE is two letter language code (ISO 639-1 standard - https://en.wikipedia.org/wiki/List_of_ISO_639-1_codes) for defining subtitles language. FILE_LINK is link to file stored on some HTTP server, which player will be able to download during playback.
Working example (subtitles in Czech language):
[bradmax_video url="https://bradmax.com/static/video/tos/tesla/tesla.m3u8" subtitles="cz=https://bradmax.com/static/video/tos/tesla/tesla_cz.srt"]
Example with multiple languages for video:
[bradmax_video url="http://example.com/hls_stream.m3u8" subtitles="en=https://example.com/subtitles_en.srt cz=https://example.com/subtitles_cz.srt sk=https://example.com/subtitles_sk.srt"]
ga_tracker_id
Defines Google Analytics tracker id. When defined video playback is tracked in your Google Analytics account in "Events" sections.
"Tracker ID" is code having form "UA-XXXXXXXX-X", where X is 0-9 digit and is located in Google Analytics > Admin > Tracking Info > Tracking Code.
Example:
[bradmax_video url="http://example.com/hls_stream.m3u8" ga_tracker_id="UA-XXXXXXXX-X" media_id="my example stream"]
media_id
This parameter is used, when Google Analytics plugin is active (see ga_tracker_id video shortcode). It is used for each media distinction, so for each different video diferent value should be provided. It can be any text, but it is recomended to keep it short.
Alternative stream formats (url_2, url_3, url_4)
If you got video content (same title/media) in multiple formats eg. MPEG-DASH, HLS, MS Smooth Streaming you can provide them to player using shortcodes url_2, url_3, url_4 . Player automatically choses format with best support for device. You can put links in any order.
Example for video with many formats (MPEG-DASH and HLS):
[bradmax_video url="https://bradmax.com/static/video/tos/440272.mpd" url_2="https://bradmax.com/static/video/tos/440272.m3u8"]
live_
Player supports playback for live stream transmissions (HLS, MPEG-DASH, MS Smooth Streaming). For such transmissions are additonal parameters, which improve user experience.
[bradmax_video url="http://example.com/hls_live_stream.m3u8" live_waiting_for_transmission_image_url="https://bradmax.com/static/images/waiting_for_transmission.jpg" live_thank_you_image_url="https://bradmax.com/static/images/thankyou_endsplash.jpg" live_end_date="2020-06-14T14:00:00+08:00"]
[bradmax_video url="http://example.com/hls_live_stream.m3u8" live_low_latency_mode="true"]
drm_
Player supports playback for DRM protected video - paid version of player downloaded from bradmax.com is required. Short codes for DRM configuration:
[bradmax_video url="https://example.com/drm_protected_stream.mpd" drm_prov="default" drm_widevine_url="https://drm.example.com/license"]
Yes.
Yes, and what more HLS streams can be displayed even on desktop devices, which natively not support HLS streams.
Yes.
Yes.