# Wowza Video Platform Integration plugin

The Wowza Video Platform Integration plugin makes it easier to include videos and live streams you've created in Wowza Video into your development chain. For example, when you use the plugin, video metadata is included instead of relying on the API to fetch the metadata.

The plugin allows configurations to be managed via the platform so non-technical team members can easily configure players and build deep integrations. The plugin also maximizes performance by reducing the number of API calls and batching requests into composite responses. Ultimately, this eliminates the need to maintain API integrations and other custom performance integrations.

info
If you intend to use platform videos with the manual JavaScript setup, you must load the Wowza Video Platform Integration plugin to get analytics data.

## Before you start

Before you can use this plugin with the standalone player, we recommend the following steps:

* Ensure you have a Wowza Video subscription. For more, see get started with a Wowza Video trial.
* Read about [embedding the core player](/docs/wowza-flowplayer/player/embed/embed-with-standalone/) in your site by adding the minimum CSS and JavaScript player components.
* Make sure you have a player token. For more, see [Token configuration](/docs/wowza-flowplayer/player/configure/#token-configuration). Tokens aren't needed for local development.
* The instructions on this page generally assume you're using the Wowza Flowplayer CDN to embed the player in your site. If you're using npm, see our [npm instructions](/docs/wowza-flowplayer/player/embed/embed-with-standalone/#use-npm) or our [TypeScript guide](/docs/wowza-flowplayer/guides/add-the-player-using-typescript/).


## Install the plugin

You can use the manual JavaScript approach to install the plugin. Include the **ovp.min.js** plugin next to the core player:


```html
<!-- Load standard player skin -->
<link rel="stylesheet" href="https://cdn.flowplayer.com/releases/native/3/stable/style/flowplayer.css">
<!-- Load player script -->
<script src="//cdn.flowplayer.com/releases/native/3/stable/flowplayer.min.js"></script>

<!-- Load plugin -->
<script src="//cdn.flowplayer.com/releases/native/3/stable/plugins/hls.min.js"></script>
<script src="//cdn.flowplayer.com/releases/native/3/stable/plugins/ovp.min.js"></script>
<!-- Load additional plugins if needed
<script src="//cdn.flowplayer.com/releases/native/3/stable/plugins/ads.min.js"></script>
-->
```


```js
// Import player library and basic CSS for player
import flowplayer from "@flowplayer/player";
import "@flowplayer/player/flowplayer.css";

// Import plugins
import HLS from "@flowplayer/player/plugins/hls";
import OVP from "@flowplayer/player/plugins/ovp";
```

info
Since the platform uses HLS streams as the primary source, you also need to load the [HLS plugin](/docs/wowza-flowplayer/plugins/wowza-video-platform-integration).

## Add HTML elements

embed
## Load media ID sources

The Wowza Video Platform Integration plugin is a loader plugin, meaning it loads a particular `src` type that is otherwise not supported in the native `HTMLVideoElement`. With this functionality, you can leverage live stream or video media IDs from your Wowza Video account with Wowza Flowplayer.

### Retrieve a video ID

Video media IDs can be retrieved from the URL of the Video details page in the Wowza Video platform. The format of the URL is `https://app.wowza.com/videos/[video-id]`. You can also find the video ID on the **Videos > Metadata tab** for each video asset.

When you locate the video identifier, include it in your player configuration as in the following example:


```javascript
flowplayer("#player",
  {
    token: "[your-player-token]",
    src: "[video-id]"
  });
```

This also works for playlist IDs in JavaScript embeds using the [Playlist plugin](/docs/wowza-flowplayer/plugins/playlist/#configure-the-plugin).

### Retrieve a live stream ID

Live stream IDs can be retrieved from the URL of the Live stream details page in the Wowza Video platform. The format of the URL is `https://app.wowza.com/livestreams/[live-stream-id]`. You can also find the live stream ID in the **Live > Live streams > Overview tab > Playback** section for each live stream asset.

When you locate the live stream identifier, include it in your player configuration as in the following example:


```javascript
flowplayer("#player",
  {
    token: "[your-player-token]",
    src: "[live-stream-id]"
  });
```

### Add composite media IDs

Additionally, the Wowza Video Platform Integration plugin enables you to create composite media IDs. These composite identifiers can combine a video or live stream media ID from Wowza Video with a player configuration ID from the same platform. You can then reduce the number of API calls so your video player can start playback as soon as possible.

You can get your player `configuration-id` from the `https://app.wowza.com/players/[configuration-id]` URL in Wowza Video. You can also find the configuration ID on the **Players > Configurations > General tab** in Wowza Video. For more, see Player configuration details page.


```javascript
flowplayer("#player",
  {
    token: "[your-player-token]",
    src: "[configuration-id]/[video-id]"
  });
```


```javascript
flowplayer("#player",
  {
    token: "[your-player-token]",
    src: "[configuration-id]/[live-stream-id]"
  });
```

info
If your player configuration includes an ad schedule, it will apply to your manual embed if you also load the [Advertising plugin](/docs/wowza-flowplayer/plugins/advertising) and the [IMA3 SDK](https://www.wowza.com/docs/player-configuration-details-page-in-wowza-video).

## Recommend video content

With the [composite media ID](/docs/wowza-flowplayer/plugins/wowza-video-platform-integration/#add-composite-media-ids) approach, you can use the Wowza Video Platform Integration plugin with the [Endscreen plugin](/docs/wowza-flowplayer/plugins/endscreen/#recommend-wowza-video-media) to recommend video content. For this set up to work and to get the recommended videos, you must:

* Install both the [Endscreen plugin](/docs/wowza-flowplayer/plugins/endscreen/) and the Wowza Video Platform Integration plugin.
* Create a player configuration in Wowza Video that includes the [Endscreen plugin](/docs/wowza-flowplayer/plugins/endscreen/). You can use an existing playlist to specify the recommendations list or let Wowza Video select the recommendations for you. This feature applies to videos only.


You can then use a [composite media ID](/docs/wowza-flowplayer/plugins/wowza-video-platform-integration/#add-composite-media-ids) to specify the source from the Wowza Video platform:


```javascript
flowplayer("#player",
  {
    src: "[configuration-id]/[video-id]",
    token: "[your-player-token]",
    recommendations: false
  });
```

When a list of videos is available, the `flowplayer.endscreen.events.RECOMMENDATIONS_READY` event is emitted by the plugin.

info
Since the player configuration incorporates end-screen recommendations, they're always enabled, meaning that the `recommendations` property is set to **true** by default. When you set the `recommendations` property to **false**, you can programmatically override the player configuration from Wowza Video and disable the video recommendations.