CldVideoPlayer Configuration

Adding Video Transformations

CldVideoPlayer takes advantage of the native transformation option that is available to the native Cloudinary Video Player (opens in a new tab). To use this, we can use the same transformation prop with CldVideoPlayer.

For instance, if we wanted to crop and resize a video to a square, we could use the following transformation:

import { CldVideoPlayer } from 'next-cloudinary';
 
<CldVideoPlayer
  id="cropping-resizing"
  width="500"
  height="500"
  src="<Your Public ID>"
  transformation={{
    width: 500,
    height: 500,
    crop: 'fill',
    gravity: 'auto'
  }}
/>

This will apply a width and height of 500 as a transformation. It will set a crop mode of fill to make sure the entire video frame is filled. We finally use gravity of auto to make sure the subject of the video is tracked and not lost in frame.

Depending on the transformation, you may need to wait for the video to process if applying the transformations on-the-fly. To help avoid wait times, you could eagerly load transformations (opens in a new tab) on upload.

If you instead wanted to add a watermark to the video, you could use overlays in the transformation:

import { CldVideoPlayer } from 'next-cloudinary';
 
<CldVideoPlayer
  id="overlay"
  width="1620"
  height="1080"
  src="<Your Public ID>"
  transformation={{
    overlay: '<Your Public ID>',
    width: 150,
    gravity: "south_east",
    x: 50,
    y: 50,
    opacity: 80
  }}
/>

When you play the video, you'll notice the Space Jelly logo on the bottom right of the video!

For more information and examples of using the transformation prop, check out the Cloudinary Video Player documentation (opens in a new tab).

Configuration Examples