Player API

What event is fired when a video is played?
EDITION: Enterprise, Express 499, Pro / CATEGORY: Player API / PRODUCT: Video Cloud

The event fired when a Video begins is "mediaBegin" (constant in Player API SWC is MediaEvent.BEGIN, constant in JavaScript API is BCMediaEvent.BEGIN),

This is dispatched when the media begins playing the first time, post buffer. This is the equivalent to the old "streamStart" and should be used for any tracking purposes. It will only be dispatched once for a media object, so not on replay (unless the media is loaded a second time after another piece of media is played in between).

A stream means the start of the delivery of a media file as initiated by an end user or by an auto play feature of a Brightcove player where the transfer of the media file is through streaming delivery, progressive download delivery or any other format supported by Brightcove. A stream can be all or a fraction of a single media file and there may be multiple Streams in an end user's session. If the same media file, or portion thereof, is re-viewed by and end user in a single session or in a multiple session, each view counts as a separate stream. Bumpers and ads do not count as streams.

permalink

Player API Media Events

How do I load my player with the volume muted?
EDITION: All / CATEGORY: Player API / PRODUCT: Video Cloud

You can use the Brightcove Player API's to load your Player with the volume muted. We have a great forum post on this here: 
 
Controlling Player Volume with the Player APIs

This article walks you through the steps needed and has the example code.

permalink

Controlling Player Volume with the Player APIs

How can I choose which related videos show up in my player?
EDITION: All / CATEGORY: Player API / PRODUCT: Video Cloud

The "Related Videos" feature uses the following logic to populate videos for your account: 

  1. Display name 
  2. Tags 
  3. Custom fields 
  4. Short description 

The order above describes the importance given to the various fields for the purpose of finding similar videos. In other words, videos that have the same display name will rank higher than videos that don't but have same tags, and so on and so forth. If no videos match, the related videos are ordered by the date they were added to your account.

If no videos match the values, other videos from the account will be displayed in an indeterminate order.

It is not possible to select which videos display in the player's "Related Videos" End Screen from within the Brightcove Video Cloud, but a developer can control what displays at runtime by creating a custom solution using the Brightcove Player API.

The MenuModule of the Player API offers a way to be informed when these videos are to be requested and populated within the menu screen, through a callback function passed to the player. A developer can choose to replace or append lists of videos to those shown in the menu screen when this callback is invoked.

For more specific information and samples, please read our article on Customizing the Menu's Additional Media

permalink

Player API Overview
Customizing the Menu's Additional Media