Embedding Parameters
Parameters let you customize the functionality and behavior of your embeddings.
You can embed Ziggeo via both HTML and JavaScript, and all parameters can be used both ways.
The timelimit parameter, for instance, allows you to limit the recording time folks have.
Via HTML, you need to prefix all parameters with *ziggeo-:
<ziggeorecorder ziggeo-timelimit="10">
</ziggeorecorder>
Via JavaScript, you use the parameters without any prefix:
new ZiggeoApi.V2.Player({
...,
attrs: {
timelimit: 10
}
});
For more information on the different methods of embedding Ziggeo, read more here.
List of parameters
Here is the full list of parameters.
- Presentational parameters 54/54
All of the parameters that affect the presentation of your embeddings
These parameters might change how something is handled however they are first and foremost going to change the presentational aspect of your embedding.
- aspectratio [ float ]
Define aspect ratio of container The aspect ratio will be used when only width or only height is defined. - maxheight [ int ]
Maximum height of the embedding (in pixels) - maxwidth [ int ]
Maximum width of the embedding (in pixels) - minheight [ int ]
Default current: 240 Minimum height of the embedding (in pixels) - minwidth [ int ]
Default current: 320 Minimum width of the embedding (in pixels) - posterfitstrategy [ string ]
Default current: crop Define how poster image should fit inside container- crop Crop the sides of poster image so that it fits inside container with different aspect ratio
- pad Pad the sides of poster image so that it fits iniside container with different aspect ratio
- original Keep original resolution of poster image, do not upscale or downscale to fit container. It can be cropped or padded depending on the size
- sticky [ bool ]
Stick video to the screen when it scrolls out of view The sticky video can be moved around by the user so it doesn't block content from the page. - videofitstrategy [ string ]
Default current: pad Define how video should fit inside container- crop Crop the sides of the video so that it fits inside container with different aspect ratio
- pad Pad the sides of the video so that it fits inside container with different aspect ratio
- original Keep original resolution of the video, do not upscale or downscale to fit container. It can be cropped or padded depending on the size
- audio-transcription-as-subtitles [ bool ]
Default current: false Show audio transcription as subtitles (if available) - autorecord [ bool ]
Default current: false (try to) start the recording as soon as the embedding is shown Start recording automatically as the embedding shows or as soon as camera access is granted - countdown [ int ]
Default current: 3 Countdown before recording starts (default is 3 seconds, 0 to disable) Set countdown before actual recording starts. As such, once 'record' is hit, countdown will start -- and then actual recording begins once countdown reaches zero. Allows time for individuals to get ready for actual recording. - display-timer [ bool ]
Default current: true Show timer to user Remove any distractions by hiding the recording time. And get insight into recording time without limits. - early-rerecord [ bool ]
Default current: false Early re-recording Let individuals cancel any uploading or processing of recordings so re-recording can begin immediately. - faceoutline [ bool ]
Default current: false Shows outline of face in recorder Indicate placement of face in recorder by adding face outline; it appears during recording only and not in final video. - flip-camera [ bool ]
Default current: false Flip camera horizontally This enables a mirrored screen which allows for natural orientation during recording. Note: videos are saved in original orientation for easy review. - flipscreen [ bool ]
Default current: false Toggle screen flipping when you are doing a screen-recording - gallerysnapshots [ int ]
Default current: 3 Maximum number of snapshots shown This is the maximum number of snapshots to be shown after recording on the single page. This determines if there will be multiple pages of snapshots shown, or only a single one. - height [ int ]
Default current: 480 Height of embedding This is the height of the embedding itself. It will not impact the recording resolution. Use true number or number with % for variable width. Please do not add any other text behind the number (px or alike). - hidebarafter [ int ]
Default current: 5000 Inactivity period in milliseconds Tells the embedding how long to wait before hiding the controls - hideoninactivity [ bool ]
Default current: true Hide controls on inactivity Hides the controls of the embedding if the activity was not present for a specific amount of time. This includes the activity from mouse as well as keyboard. - hidevolumebar [ bool ]
Default current: false Hides volume bar - localplayback [ bool ]
Default current: false Show the preview of the video after recording the same Allows you to show the preview while the video is being uploaded in the background (WebRTC only) - multistreamdraggable [ bool ]
Default current: true Allow dragging of stream-in-stream - multistreamresizeable [ bool ]
Default current: false Allow resizing of stream-in-stream - multistreamreversable [ bool ]
Default current: true Allow reversability of stream-in-stream - nofullscreen [ bool ]
Default current: false Disable fullscreen capabilities in video player - picksnapshots [ bool ]
Default current: true Allow selection of snapshots Let user pick covershots. Disabling this option will make the system automatically selects cover shot. - pickcovershotframe [ bool ]
Default current: false Allow user to pick any frame as covershot Let user pick any frame from video to use as covershot, as opposed to selecting from snapshots gallery. - popup [ bool ]
Default current: false Player pops up after clicking play - popup-height [ int ]
Default current: auto Height of popup - popup-stretch [ bool ]
Default current: false Allow the popup player to stretch and fill out the full width of the area that it has been given. - popup-width [ int ]
Default current: auto Width of popup - poster [ string ]
Link to image that should be used as poster The image that is pointed to will be shown with the play icon when embedding loads and before the video is played. This will usually be using image from our server, however you can override it using this parameter and show your own - primaryrecord [ bool ]
Default current: true Make recording primary option - showduration [ bool ]
Default current: false Shows duration of the video before the playback starts Instead of waiting for video to start, your video duration is shown on the image itself - showsettings [ bool ]
Default current: true Allow user to change player settings, like playback speed - skipinitial [ bool ]
Default current: false Disable initial screen of recorder Want to enable camera preview immediately so video recording can begin? Note: permission for camera access may still be required. - skipinitialonrerecord [ bool ]
Default current: false Disable initial screen of recorder when re-recording Want to enable camera preview immediately so video recording can begin? Note: permission for camera access may still be required. - skipseconds [ int ]
Default current: 5 Keyboard left / right key shortcut to seek video This parameter allows you to set up how many seconds you want to use for the keyboard left and keyboard right keys to skip the video. This operates like seek(current playback time + time you set to skip). - snapshotmax [ int ]
Default current: 15 Maximum number of snapshots of the recorded video to be collected - stream-height [ int ]
Default current: 480 Specify optimal stream video height for player (optional) - stream-width [ int ]
Default current: 640 Specify optimal stream video width for player (optional) - stretch [ bool ]
Default current: false Allow the player to stretch and fill out the full width of the area that it has been given. Great option for mobile responsiveness as it will resize itself to match the size of the element that it is embedded into. It may cause your video to seem cut off if the size of the embedding does not match the resolution of the video - theme [ string ]
Default current: default Sets the theme of player and recorder V2 embeddings can be styled manually and with a theme. Themes allow you to quickly switch between various styles with a single parameter value. Follow next link to see all video player and recorder themes - themecolor [ string ]
Sets the theme color of player and recorder Currently includes red, green and blue. - visualeffectvisible [ bool ]
Default current: true Sets the visual effects on or off - fullscreenmandatory [ bool ]
Default current: false Allow fullscreen on devices where custom controls are not supported - picksnapshotmandatory [ bool ]
Default current: false User has to pick snapshot - width [ int ]
Default current: 640 Width of embedding This is the width of the embedding itself. It will not impact the recording resolution. Use true number or number with % for variable width. Please do not add any other text behind the number (px or alike).
- Media Management parameters 28/28
All of the parameters that help you manage what happens with your media
The following parameters will help you change or get certain workflows to happen. They will offer you ways to manage what is to happen to media that you or your visitors/customers/clients can see.
Just the same they offer you ways for something to happen behind the scenes.
- audiobitrate [ int ]
Default current: auto Overwrite the audio bitrate in kbs - auto-crop [ bool ]
Default current: false Automatically crop videos When set on recorder, videos will be automatically cropped as needed. As such, top and bottom could be cut off if too large; same with width. Depends on video resolution. - auto-pad [ bool ]
Default current: false Automatically pad videos When set on recorder, videos will be automatically padded on the top and bottom and/or left and right. This will make your recorder auto pad the videos on top and bottom or left and right. As such, instead of cutting video, padding will be added to fill out required parts. - custom-covershots [ bool ]
Default current: false Allow user to upload any image to use as covershot For the best look of your custom snapshots it is best that the image chosen is either the same resolution as your recording or higher. picksnapshots must be true (it already is by default) to be able to use this parameter. - effect-profile [ array ]
If applied to recorder, specifies all effect profiles that should be applied; if applied to player, specifies the prefered effect profile Different effects may be applied — streams are created with each effect profile indicated in recorder embedding. When particular effects are specified in the video player, such effects are played. (assuming effect was set during recording — if no such effect was originally set, it would not be available afterwards). - default-fallback [ bool ]
Default current: false - enforce-duration [ bool ]
Default current: false Reject videos that are too long instead of auto-cropping them Rather than cropping video to fit desired time frame (the default state), videos will be rejected. - framerate [ int ]
Default current: 25 Set the number of frames that should be captured in a single second. 24 frames is least to have fluid movement. Lower framerate will result in strange movement. Above 30 needs to be supported by camera to actually make a difference in video, however higher numbers will always result in larger video sizes. - key [ string ]
Associate key with newly created video It is added to recorder to set which key should the video be saved under. - maxuploadingheight [ int ]
Default current: auto Maximal allowed height of uploaded video - maxuploadingwidth [ int ]
Default current: auto Maximal allowed width of uploaded video - meta-profile [ string ]
Specify key or token for meta profile (optional) Meta profile lets you specify which meta actions (like audio transcription / visual analysis) should be taken once video is recorded - microphone-volume [ float ]
Default current: 1 Microphone volume gain - minuploadingheight [ int ]
Default current: auto Minimal allowed height of uploaded video - minuploadingwidth [ int ]
Default current: auto Minimal allowed width of uploaded video - noaudio [ bool ]
Default current: false Disable recording any sound By setting this parameter, only video data will be recorded -- all audio will be removed. - preview-effect-profile [ string ]
If applied to recorder, it specifies the effect profile that should be played back in preview after recording - recordingheight [ int ]
Default current: auto Resolution height of the recording This is the resolution of the recording itself. Lower resolutions mean faster uploads. Recommended: set to maximum recording resolution indicated in your Video Profiles set up (e.g. HD Video Profiles set to HD). - recordingwidth [ int ]
Default current: auto Resolution width of the recording This is the resolution of the recording itself. Lower resolutions mean faster uploads. Recommended: set to maximum recording resolution indicated in your Video Profiles set up (e.g. HD Video Profiles set to HD). - selectfirstcovershotonskip [ bool ]
Default current: false Automated covershot creation when skip is clicked. When the gallery of snapshots is shown and the person that had recorded the video clicks on skip button and this option is set as true, it will cause the very first frame to be used as cover image. - source [ string ]
URL to your own media that you want to show This option allows you to specify your own location of the videos and then have them played back from the same location. For best experience we still recommend using videos from your Ziggeo storage, however with this option it is completely up to you. - stream [ string ]
Stream token or key Useful for video player only. Lets you specify the exact stream to run in your player -- or a particular video effect. - timelimit [ int ]
Default current: 0 Maximum video length Limits duration of video to ensure videos are recorded within specific timeframe (and not over). Limit is specified in seconds. - timeminlimit [ int ]
Default current: 0 Minimum video length If video length should be at least some minimum amount of time, use this parameter. The value presented refers to number of seconds the video should last. - transcript-language [ string ]
Default current: en-US Select language for audio transcription. By default the audio transcription is done for English language only. Use 'auto' for auto-detection of language instead. This rquires meta profile to be set up and applied for it to be considered. - video [ string ]
Video token or key When adding a token, add it as is. When adding a key, add an underscore ( _ ) in front of it first (even if your key starts with one), e.g. if your key is 'my_key' -- add it as '_my_key' when adding it to video attribute. - video-profile [ string ]
Specify key or token for video profile (optional) Video profiles specify your own SD or HD resolution -- and ensure transcodings are prepared with the indicated resolution. If you are specifying a key, add an underscore before its name in this parameter, otherwise if it is token, add it as it is. Purpose: in recorder it tells our servers which profile to apply to recorded video -- and in player it indicates which profile to use for playback. - videobitrate [ int ]
Default current: auto Overwrite the automatic video bitrate in kbs
- Operational parameters 73/73
The list of parameters shown will allow you to modify how your embedding works or behaves
It is always fun changing how things work. Especially if you can do it easily and have it happen in style. All of the parameters here allow you to do just that.
It might be something as simple as showing multiple videos in a list. It could also be something complex, yet so easy to set up as screen recording combined with your camera.
- addstreamminheight [ int ]
Default current: 95 Specify the minimal height of the additional stream embedding This must be a number. Note: Do not add 'px' or other text behind number. - addstreamminwidth [ int ]
Default current: 120 Specify the minimal width of the additional stream embedding This must be a number. Note: Do not add 'px' or other text behind number. - addstreampositionheight [ int ]
Default current: 95 Specify the width of the additional stream embedding This must be a number. Note: Do not add 'px' or other text behind number. - addstreampositionwidth [ int ]
Default current: 120 Specify the width of the additional stream embedding This must be a number. Note: Do not add 'px' or other text behind number. - addstreampositionx [ int ]
Default current: 5 Specify the position where the additional stream should be embedded at on the x-axis This must be a number. Note: Do not add 'px' or other text behind number. - addstreampositiony [ int ]
Default current: 5 Specify the position where the additional stream should be embedded at on the y-axis This must be a number. Note: Do not add 'px' or other text behind number. - addstreamproportional [ bool ]
Default current: true Add stream-in-stream with proportional aspect-ratio - airplay [ bool ]
Default current: false Allow Airplay - allowcancel [ bool ]
Default current: false Allows user to cancel the upload of a video - allowcustomupload [ bool ]
Default current: true Allow uploading of any files This allows you to use your embedding to upload any type of file, even if it is not recognized as video. - allowedextensions [ array ]
Permitted video file extensions that users can upload (optional) - allowmultistreams [ bool ]
Default current: false Allow the user to include multiple streams in one video, e.g. screen recording and camera - allowpip [ bool ]
Default current: false Allow user to activate picture-in-picture playback - allowrecord [ bool ]
Default current: true Allow recording to be made with your customer's web cam through the embedding - allowscreen [ bool ]
Default current: false Allow screen recording instead of via camera (experimental, Firefox, Chrome and Opera only) - allowtexttrackupload [ bool ]
Default current: false Allow users to upload subtitles - allowtrim [ bool ]
Default current: false Allow user to trim the video after recording Allow user to trim time from the start and/or end of video after recording. Trimming will be skipped if the video format is not supported by the browser. - allowupload [ bool ]
Default current: true Allow uploading of custom user videos through your embedding If by some chance your customers do not have web cam, you can always let them slide by giving them the option to upload some existing video instead. - application [ string ]
Overwrite default application token Lets you use one general application token on your page as well as another token for this specific embedding. - audio [ string ]
Audio token or key You can either specify the token or a key that represents your audio media. Please remember to add underscore if you are using keys before the key name. - audio-test-mandatory [ bool ]
Default current: false Test microphone before recording - autoplay [ bool ]
Default current: false Automatically start video playback Starts video playback as soon as player loads -- it’s the ideal option for making videos play once page loads or after the embedding has been created - camerafacefront [ bool ]
Default current: false Should the front face camera be used This option allows you to set up the embedding to use front facing camera - chromecast [ bool ]
Default current: false Allow Chromecast - createthumbnails [ bool ]
Default current: false Creates thumbnails of recorded/uploaded video - delete-old-streams [ bool ]
Delete old streams after re-recording - disablepause [ bool ]
Default current: false Disables pausing in the player - disableseeking [ bool ]
Default current: false Disables seeking in the player - filesizelimit [ int ]
Limit size of uploaded videos (in bytes -- no limit by default) 0 sets it to no limit, while any number will represent bytes at which time you want to forbid the size. 1 MB = 1024 * 1024 bytes, so a limit of 20MB would be 20*1024*1024 = 20,971,520, which would be written as 20971520. - flashincognitosupport [ bool ]
Default current: false Allow access to camera in incognito / private sessions Useful when embedding is opened within Incognito or Private windows - when otherwise the camera would not be able to record. - force-overwrite [ bool ]
Default current: true Overwrite videos with existing keys If the video with same key already exist, you can still overwrite it by specifying this parameter. It allows you to avoid accidental overwrites and have a better control of what happens with your videos. - forceflash [ bool ]
Default current: false Forces flash to be used for recording and playback Even if your headers are set to use WebRTC the embedding with this parameter will ignore it and use flash instead. - forcerefresh [ bool ]
Default current: false - framerate-warning [ bool ]
Default current: false Show a performance warning when framerate is under this threshold. - initialseek [ float ]
Default current: 0 Initially seek to a position in the video - lazy-application [ bool ]
Allow an application to be defined after the embeddings are initialized - loop [ bool ]
Default current: false Loop video playback indefinitely Setting this parameter will cause your player to loop the video (video starts once it finishes) for infinite loop. - loopall [ bool ]
Default current: false Loop video playlist indefinitely Setting this parameter will cause your player to loop the playlist. - manual-upload [ bool ]
Default current: false Trigger the uploading of a selected video file manually This will cause your embedding to allow file to be selected, however it will not start the upload itself. To start the upload, call the `embedding.upload();` method (see Callable Methods for more). - manualsubmit [ bool ]
Default current: false User manual submission Provide the user an option to confirm the submission of their video by clicking a button. - noflash [ bool ]
Default current: false Force embedding not to use flash Makes the embedding show error if it can not use anything other than flash and it is set to use WebRTC. - onlyaudio [ bool ]
Default current: false Only record audio, no video. - orientation [ string ]
Default current: auto Force particular device orientation on mobile ('portrait' or 'landscape')- portrait When video height is bigger than video width
- landscape When video width is bigger than video height
- outsource-selectors [ string ]
Add possibility to move camera and mic selection outside of recorder- cam-* Set the camera selector id, div for radio option, select element for selection
- mic-* Set the microphone selector id, div for radio option, select element for selection
- [type=] 'select'/'radio'; For camera/mic selection; default 'select' element
- [showCapabilities=] true/false; If browser supports (Chrome do) show camera capabilities; default: true
- [disabled=] true/false; If there is only one option for selection will be set disabled.; default: true
- [className=] any string value; Class name(-s) you want to add to the selector
- cpu-friendly [ bool ]
Default current: false Will use low CPU of the computer, which could cause low quality of the video. Will use low CPU of the computer, which could cause low quality of the video. - media-orientation [ string ]
Will allow record only provided option landscape or portrait mode- landscape Camera has to be on landscape mode.
- portrait Camera has to be on portrait mode.
- pausable [ bool ]
Default current: false Allow user to pause the recording - pauseonplay [ bool ]
Default current: false Pause playback when another video is being played back - playermodeifexists [ bool ]
Default current: false Run recorder in player mode if video already exists If you provide a key or token of existing video, the recorder will become a player instead if this is set to true. - playfullscreenonmobile [ bool ]
Default current: false Automatically play fullscreen on mobile devices - playlist [ array ]
Default current: auto Allows you to create a video playlist Allows you to add multiple video tokens which are turned into playlist where one video plays after another automatically - pauseonclick [ bool ]
Default current: true Pause video when user clicks on player if the video is playing - playonclick [ bool ]
Default current: true Play video when user clicks on player if the video is paused - playwhenvisible [ bool ]
Default current: false Automatically play video once it becomes visible - visibilityfraction [ float ]
Default current: 0.8 Define when player will automatically start to play video Define in percentage, what part of the player has to be visible player start automatically start to play video - preload [ bool ]
Default current: false Preload media data Instead of loading the media such as video on click, you can start loading it as soon as page opens. This way your video playback, especially of higher resolutions or longer times begins instantly. - screenrecordmandatory [ bool ]
Default current: false Make screen recording mandatory Make screen recording mandatory for the user. - preroll [ bool ]
Default current: false Should ad be prerolled? - preventinteraction [ bool ]
Default current: false Prevent user interaction after some time in the player Shows the player, however makes it impossible for someone to click to pause or seek through. Useful in workflows or environments where you want to play the video like in video theaters, background video setups, exams and alike. - recordermode [ bool ]
Default current: true Turns the ziggeorecorder embedding into recorder Recorder can be used as re-recorder or recorder. With this parameter we set it to be recorder only. - recordings [ int ]
Default current: auto Limit number of recordings Specifies number of times someone is able to (re-)record before the video is considered as finalized. - rerecordable [ bool ]
Default current: auto Allows embedding to be used as re-recorder Sets if re-recordings can be made. This is true by default for recorders/capture embeddings and by default false for players/viewer embeddings. - rerecordableifexists [ bool ]
Default current: true Allow to re-record video if it already exists By default if you use a recorder that is set with rerecording options it will allow you to rerecord over it. If you set this parameter as false, it will not allow you to take a new video over existing one. - simulate [ bool ]
Default current: false Simulate recording experience without actually recording it Lets your community record a test video that's not saved -- or use it for custom testing while developing video recording events locally. - snapshotfrommobilecapture [ bool ]
Default current: false Let user pick a snapshot from mobile video capture - snapshotfromuploader [ bool ]
Default current: false Let user pick a snapshot from uploaded video files - trimoverlay [ bool ]
Default current: true Define if embedding should show trimming overlay or not when allowtrim is set to true. - uploadlocales [ array ]
Default current: auto Specify which locales can be uploaded This can be used to allow only specific translations to be uploaded. For example: `[{lang: 'en', label: 'English'}, {lang: 'de', label: 'Deutsch'}]` would allow English and Deutsch language files to be uploaded. - volume [ float ]
Default current: 1 You can use this to set the volume of your video when playback starts With '0' as a value you would have muted video and with '1' you would have 100% sound volume. - webrtconmobile [ bool ]
Default current: false Set WebRTC to be used on mobile device instead of native camera app Might not yet be supported on all devices however generally gives you much more control and is part of the page. - webrtcstreaming [ bool ]
Default current: false Set WebRTC Streaming on your embedding Allows you to override the setting for a specific embedding regardless of the application wide setup. - fittodimensions [ bool ]
Default current: false Fix precisely to recordingwidth and recordingheight even if not supported natively
- Data parameters 4/4
Want to save some data?
Ziggeo accepts more than just media. We know that sometimes key+words might be just the right thing you needed. All of the parameters here allow you to add your data in one format or the other.
- custom-data [ json ]
Default current: auto Custom data associated with newly created video This accepts any amount of desired data next to the video as long as the data is saved in proper JSON format. - description [ string ]
Video description (optional) Saves any notes or description related to a video. - title [ string ]
Video title (optional) This is saved next to video as its title, letting you easily obtain the value at a later time. Some themes might also use and display this for you.
- Security parameters 3/3
Various parameters that help with with AAA aspect of your app (Accounting Authorization Authentication)
Security in the online world is very important. Because of that we have prepared some parameters that help you with the same yet allow you to use them in the way you prefer or see as fit.
- client-auth [ string ]
Client-Side Authorization Token In the event your setup requires tokens to function, place the token locally generated by one of the Server Side SDKs. - expiration-days [ int ]
Default current: auto After how many days should video automatically be deleted? (disabled by default) Setting 0 indicates videos may only be deleted manually; setting it to x number of days means Ziggeo’s system will automatically delete videos after the specified number of days. - server-auth [ string ]
Default current: auto Server-Side Authorization Token In the event your setup requires tokens to function, place the token generated by one of the Server Side SDKs -- or one created manually -- here
- Form / HTML parameters 2/2
Various parameters that make it easier to work with forms and HTML
We know, sometimes you need a way to make things work in combination with the form elements on your page. Maybe you are not allowed adding JavaScript events, or you prefer not to. Regardless of the reason, we have few parameters here, yet helpful for most common scenarios.
- form-accept [ string ]
Default current: auto Only allow form submission (css selector) if video has been recorded Ziggeo will prevent the submission of the specified form as long as no video has been recorded / uploaded. - input-bind [ string ]
Bind video token to form input field by given name Once the video is recorded, the SDK will search for a form field with this name and copy the token into the field.