interesting
/
PeerTube
mirror of https://github.com/Chocobozzz/PeerTube.git
1
0
Fork 0
Code Issues Projects Releases Wiki Activity

doc: add default values in iFrame api doc (#6118) 

* doc: add default values in iFrame api doc

* doc: handle PR feedbacks

* doc: add missing feedback

* chore: one more fix

* doc: fix last code review feedbacks

---------

Co-authored-by: olivier <olivier.bouillet@ifeelsmart.com>
This commit is contained in:
Olivier Bouillet 2024-01-12 16:01:19 +01:00 committed by GitHub
parent 72e896ea49
commit 9bcf0ecc48
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
1 changed files with 30 additions and 4 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

34
support/doc/api/embeds.md
View File

@ -58,11 +58,13 @@ For example `https://my-instance.example.com/videos/embed/52a10666-3a18-4e73-93d
Start the video at a specific time. Start the video at a specific time.
Value must be raw seconds or a duration (`3m4s`) Value must be raw seconds or a duration (`3m4s`)
Default: starts at `0`
### stop ### stop
Stop the video at a specific time. Stop the video at a specific time.
Value must be raw seconds or a duration (`54s`) Value must be raw seconds or a duration (`54s`)
Default: ends at content end
### controls ### controls
@ -70,36 +72,42 @@ Mimics video HTML element `controls` attribute, meaning that all controls (inclu
It can be useful if you want to have a full control of the PeerTube player. It can be useful if you want to have a full control of the PeerTube player.
Value must be `0` or `1`. Value must be `0` or `1`.
Default: `1`
### controlBar ### controlBar
Hide control bar when the video is played. Hide control bar when the video is played.
Value must be `0` or `1`. Value must be `0` or `1`.
Default: `1`
### peertubeLink ### peertubeLink
Hide PeerTube instance link in control bar. Hide PeerTube instance link in control bar.
Value must be `0` or `1`. Value must be `0` or `1`.
Default: `1`
### muted ### muted
Mute the video by default. Mute the video by default.
Value must be `0` or `1`. Value must be `0` or `1`.
Default: tries to restore the last muted setting set by the user
### loop ### loop
Automatically start again the video when it ends. Automatically start again the video when it ends.
Value must be `0` or `1`. Value must be `0` or `1`.
Default: `0`
### subtitle ### subtitle
Auto select a subtitle by default. Auto select a subtitle by default.
Value must be a valid subtitle ISO code (`fr`, `en`, etc.). Value must be a valid subtitle ISO code (`fr`, `en`, etc.).
Default: no subtitle selected and then tries to restore the last subtitle set by the user
### autoplay ### autoplay
@ -107,34 +115,40 @@ Try to automatically play the video.
Most web browsers disable video autoplay if the user did not interact with the video. You can try to bypass this limitation by muting the video Most web browsers disable video autoplay if the user did not interact with the video. You can try to bypass this limitation by muting the video
Value must be `0` or `1`. Value must be `0` or `1`.
Default: `0`
### playbackRate ### playbackRate
Force the default playback rate (`0.75`, `1.5` etc). Force the default playback rate (`0.75`, `1.5` etc).
Default: `1`
### title ### title
Hide embed title. Show/Hide embed title.
Value must be `0` or `1`. Value must be `0` or `1`.
Default: `1`
### warningTitle ### warningTitle
Hide P2P warning title. Show/Hide P2P warning title.
Value must be `0` or `1`. Value must be `0` or `1`.
Default: `1`
### p2p ### p2p
Disable P2P. Enable/Disable P2P.
Value must be `0` or `1`. Value must be `0` or `1`.
Default: tries to use the user setting and fallbacks to instance setting if user setting is not found
### bigPlayBackgroundColor ### bigPlayBackgroundColor
Customize big play button background color. Customize big play button background color.
Value must be a valid color (`red` or `rgba(100, 100, 100, 0.5)`). Value must be a valid color (`red` or `rgba(100, 100, 100, 0.5)`).
Default: rgba(0, 0, 0, 0.8)
### foregroundColor ### foregroundColor
@ -142,18 +156,26 @@ Customize embed font color.
Value must be a valid color (`red` or `rgba(100, 100, 100, 0.5)`). Value must be a valid color (`red` or `rgba(100, 100, 100, 0.5)`).
Default: `white`
### mode ### mode
Force a specific player engine. Force a specific player engine.
Value must be a valid mode (`web-video` or `p2p-media-loader`). Value must be a valid mode (`web-video` or `p2p-media-loader`).
See behaviour description [here](https://docs.joinpeertube.org/admin/configuration#vod-transcoding)
Default: `p2p-media-loader` and fallback to `web-video` mode.
### api ### api
Enable embed JavaScript API (see methods below). Enable/Disable embed JavaScript API (see methods below).
Value must be `0` or `1`. Value must be `0` or `1`.
Default: `0`
### waitPasswordFromEmbedAPI ### waitPasswordFromEmbedAPI
**PeerTube >= 6.0** **PeerTube >= 6.0**
@ -162,6 +184,10 @@ If the video requires a password, PeerTube will wait a password provided by `set
Until you provide a password, `player.ready` is not resolved. Until you provide a password, `player.ready` is not resolved.
Value must be `0` or `1`.
Default: `0`
## Embed attributes ## Embed attributes