Player API の Advertising モジュールの requestAd メソッドを使用して、動的に広告要求を行うことができます。これは、Advertising モジュールでプレーヤに設定した広告要求ポリシよりも優先されます。メディアの再生中に任意のタイミングで requestAd を呼び出して、ミッドロール広告を要求できます。Player API リファレンスの requestAd メソッドの説明には、ミッドロール広告での使用例と、プレロール広告およびポストロール広告を模した際の使用例が記載されています。
requestAd メソッドのシグネチャは以下のとおりです。
public function requestAd(pCuePointKVP:String):void
文字列の引数を使用して、広告要求で追加のキーと値のペアを渡すことができます。requestAd を呼び出すと、その広告要求には次のキーと値のペアが含まれます。
requestAd メソッドを使用する場合は、プレーヤの構成でこの API を有効にしておいてください。
動的に広告を表示するには、showAd メソッドを使用する方法もあります。showAd の詳細は、外部広告呼び出しを使用するを参照してください。