Player API¶

Embed Code¶

Here’s the HTML code you need to embed the Dailymotion Player:

<iframe src="http://www.dailymotion.com/embed/video/VIDEO_ID?PARAMS" width="WIDTH" height="HEIGHT" frameborder="0"></iframe>

We recommand to use our oEmbed API to generate this code.

To use the Javascript API with Dailymotion Javascript SDK, use the following code:

<!-- This <div> tag will be replaced the <iframe> video player -->
<div id="player"></div>

<script>
    // This code loads the Dailymotion Javascript SDK asynchronously.
    (function() {
        var e = document.createElement('script'); e.async = true;
        e.src = document.location.protocol + '//api.dmcdn.net/all.js';
        var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(e, s);
    }());

    // This function init the player once the SDK is loaded
    window.dmAsyncInit = function()
    {
        // PARAMS is a javascript object containing parameters to pass to the player if any (eg: {autoplay: 1})
        var player = DM.player("player", {video: "VIDEO_ID", width: "WIDTH", height: "HEIGHT", params: PARAMS});

        // 4. We can attach some events on the player (using standard DOM events)
        player.addEventListener("apiready", function(e)
        {
            e.target.play();
        });
    };
</script>

Parameters¶

Here is a list of all the parameters that can be used with the Dailymotion Player. They should be added as query-string parameters to the src of the iframe.

* May not work on some mobile OS versions

API¶

The player API works using different technologies depending on how you embeded the player and which technologies/restrictions applies on the device the player is running. It’s why we strongly encourage you to use our JavaScript SDK to communicate with the Player API in a webpage or our Objective-C SDK when embeding a video in an iPhone/iPad app or a Mac OSX application. An Android SDK will follow.

If you don’t want and can’t use one of our SDK, you can activate the Player API manually by using the api parameter. 3 values are allowed:

• The postMessage value will enable the window.postMessage() based API mode. This is the best way to communicate with the player in an HTML page. Unfortunately, postMessage is a relatively new development, so it’s only available with the following browsers versions: Internet Explorer 8+, Firefox 3+, Safari 4+, Chrome and Opera 9+.
• The fragment value will enable the fragment API mode (experimental). In this mode, you send a method call by changing the fragment of the src of the iframe. The player will use the same technique to send back events.
• The location value will enable location based API mode. This is only suitable for native apps which are able to inject Javascript into the page to send commands and which can intercept location changes of the webview in order to capture and block URL with the special dmevent scheme. This API mode is used by our provided Objective-C SDK.

API Reference¶

API methods are simple string with an optional parameter. To call a method, just pass the method name as string using the chosen API mode. To pass an argument, concatenate the method name with the argument by an equal string (ex: seek=10). Methods do never return values. To get the stat of a property, the client has to maintain the updated stat of the properties by listening to events.

Compatibility¶