X-Git-Url: https://git.immae.eu/?a=blobdiff_plain;f=support%2Fdoc%2Fapi%2Fembeds.md;h=bc3b5304c39f59d067263b7ce15d6b97c578548e;hb=fba911e2c89708a166636e3a93fcd8fcbc3de7e1;hp=e3df35efcdd7a58b7595f9b5518dc67fbc29259a;hpb=610d0be13b3d01f653ef269271dd667a57c85ef2;p=github%2FChocobozzz%2FPeerTube.git diff --git a/support/doc/api/embeds.md b/support/doc/api/embeds.md index e3df35efc..bc3b5304c 100644 --- a/support/doc/api/embeds.md +++ b/support/doc/api/embeds.md @@ -49,6 +49,59 @@ player.seek(32) player.pause() ``` +# URL parameters + +You can customize PeerTube player by specifying URL query parameters. +For example `https://my-instance.example.com/videos/embed/52a10666-3a18-4e73-93da-e8d3c12c305a??start=1s&stop=18s&loop=1&autoplay=1&muted=1&warningTitle=0&controlBar=0&peertubeLink=0&p2p=0` + +## start + +Start the video at a specific time. +Value must be raw seconds or a duration (`3m4s`) + +## stop + +Stop the video at a specific time. +Value must be raw seconds or a duration (`54s`) + +## controls + +Mimics video HTML element `controls` attribute, meaning that all controls (including big play button, control bar, etc.) will be removed. +It can be useful if you want to have a full control of the PeerTube player. + +Value must be `0` or `1`. + +## controlBar + +Hide control bar when the video is played. + +Value must be `0` or `1`. + +## peertubeLink + +Hide PeerTube link in control bar. + +Value must be `0` or `1`. + +## muted + +Mute the video by default. + +Value must be `0` or `1`. + +## loop + +Automatically start again the video when it ends. + +Value must be `0` or `1`. + +## subtitle + +Auto select a subtitle by default. + +Value must be a valid subtitle ISO code (`fr`, `en`, etc.). + + # Methods ## `play() : Promise` @@ -115,6 +168,18 @@ Update current caption using the caption id. Get video captions. +## `playNextVideo(): Promise` + +Play next video in playlist. + +## `playPreviousVideo(): Promise` + +Play previous video in playlist. + +## `getCurrentPosition(): Promise` + +Get current position in playlist (starts from 1). + # Events You can subscribe to events by using `addEventListener()`. See above for details.