videojs-ima
Advanced tools
##Introduction The IMA SDK Plugin for Video.js provides a quick and easy IMA SDK integration for the Video.js player.
#IMA SDK Plugin for Video.js
##Introduction The IMA SDK Plugin for Video.js provides a quick and easy IMA SDK integration for the Video.js player.
The framework is currently in beta, allowing interested developers to try it out and send feedback before we finalize the APIs and features.
##Features
##Getting started The easiest way to get started is by using npm.
npm install videojs-ima
If you don't use npm, you can download the source from the src/ folder and include it directly in your project. You'll also need to download the source for the videojs-contrib-ads plugin.
In your index.html file, create a new video.js player and load a (currently empty) javascript file:
<html>
<head>
<!-- Load dependent stylesheets. -->
<link href="//vjs.zencdn.net/4.5/video-js.css" rel="stylesheet">
<link rel="stylesheet" href="path/to/videojs.ads.css" />
<link rel="stylesheet" href="path/to/videojs.ima.css" />
</head>
<body>
<video id="content_video" class="video-js vjs-default-skin"
controls preload="auto" width="640" height="264">
<source src="PATH_TO_YOUR_CONTENT_VIDEO" type="YOUR_CONTENT_VIDEO_TYPE" />
</video>
<script src="//vjs.zencdn.net/4.5/video.js"></script>
<script src="//imasdk.googleapis.com/js/sdkloader/ima3.js"></script>
<script src="/path/to/videojs.ads.js"></script>
<script src="/path/to/videojs.ima.js"></script>
<script src="player.js"></script>
</body>
</html>
In player.js, load the ads library and set up the IMA plugin:
var player = videojs('content_video');
var options = {
id: 'content_video',
adTagUrl: 'YOUR_AD_TAG'
};
player.ima(options);
player.ima.requestAds();
player.play();
That's all there is to it! For more information and for additional API docs, check out our [API documentation](WHERE WILL THIS BE IDK).
The plugin accepts additional settings beyond the two required settings shown in the previous snippet. A summary of all settings follows:
{
id: <string> REQUIRED The id of your video player
adTagUrl: <string> REQUIRED A URL which returns a VAST response
adsRenderingSettings: <Object> JSON object with ads rendering settings as defined in the IMA SDK Docs(1).
debug: <boolean> True to load the debug version of the plugin, false to load the non-debug version. Defaults to false.
locale: <string> Locale for ad localization. This may be any ISO 639-1 (two-letter) or ISO 639-2 (three-letter) code(2). Defaults to 'en'.
nonLinearWidth: <Number> Desired width of non-linear ads. Defaults to player width.
nonLinearHeight: <Number> Desired height for non-linear ads. Defaults to 1/3 player height.
}
(1) IMA SDK Docs
(2) Valid locale codes
##Where do I report issues? Please report issues on the issues page.
##Support If you have questions about the framework, you can ask them at http://groups.google.com/d/forum/google-media-framework
##How do I contribute? See this wiki article for details.
##Requirements
##Authors
FAQs
[](https://travis-ci.org/googleads/videojs-ima)
The npm package videojs-ima receives a total of 15,372 weekly downloads. As such, videojs-ima popularity was classified as popular.
We found that videojs-ima demonstrated a healthy version release cadence and project activity because the last version was released less than a year ago. It has 2 open source maintainers collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Security News
PyPI confirms no security flaws were exploited in the Ultralytics supply chain attack and highlights improvements for safer package publishing.
Security News
Research
The Socket Research Team breaks down a malicious wrapper package that uses obfuscation to harvest credentials and exfiltrate sensitive data.
Research
Security News
Attackers used a malicious npm package typosquatting a popular ESLint plugin to steal sensitive data, execute commands, and exploit developer systems.