Report on Audio-Only Content

Source code

Find all the code associated with this sample in this GitHub repository.

Sample app

See the Pen CMS API Sample: Audio Content Report by Brightcove Learning Services (@rcrooks1969) on CodePen.

Introduction

Video Cloud allows you to use audio-only content in the form of videos with no video track. However, it doesn't flag these videos as "audio-only" in any way, so if you have a large library of mixed audio and video content, it may not be obvious how to create a report on your audio-only content.

There are properties in the renditions that will tell you if it is audio-only, but the properties are different for videos that were ingested using the legacy ingest system or using the Dynamic Delivery system:

• For legacy ingest videos, each rendition will have an audio_only property that is a boolean
• For Dynamic Delivery videos, each rendition will have a media_type property that will be set to audio or video

In the sample app here, we use a function that checks for either case:

        function isAudio(rendition) {
          if (rendition.hasOwnProperty('audio_only') && rendition.audio_only === false) {
            return false;
          } else if (rendition.hasOwnProperty('media_type') && rendition.media_type === 'video') {
            return false;
          }
          return true;
        }

Notes on this sample

• Any video in Video Cloud may have audio-only renditions. This sample identifies content that has only audio renditions, and therefore checks every rendition. It would be straightforward to modify the code to produce a report on content that has at least one audio-only rendition. This is the only change you should need to make to the sample code:

  Existing code (to find on audio-only content):

          function processRenditions(video, renditions) {
              var i,
                iMax = renditions.length,
                audioRenditions = 0;
              if (video.id === '5831706803001') {}
              // separate renditions by type
              for (i = 0; i < iMax; i++) {
                if (isAudio(renditions[i])) {
                  audioRenditions++;
                } else {
                  // if any non-audio renditions, stop
                  break;
                }
              }
              // check to see if all renditions are audio
              if (audioRenditions === renditions.length) {
                video.renditionCount = audioRenditions;
                audiosArray.push(video);
                return;
              } else {
                return;
              }
            }

  Version of the function to identify any content that has audio-only renditions:

          function processRenditions(video, renditions) {
              var i,
                iMax = renditions.length,
                audioRenditions = 0;
              if (video.id === '5831706803001') {}
              // separate renditions by type
              for (i = 0; i < iMax; i++) {
                if (isAudio(renditions[i])) {
                  audioRenditions++;
                }
              }
              // check to see if any renditions are audio
              if (audioRenditions > renditions.length) {
                video.renditionCount = audioRenditions;
                audiosArray.push(video);
                return;
              } else {
                return;
              }
            }

• Remote asset content is not checked to see if it is audio-only.