X-Git-Url: https://git.immae.eu/?a=blobdiff_plain;f=support%2Fdoc%2Fapi%2Fembeds.md;h=d64615764edab58af4d4677d691dab6344c583a5;hb=29553847dc0aec499cd790c90f5f35d0036dd2a1;hp=7085b4b0ad569e2592eafd143a433fb350ac7712;hpb=624a022157abc74e72c2cac3a80c823eb950e599;p=github%2FChocobozzz%2FPeerTube.git diff --git a/support/doc/api/embeds.md b/support/doc/api/embeds.md index 7085b4b0a..d64615764 100644 --- a/support/doc/api/embeds.md +++ b/support/doc/api/embeds.md @@ -4,8 +4,8 @@ PeerTube lets you embed videos and programmatically control their playback. This ## Playground -Any PeerTube embed URL (ie `https://my-instance.example.com/videos/embed/52a10666-3a18-4e73-93da-e8d3c12c305a`) can be viewed as an embedding playground which -allows you to test various aspects of PeerTube embeds. Simply replace `/embed` with `/test-embed` and visit the URL in a browser. +Any PeerTube embed URL (ie `https://my-instance.example.com/videos/embed/52a10666-3a18-4e73-93da-e8d3c12c305a`) can be viewed as an embedding playground which +allows you to test various aspects of PeerTube embeds. Simply replace `/embed` with `/test-embed` and visit the URL in a browser. For instance, the playground URL for the above embed URL is `https://my-instance.example.com/videos/test-embed/52a10666-3a18-4e73-93da-e8d3c12c305a`. ## Quick Start @@ -95,11 +95,11 @@ Get the available playback rates, where `1` represents normal speed, `0.5` is ha Get the current playback rate. See `getPlaybackRates()` for more information. -## `setPlaybackRate(rate : number) : Promise` +## `setPlaybackRate(rate: number) : Promise` Set the current playback rate. The passed rate should be a value as returned by `getPlaybackRates()`. -## `setVolume(factor : number) : Promise` +## `setVolume(factor: number) : Promise` Set the playback volume. Value should be between `0` and `1`. @@ -107,13 +107,33 @@ Set the playback volume. Value should be between `0` and `1`. Get the playback volume. Returns a value between `0` and `1`. +## `setCaption(id: string) : Promise` + +Update current caption using the caption id. + +## `getCaptions(): Promise<{ id: string, label: string, src: string, mode: 'disabled' | 'showing' }>` + +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. ## Event `playbackStatusUpdate` -Fired every half second to provide the current status of playback. +Fired every half second to provide the current status of playback. The parameter of the callback will resemble: ```json