-
Notifications
You must be signed in to change notification settings - Fork 1
Expand file tree
/
Copy pathreadme.txt
More file actions
208 lines (131 loc) · 8.32 KB
/
readme.txt
File metadata and controls
208 lines (131 loc) · 8.32 KB
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
=== BIVROST 360WebPlayer for WordPress ===
Contributors: chanibal
Tags: video, 360, spherical, vr, panorama, embed, image, media, shortcode, virtual reality
Requires at least: 4.2.0
Tested up to: 4.9.2
Requires PHP: 5.2
Stable tag: trunk
License: GPL v2
The BIVROST 360WebPlayer for WordPress is the easiest way to stream 360 videos and pictures on your website or blog.
== Description ==
Embed 360° videos and pictures on your WordPress blog with the BIVROST 360WebPlayer for WordPress Plugin.
= Features =
* Fast integration into any web site.
* Easy to use for the end user.
* Both desktop and mobile.
* Free for personal use (see license for details).
* Works on all major browsers and systems.
* Possible to embed more than one player on the same page.
* Mono and stereoscopic video and pictures.
* HTTP Live Streaming (HLS).
* Works well with touch.
* Well tested - supports many edge cases.
* [WebVR][webvr] support - works with Oculus Rift, Vive, Windows Mixed Reality, OSVR, GearVR, Google Cardboard and more.
* Supports watching content in external native players ([by BIVROST][player-windows]).
We want to hear your feedback and ideas for new features, to make it even better.
[bivrost]: http://bivrost360.com
[webvr]: http://webvr.info/
[player-windows]: https://download.bivrost360.com/player-desktop/
= Visual Editor =
For a tutorial see [this YouTube video][yt].
[yt]: https://youtu.be/_xYJIyk0uB8
Open the post or page editor and press the BIVROST 360WebPlayer button. Now you can configure the player and select the videos or pictures you want to display.
To add videos press the "add source" button. You can add more than one video at once using the shift, opt or control button. For best results add both a webm/vp6 and a mp4/h264 version.
After you save your settings, you will see a placeholder for the player. Press "preview changes" or publish the page to see the player in action.
To edit your player, just click and press "edit" on top of it - just as you would with a normal WordPress video.
= Shortcodes =
In text mode, there is a shortcode:
`[bivrost-player loop="true"]
my_vr_movie.mp4
my_vr_movie.webm
[/bivrost-player]`
Put the picture or movie urls in the `[bivrost-player]` tag separated by newlines. For the best result add both a webm/vp6 and a mp4/h264 version.
You can configure the player using attributes in the shortcode. Below you can find several options, none of them are required.
= Available options =
* `theme`: which skin do you want? There are 3 skins available:
* "default" - black and blue
* "spring" - black and green
* "autumn" - black and red
optional, default: "default"
* `width`: sets the width of the player. By default the player fits to the available width in a 4:3 aspect ratio. You can override this.
Provide a value in css units, ex. `500px` or `75%`.
* `height`: sets the height of the player. By default the height is derived from its width and is set in 4:3 aspect ratio.
Provide a value in css units, ex. `500px` or `75%`.
* `loop`: allows the video to loop
Allowed values: "true", "false";
optional, default: "false".
* `autoplay`: should the content play automatically?
Allowed values: "true", "false";
optional, default: "true".
* `stereoscopy`: which form of stereoscopy is used?
Allowed values:
* "autodetect" - detects by filename tags and media ratio (see: Media preparation guide),
* "mono" - whole image used,
* "side-by-side" - the image for left eye is on the left half, and right on the right half of the media,
* "top-and-bottom" - the left eye is the top half of the image, the right one on the bottom half,
* "top-and-bottom-reversed" - the left eye is the bottom half of the image, the right one on the top half;
optional, default: "autodetect".
* `source`: is it a video or picture?
Allowed values: "video", "picture", "stream-hls", "stream-dash", "autodetect";
optional, default: "autodetect"
* ``projection`: how is the media projected (mapping from 2d to 3d)?
Allowed value: "equirectangular", "cubemap", "cubemap:configuration...";
optional, default: "equirectangular".
Cubemap can be configured through several cubemap types. There are a few presets defining the order:
* "horizontal" (default) - all sides of the cube are in one line in the following order; left, right, down, up, back, front. OBRX uses this format.
* "two-by-three" - all sides are in two rows: left, right, down and up, bottom, front. Facebook 360 videos use this format.
* "facebook" - the same as two-by-three, but rotated, and each face is cropped by 1%.
* "horizontal-cross" - all sides are in a cross with bottom, right, front and left in the middle row; up is in the top row and down in the bottom.
* "vertical-cross" - up is in the first row, bottom, right and front in the second, left in the third and down in the fourth. ATI CubeMapGen uses this format.
* custom - advanced, please use presets if possible; you can specify any alignment with a description string. The string is a 2d array of face names in order of how they appear in the texture. The rows are separated by "," and the faces are one letter acronyms (accepts capital letters):
* "f" - front
* "b" - back
* "l" - left
* "r" - right
* "u" - up
* "d" - down
* "-" - unused space
Each face can be rotated with `*x`. x is a number from 0 to 3. For example `r*1` is right rotated 90 degrees clockwise.
There are optional modifiers at the end of the string:
* ">90" - rotate the whole cube clockwise by 90 degrees
* "<72" - rotate the whole cube counter clockwise by 72 degrees
* "+0.01" - crop faces by 0.01 (prevents visible edges)
Example: `-u--,blfr,-d*2-->90+0.002`
Please note that with cubemaps, seams can be visible due to texture filtering - this is most visible on horizontal and vertical crosses. It's best you fix them on pictures by duplicating a border into the unused part of the image. The 1% zoom with Facebook prevents this from happening.
= Commercial Use =
Please note, the BIVROST 360WebPlayer's free license allows only for non-commercial use. For commercial use you need to acquire a license, please see License for details.
== Installation ==
Add the BIVROST 360WebPlayer for WordPress plugin using the built-in plugin installer:
1. Download the plugin from [the releases page][download]
2. Go to `Plugins > Add New > Send plugin` and upload the zip file containing the plugin
3. Go to `Plugins > Installed` and enable the plugin
After installation, you will have a new button in the WYSYWIG editor. There is a also a `[bivrost-player]` shortcode available.
[download]: https://github.com/BIVROST/360WebPlayer-for-WordPress/releases
== Frequently Asked Questions ==
For more information about player usage and configuration, please check out the main [BIVROST 360WebPlayer project][github-360WebPlayer].
= Where can I submit feature requests or bug reports? Where can I find the unminified version? =
Please send bugs and feature requests to our [GitHub project][issues]. The sources are located there too. Thanks a lot in advance for any and all feedback.
[issues]: http://github.com/BIVROST/360WebPlayer-for-WordPress
== License ==
This WordPress plugin is a wrapper and configuration tool for the [BIVROST 360WebPlayer][github-360WebPlayer].
For licensing options and to remove or replace our branding, please read the [BIVROST 360WebPlayer license][360WebPlayerLicense] or [contact us at contact@bivrost.pro][email-sales].
[360WebPlayerLicense]: https://github.com/BIVROST/360WebPlayer/#License
[email-sales]: mailto:contact@bivrost.pro
== Screenshots ==
1. Installed player
2. Configuration panel
== Changelog ==
* 2016-04-15: Initial release
* 2018-01-28: Updated to WordPress 4.9
* 2018-08-08: Move to GitHub, updated logo
* 2020-08-24: Updated license
== Upgrade Notice ==
No changes
== Third party libraries ==
The BIVROST 360WebPlayer for WordPress uses third party libraries:
* [THREE.js][threejs] (MIT license)
* [hls.js][hlsjs] (Apache 2.0 License)
* [BIVROST 360 WebPlayer][github-360WebPlayer] (Custom open source license)
[threejs]: http://threejs.org
[hlsjs]: https://github.com/dailymotion/hls.js/
[github-360WebPlayer]: https://github.com/BIVROST/360WebPlayer