Posts Tagged ‘Preview Image’

Video Renditions in SharePoint 2013

October 19, 2012 Leave a comment

During my explorations of new web content management and publishing features in SharePoint 2013 through the guidance published here, I came upon the idea of image renditions. I tried them out in different ways and posted some findings here on their workings. One thing I did not find any mention of in the article is of renditions applicable to videos. I chanced on video renditions as I was experimenting with uploading and embedding video in SharePoint 2013 which I talk about here. Although I initially wondered why, trying the feature out showed me that renditions as applicable to video are a different concept than Image Renditions. Here’s a quick comparison.

Image Renditions Video Renditions

Asset and Rendition are separate
There is one image that any of a set of predefined renditions available to all images in the site can be applied upon or even customized.

Each rendition is a new asset
If a given video file will need to be played back in different modes, formats, dimensions or bitrates, a new video file meeting those criteria needs to be created and uploaded.

Defined for each instance of embedded image
Content authors or designers can use renditions provided with SharePoint 2013 or add their own. They can define the various ways in which a given image can be displayed in several different locations on the site using different renditions.

One default picked for a video
One of the available renditions of the video can be picked as the default for display on any page where it is embedded. Different renditions cannot be placed on different pages.

Viewers get to see, not change renditions
Content consumers can see the effect of the rendition applied to the image but cannot change them or apply other renditions to a given instance of an image.

Viewers get to apply desired rendition
The default rendition is what is loaded with the page each time but the consumer of the page can select another rendition to apply.

To illustrate the above, let’s take a quick look at how we can do renditions of video. First, I go to my asset library where I keep videos for my site, pick the video I want and open the actions popup (click the ellipsis). When there, since what I want to do right now is not play or download the video, I can bring up a menu of additional actions by clicking on the ellipsis again [for the uninitiated, the ellipsis is the 3 dots you see on the tile indicating that "there’s more"]. I chose to "Edit Properties".


On the "Edit Properties" page, you get a little section that speaks about "This video’s renditions" – it is typically collapsed. When I expanded it, here’s what I saw.


Clicking on "Manage Renditions" takes you to the following slightly weird page with text flowing off the screen and flush to the right edge of the browser (but it works). As you can see here, in order to create alternate renditions of this video, you will actually have to upload other video(s).


I clicked on "Upload Video Rendition" and saw the following dialog; nothing fancy here, just pick a video file and upload. I uploaded a low bitrate version of the video I already had, that is more suited for playback on small form factor mobile devices.


When I click "OK", I am presented with a dialog where I can put in some metadata relating to the video file I uploaded. Note that I did NOT type in the "183 KB/sec" value in the Label field. That is something that SharePoint inferred based on the properties of the video. There are certain other properties that are not even presented on this dialog such as bit rate, frame width and height. You see these in the rendition listing above. Obviously, these are also auto-captured from the video asset uploaded.


Once I clicked on "Save" here, the video is uploaded to SharePoint. After upload, I now see there are two renditions available each with a different bitrate and frame size. The little green star (I like this a lot better than the word "New" that used to hang on a new item) shows the new video file that was added and as you can see, its metadata properties were correctly inferred.


As you can see above, you can also pick which rendition of a video is the default when you put it on a page. Notice how this setting is "global" for a given video? If you select the rendition that is default here, that is the rendition that will apply to the video on any page where it is embedded when the page loads. You cannot choose to do a different rendition on each page. The content consumers do have the opportunity to choose a different rendition to play back but it will always load with the default specified here. This is different from how image renditions work.

I left the default selection (to use the lowest bitrate available) for the default video rendition and clicked on "Save". This took me back to the "Edit Properties" page for the video.


As you can see under "This video’s renditions", the default rendition is now the low-res version. Since I did not change any of the actual video properties, I reckoned it shouldn’t matter if I hit "Save" or "Cancel" on this page but I hit "Cancel" just to check if it caused any kooky rollback of changes made to renditions. It did not – so everything’s good here. Oh, by the way, notice the new icon in the controls section of the play that looks like the signal bars on your cellphone? That is what indicates that there are multiple renditions of this video available. The same icon can be used to switch renditions.

Next stop, the page on which I had embedded this video. This is where I was disappointed. Just loading the page did not show the presence of the renditions available on the page. I cleared the browser cache and reloaded the page. That didn’t work either. Next, I recycled the app pool on the server to see if that would help but had no luck. I then went to the last resort which was to check out and edit the page, update the video and publish. When I edited the page, it worked. The renditions now showed up and worked. I republished the page and had everything going. The problem though, is that the change to the asset didn’t work directly on the page using it. The page had to be republished.

This behavior is in pattern with a similar observation I made relating to the Preview image that I documented in my notes from playing with video embedding. In general the behavior I am consistently noticing is that if you make changes to the properties of a video asset that you embedded on a publishing page in SharePoint, the change doesn’t reflect on an instance of that asset that you placed on a publishing page unless the page is edited and republished. This is rather inconvenient – so I am hoping this is something that is either only happening to me or is a bug in SharePoint 2013 Preview that will be fixed by release.


Another observation here is that the preview image I saw was for the high-res version. Clicking on the renditions icons showed me that the current rendition being applied is the low-res version but that is not the impression you get from seeing the preview image. You have to remember that you don’t get to associate a preview image with each rendition file that you upload for an asset. There is one image that is associated to the asset as a whole – one that was either auto-generated during asset upload or one that we change and apply to the asset.

There is a way to work around this last problem, though. After you have placed the video on the page, you can specify, through the ribbon, the preview image that you would like to apply to it. To do this, you would have to have already gone and taken a key frame shot from your video in the default rendition and stored it. You can also adjust the Horizontal and Vertical sizes through the ribbon to avoid too much of the black offsets. A little more work but hey, you can get it done.


Now once you’ve done all that and published the page, the switching of the renditions is pretty smooth. You can switch renditions even as you are playing back and the video would switch to the other bitrate or format specified in flight. This rendition selection is available to all users that are able to view the video on the page although they cannot change the default rendition. There you are – video renditions in SharePoint 2013.

%d bloggers like this: