AV Insights

  MediaPlayer mediaPlayer = new MediaPlayer();
  echo.setMediaPlayer(mediaPlayer);
  echo.setPlayerName('MyMediaPlayer');
  echo.setPlayerVersion('0.1.0');
  echo.setPlayerVolume(30);
  

  mediaPlayer: MediaPlayer = MediaPlayer()
  echo.setMediaPlayer(mediaPlayer)
  echo.setPlayerName("MyMediaPlayer")
  echo.setPlayerVersion("0.1.0")
  echo.setPlayerVolume(30)
  

  Media myPieceOfMedia = new Media(
        MediaAvType.VIDEO,
        MediaConsumptionMode.LIVE);
  // Set the media producer
  myPieceOfMedia.setProducer(Producer.BBC_THREE);

  // Set at least one of the required ids
  myPieceOfMedia.setVersionId("some_valid_versionId");
  myPieceOfMedia.setServiceId("some_valid_serviceId");
  myPieceOfMedia.setEpisodeId("some_valid_episodeId");
  myPieceOfMedia.setClipId("some_valid_clipId");

  // only use setVpid if you do not know an explicit version or service Id
  // eg an SMP playlistObject.item.vpid
  myPieceOfMedia.setVpId("some_valid_vpId");

  // set length (in ms) if you know it
  // you do not need to set length for 'live' media
  myPieceOfMedia.setLength(3600000);

  // set media language if you know it
  myPieceOfMedia.setLanguage("en-gb");
  

  media = Media(avType: .video, consumptionMode: .onDemand)

  // Set the media producer
  media.producer = .BBCThree

  // Set at least one of the required ids
  media.versionID = "some_valid_versionId"
  media.serviceId = "some_valid_serviceId"
  media.episodeId = "some_valid_episodeId"
  media.clipId = "some_valid_clipId"

  // only use setVpid if you do not know an explicit version or service Id
  // eg an SMP playlistObject.item.vpid
  media.vpId = "some_valid_vpId"

  // set length (in ms) if you know it
  // you do not need to set length for 'live' media
  media.length = 3600000

  // set media language if you know it
  media.language = "en-gb"
  

  echo.setMedia(myPieceOfMedia);
  /**
    * When you know the media length you should call the appropriate Echo Client method.
    *
    * Any changes made to a media object after it has been passed to
    * setMedia will be ignored.
  */
  // you do not need to set the length for 'live' media
  // the length value will default to 0
  // you can also set it to 0 if desired
  echo.setMediaLength(50000);
  

  echo.setMedia(myPieceOfMedia)
  /**
    * When you know the media length you should call the appropriate Echo Client method.
    *
    * Any changes made to a media object after it has been passed to
    * setMedia will be ignored.
  */
  // you do not need to set the length for 'live' media
  // the length value will default to 0
  // you can also set it to 0 if desired
  echo.setMediaLength(50000)
  

  // Start playing the media
  echo.avPlayEvent(0);

  HashMap<String, String> pauseProps = new HashMap<String, String>();
  pauseProps.put("lablab", "custard");

  // Pause (passing an optional custom property for this event)
  echo.avPauseEvent(5000, pauseProps);

  // Start playing again
  echo.avPlayEvent(5000);

  // Starts to buffer
  echo.avBufferEvent(5100);

  // Resumes again
  echo.avPlayEvent(5100);

  /**
    * avSeekEvent, avRewindEvent and avFastForwardEvent will put Echo
    * into a paused state. You must call avPlayEvent in order to
    * resume playback.
  */

  // Seek (position represents position prior to seek)
  echo.avSeekEvent(2000);
  echo.avPlayEvent(2000);

  // Rewind (position represents position prior to rewind)
  echo.avRewindEvent(10000, 4);
  echo.avPlayEvent(5000);

  // Fastforward (position represents position prior to fast-forward)
  echo.avFastForwardEvent(6000, 2);
  echo.avPlayEvent(10000);

  /**
    * Call avEndEvent when the current media item can longer be resumed.
    * Once this event is called you will not be able to call
    * any other av events eg avPlayEvent against the current media
    * item.
  */
  echo.avEndEvent(10000);
  

  // Start playing the media
  echo.avPlayEvent(at: 0, eventLabels: nil]

  // Pause
  echo.avPauseEvent(at: 5000, eventLabels: nil)

  // Start playing again
  echo.avPlayEvent(at: 5000, eventLabels: nil)

  // Starts to buffer
  echo.avBufferEvent(at: 5100, eventLabels: nil)

  // Resumes again
  echo.avPlayEvent(at: 5100, eventLabels: nil)

  /**
    * avSeekEvent, avRewindEvent and avFastForwardEvent will put Echo
    * into a paused state. You must call avPlayEvent in order to
    * resume playback.
  */

  // Seek (position represents position prior to seek)
  echo.avSeekEvent(at: 5000, eventLabels: nil)
  echo.avPlayEvent(at: 2000, eventLabels: nil)

  // Rewind (position represents position prior to rewind)
  echo.avRewindEvent(at: 10000, rate: 1, eventLabels: nil)
  echo.avPlayEvent(at: 5000, eventLabels: nil)

  // Fastforward (position represents position prior to fast-forward)
  echo.avFastForwardEvent(at: 6000, rate: 1, eventLabels: nil)
  echo.avPlayEvent(at: 10000, eventLabels: nil)

  /**
    * Call avEndEvent when the current media item can longer be resumed.
    * Once this event is called you will not be able to call
    * any other av events eg avPlayEvent against the current media
    * item.
  */
  echo.avEndEvent(at: 10000, eventLabels: nil)
  

  import uk.co.bbc.echo.interfaces.PlayerDelegate;
  import uk.co.bbc.echo.EchoConfigKeys;

  public class MediaDelegate implements PlayerDelegate {

   private long position;
   private long timestamp;

   private void updatePosition() {
     //....Implement update behaviour
   }

   private void updateTimestamp() {
     //....Implement update behaviour
   }

   public long getPosition() {
    this.updatePosition();

    // Return position of
    return this.position;
   }

   public long getTimestamp() {
    this.updateTimestamp();

    // Return epoch timestamp
      return timestamp;
   }
  }

  // In your app
  public class TestShellApplication extends Application {

   private MediaDelegate mediaDelegate;

   public long initApplication() {

   HashMap<String, String> config = new HashMap<String, String>();
   config.put(EchoConfigKeys.USE_ESS, true);

   mediaDelegate = new MediaDelegate();

   EchoClient echo = new EchoClient(
                "MyApp",                    // App Name
                ApplicationType.MOBILE_APP, // App type
                "echo.android.test",        // App Countername
                getApplicationContext(),    // The Android Context of your Application
                config,                     // config options HashMap
                bbcUser,                    // BBCUser instance
                this                        // Application instance of your Application
   );

   // Android also requires these player attributes to be set
   echo.setPlayerName("Some Player");
   echo.setPlayerVersion("1.0.1");
   echo.setPlayerSize(400, 600);

   echo.setPlayerDelegate(mediaDelegate);
   }
  }
  

  import Echo

  class MediaDelegate: PlayerDelegate {

   var position: UInt64?
   var timestamp: TimeInterval?

   func updatePosition() {
     //....Implement update behaviour
   }

   func updateTimestamp() {
     //....Implement update behaviour
   }

   func getPosition() -> UInt64 {
    updatePosition()

    return this.position
   }

   func getTimestamp() -> TimeInterval {
     this.updateTimestamp()

     return timestamp
    }
   }

   // In your app
   func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplicationLaunchOptionsKey: Any]?) -> Bool {

   //Echo Config
   var config:Dictionary<EchoConfigKey, String> = [
     .echoTrace: "echo_demo_ios",
     // other config values here
   ]

   // BBCUser
   user = BBCUser(signedIn: true,
            hashedID: hashedId,
            tokenRefreshTimestamp: Date(timeIntervalSince1970: 1510156737)
    )

    mediaDelegate = MediaDelegate()

    // Initialise Echo
    do {
      echo = try EchoClient(appName: "EchoDemoApp",
                                  appType: .mobileApp,
                                  startCounterName: "bbc.start.page",
                                  config: config,
                                  bbcUser: user)
    } catch {
       // Handle Echo config error
    }

    // Set player attributes
    echo.setPlayerName("Some Player")
    echo.setPlayerVersion("1.0.1")
    echo.setPlayerSize(400, 600)

    echo.setPlayerDelegate(playerDelegate: mediaDelegate)

    return true
  }
  

  echo.setPlayerWindowState(WindowState.FULL)
  

  echo.setPlayerWindowState(.full)
  

  HashMap<String, String> props = new HashMap<>();
  props.put("custom_property", "ad information");

  // Media play initiated
  echo.avPlayInitiatedEvent(0, null);

  // Pre-roll content
  echo.avAdStart(0, props);

  // Ad is clicked
  echo.avAdClick(0, props);

  // Main feature begins playing
  echo.avPlayEvent(0, null);

  // Mid-roll
  echo.avAdStart(900000, props);

  // Ad is skipped
  echo.avAdSkip(900000, props);

  // Main feature resumes
  echo.avPlayEvent(900000, null);

  // Post-roll (completes without click or skip)
  echo.avAdStart(1800000, props);

  // Player unloads
  echo.avEndEvent(1800000, null);
  

  // Media play initiated
  let props = ["custom_property": "ad information"]

  echo.avPlayInitiatedEvent(at: 0, eventLabels: nil)

  // Pre-roll content
  echo.avAdStart(at: 0, eventLabels: props)

  // Ad is clicked
  echo.avAdClick(at: 0, eventLabels: props)

  // Main feature begins playing
  echo.avPlayEvent(at: 0, eventLabels: nil)

  // Mid-roll
  echo.avAdStart(at: 900000, eventLabels: props)

  // Ad is skipped
  echo.avAdSkip(at: 900000, eventLabels: props)

  // Main feature resumes
  echo.avPlayEvent(at: 900000, eventLabels: nil)

  // Post-roll (completes without click or skip)
  echo.avAdStart(at: 1800000, eventLabels: props)

  // Player unloads
  echo.avEndEvent(at: 1800000, eventLabels: nil)