プレイヤーAPI概要

ミルビィ プレイヤーAPI は JavaScript を用いてミルビィプレイヤーを操作するための機能を提供します。

プレイヤーAPI利用の流れ

1. HTML ページにミルビィプレイヤー埋め込みコードを記述します。
2.  JavaScript コード “Eviry.Player.ready(callback)” を定義し、第 1 引数のコールバック関数に渡されるミルビィプレイヤーを用いて操作を定義します。

複数プレイヤー/キャンバス貼り付け時の注意

HTMLページ内に複数のミルビィプレイヤー埋め込みコードが含まれている場合、操作対象のミルビィプレイヤーを特定するためにミルビィプレイヤー埋め込みコードに下記の修正が必要となります。

1. 対象のプレイヤーの埋め込みコードパラメーターに ‘ Eviry.Player.extid = "任意の ID"; ‘ を追加・定義します。
2. Eviry.Player.extid に定義した ID を Eviry.Player.ready() の第 2 引数に指定することで操作対象のミルビィプレイヤーを特定します。

サンプルコード

現在再生されている動画の動画 ID と再生時間をリアルタイムで HTML フォームに表示します。

<script type="text/javascript">// <![CDATA[
var Eviry=Eviry||{};Eviry.Player||(Eviry.Player={});Eviry.Player.embedkey="...";
// ]]></script>
<script type="text/javascript" src="https://xxxxxxxxxxxxx/eviry.player.min.js"></script>
<script type="text/javascript">// <![CDATA[
Eviry.Player.ready(function (millviplayer) {
        if (millviplayer) {
            function OnRefreshMillviInfo() {
                document.getElementById("videoid").innerHTML = millviplayer.getVideoID();
                document.getElementById("currentposition").innerHTML = millviplayer.getCurrentPosition();
            }
            setInterval(OnRefreshMillviInfo,100);
        } else {
            alert("ミルビィプレイヤーが見つかりませんでした。");
        }
    });
// ]]></script>
</code></pre>
<div>
  <div>
    動画 ID:<span id="videoid"></span>
  </div>
  <div>
    再生時間:<span id="currentposition"></span>
  </div>
</div>

プレイヤーAPIリスト

1. Eviry.Player.ready(callback, [extid])（プレイヤーAPIの呼び出し）
2. MillviPlayer.fetchAudienceCount()（ライブ配信時の視聴者数を取得）
3. MillviPlayer.getCurrentPosition()（現在の再生位置を取得）
4. MillviPlayer.getDuration()（動画の長さを取得）
5. MillviPlayer.getVideoID()（動画IDを取得）
6. MillviPlayer.isEnded()（再生完了状態を取得）
7. MillviPlayer.isPausing()（一時停止状態を取得）
8. MillviPlayer.isPlaying()（再生状態を取得）
9. MillviPlayer.pause()（動画の一時停止）
10. MillviPlayer.play()（動画の再生）
11. MillviPlayer.setCurrentPosition()（動画の再生位置指定、シーク）
12. MillviPlayer.reloadFlash()（IE向け、プレイヤーの再度表示に必要）