Adding a Custom Component to a Player Template

Custom player templates are available only for Video Cloud Pro and Enterprise customers. If you are interested in upgrading your Video Cloud account, please contact Brightcove for more information.

Once you have created a custom component that you want to include in your players, you can add it to a Video Cloud player template, using BEML. How you add a custom component to your player template depends on whether it's a visual component, which needs to be located at a specifed spot in the player layout, or a non-visual component, which doesn't need to appear in the player layout. In either case, you need to make sure that your custom component file is hosted at a URL that the Video Cloud player can reach, and that you have accounted for Flash's cross-domain security constraints.

Adding visual custom components with the SWFLoader element

To add a visual custom component to a player template, use the <SWFLoader> element. The source attribute of the <SWFLoader> refers to the URL of the custom component. The other attributes of the <SWFLoader> element specify visual attributes such as the size and location of the component within the player's layout. For example, if the URL of your custom component is http://hostname.com/player/mycomponent.swf, use a <SWFLoader> element like this:

<SWFLoader width="200" height="406" 
  x="492" y="3" 
  source="http://hostname.com/player/mycomponent.swf"
  depth="2"/>

Read more about working with SWFLoader components.

Adding non-visual custom components with the Module element

Non-visual components, (for example, a component that implements analytics tracking) can be loaded using the Module element, which is a child of the Modules element. You don't need to use the SWFLoader element for a non-visual component, since the component doesn't need to have a specific position within the player layout. The file attribute of the <Module> refers to the URL of the custom component. For example, if the URL of your custom component is http://hostname.com/player/mycomponent.swf, use a <Module> element like this:

<Modules>
  <Module file="http://hostname.com/player/mycomponent.swf"/>
</Modules>