Player Parameters
About Player Parameters
Player parameters are query parameters that you can append to the playback_url to configure the player's behavior. These parameters allow for a customized playback experience by controlling features such as mute, autoplay, looping, and more directly through the URL.
Parameters Overview
The following query parameters can be added to the playback_url to control the player's settings:
| Parameter | Data Type | Values | Description |
|---|---|---|---|
background | String | '1' or '0' | Enables or disables background mode. '1' enables it, '0' disables it. |
muted | String | '1' or '0' | Mutes or unmutes the player. '1' mutes the player, '0' unmutes it. |
autoplay | String | '1' or '0' | Controls autoplay. '1' enables autoplay, '0' disables it. |
loop | String | '1' or '0' | Enables or disables loop mode. '1' enables looping, '0' disables it. |
playRates | String | Comma-separated values (e.g., "0.5,1,2,3") | Sets available playback speed options. Minimum value: 0.5, Maximum value: 4. |
Usage
These parameters are appended to the playback_url in the format key=value. Multiple parameters can be included by separating them with an ampersand (&).
Example Usage
https://app.tpstreams.com/embed/dcek2m/BxDe5ZYDyD6/?access_token=72186a33-107a-49b6-b275-a853c907be33&muted=1&autoplay=1&loop=1&playRates=0.5,1,2,3
Detailed Description
background: Controls whether the player operates in background mode, useful for scenarios where the video should continue playing in the background.muted: Sets whether the video should start muted. If set to'1', the video will begin without sound, which is especially useful in autoplay scenarios.autoplay: Determines whether the video will start playing as soon as the player is ready. Setting this to'1'enables autoplay.loop: Defines whether the video will automatically restart from the beginning after it finishes. A value of'1'enables looping.
Sample format
<div style="padding-top:56.25%;position:relative;"><iframe src="https://app.tpstreams.com/embed/{{asset_id}}/?access_token={{access_token}}&autoplay=1" style="border:0;max-width:100%;position:absolute;top:0;left:0;height:100%;width:100%;" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope picture-in-picture" allowfullscreen="" frameborder="0"></iframe></div>
Embed on your site
Now you use constructed iframe code in your code to embed the video.
Example
Live Editor
Result
Loading...