プラグインにデータを渡す

オプションプロパティを定義する

プラグインを呼び出すときは、optionsで追加の子プロパティを使用することもできますplugins。optionsプロパティはオブジェクトでなければなりませんが、オブジェクトの配列などの複雑なデータ構造を含むことができます。

ここでは、nameoptions必須の子プロパティとオプションの子プロパティを持つプラグインプロパティを示すカール文の一部です。optionsプロパティで渡されたデータは、プラグインで使用できます。

"plugins": [{
  "name": "navigateOnVideoEnd",
  "options" : {"redirectURL": "http://docs.brightcove.com"}
}]

embed_in_pageプレーヤー実装を使用するときは、options プロパティを使用することもできます。プレーヤータグは iframe ではなく HTML ページにあります。これを行うには、単にデータオブジェクトを構築し、それを引数として渡します。例を以下に示します。

<script type="text/javascript">
  var options = {"redirectURL": "http://docs.brightcove.com"};
</script>
<script>videojs.getPlayer('myPlayerID').navigateOnVideoEnd(options);</script>

オプションデータを使用する

optionsこのプロパティを使用すると、プラグインの初期化時に使用するプレーヤー設定を介してプラグインにデータを渡すことができます。たとえば、redirectURL上記のオブジェクトを使用するには、プラグイン自体で次の操作を行います。

videojs.registerPlugin('navigateOnVideoEnd', function (options) {
  var myPlayer = this;
  myPlayer.on("ended", function () {
    window.location.href = options.redirectURL;
  });
});

注:標準のプラグインの実装を使用しますが、options無名関数のパラメータとして使用します。その後、options.propertyName表記法を使用して値にアクセスできます。