すべてのプロダクト
Search
ドキュメントセンター

ApsaraVideo VOD:公式コンポーネント

最終更新日:Sep 18, 2026

ApsaraVideo Player SDK は、広告、字幕、プレイリスト、その他の一般的なシナリオに対応する組み込みコンポーネントを提供します。これらはそのまま使用することも、カスタマイズすることもできます。

ApsaraVideo Player SDK は、広告、字幕、プレイリスト、その他の一般的なシナリオに対応する組み込みコンポーネントを提供します。これらはそのまま使用することも、カスタマイズすることもできます。

概要

  • ソースコードは GitHub で公開されています。

  • [機能] タブでコンポーネントを試すことができます。

  • 一部の機能は、モバイル端末の組み込みブラウザーでは動作しない場合があります。

  • GitHub はサードパーティのサイトです。接続に問題が発生することがあります。

コンポーネント一覧

コンポーネント名

タイプ

説明

効果

弾幕コメント

AliplayerDanmuComponent

ライブコメントを有効/無効にしたり、送信したりするためのテキスト入力ボックスとコントロールバーボタンを追加します。詳細については、弾幕コンポーネントをご参照ください。

image

マーキー (マーキーコンポーネント)

BulletScreenComponent

不正コピーを防止するために、スクロールするテキストのウォーターマーク (ユーザー ID など) を追加します。位置、色、フォントサイズをカスタマイズできます。

新バージョンのプレーヤーには、ティッカーをカバーし、より包括的で使いやすい動的ウォーターマーク機能が内蔵されています。詳細については、Aliplayer API リファレンスの属性 watermark をご参照ください。

image

字幕

CaptionComponent

字幕の言語を切り替えます。詳細については、字幕コンポーネントをご参照ください。

image

ビデオ広告ポッド

ManyVideoADComponent

メインコンテンツの前に一連のビデオ広告を再生します。詳細については、ビデオ広告ポッドコンポーネントをご参照ください。

image

レジューム再生

MemoryPlayComponent

最後の再生位置を自動的に保存します。2 つのモードがあります:

  • クリックして再生:再生時に最後の位置を表示し、その位置へのシークを選択できます。

  • 自動再生:再生開始時に、最後に保存された位置から再生します。

詳細については、レジューム再生コンポーネントをご参照ください。

説明

ブラウザーが localStorage をサポートしている必要があります。

image

一時停止広告 (画像)

PauseADComponent

一時停止時に、プレーヤーの中央に画像広告のオーバーレイを表示します。詳細については、一時停止広告コンポーネントをご参照ください。

image

ビデオプレイリスト

PlaylistComponent

コントロールバーにプレイリストボタンを追加して、ビデオを切り替えます。詳細については、ビデオプレイリストコンポーネントをご参照ください。

p963635

プレビュー

PreviewVodComponent

再生をプレビュー時間に制限し、完全なコンテンツの視聴 (サブスクリプションや購入など) を促します。詳細については、プレビューコンポーネントをご参照ください。

image

プログレスマーカー

ProgressComponent

プログレスバーにキーポイントのマーカーを追加します。マーカーにカーソルを合わせると、サムネイルプレビューが表示されます。詳細については、プログレスマーカーコンポーネントをご参照ください。

p963675

画質

QualityComponent

ビデオの画質 (解像度) を切り替えます。詳細については、画質コンポーネントをご参照ください。

image

再生速度

RateComponent

ビデオの再生速度を調整します。詳細については、再生速度コンポーネントをご参照ください。

image

回転とミラーリング

RotateMirrorComponent

コントロールバーに回転ボタンとミラーリングボタンを追加します。詳細については、回転とミラーリングコンポーネントをご参照ください。

image

開始広告 (画像)

StartADComponent

ビデオ再生が開始される前に画像広告を表示します。詳細については、開始広告コンポーネントをご参照ください。

image

音声トラックの切り替え

TrackComponent

音声トラックの言語を切り替えます。詳細については、音声トラックの切り替えコンポーネントをご参照ください。

-

ビデオ広告

VideoADComponent

メインコンテンツの前に、時間制限のあるビデオ広告を再生します。詳細については、ビデオ広告コンポーネントをご参照ください。

image

次を再生

PlayerNextComponent

コントロールバーに [次を再生] ボタンを追加します。クリックイベントは独自に定義して、引数として渡すことができます。詳細については、次を再生コンポーネントをご参照ください。

image

コンポーネントの使用

  1. コンポーネントを Web Player SDK に追加します。現在、CDN URL は利用できません。コンポーネントパッケージをダウンロードし、プロジェクトに組み込んでください。最新バージョンをご利用ください。

    <script type="text/javascript" src="your-public-path/aliplayercomponents-1.0.9.min.js"></script>
  2. コンポーネントを Web Player SDK にマウントします。

    var player = new Aliplayer(
      {
        id: "player-con",
        source: "//player.alicdn.com/video/editor.mp4",
        components: [
          {
            name: "StartADComponent",
            type: AliPlayerComponent.StartADComponent,
            args: [
              "https://img.alicdn.com/tfs/TB1byi8afDH8KJjy1XcXXcpdXXa-1920-514.jpg",
              "https://promotion.aliyun.com/ntms/act/videoai.html",
              3,
            ],
          },
          {
            name: "BulletScreenComponent",
            type: AliPlayerComponent.BulletScreenComponent,
            args: [
              "Aliplayer へようこそ",
              { fontSize: "16px", color: "#00c1de" },
              "random",
            ],
          },
        ],
      },
      function (player) {}
    );

    コンポーネントのプロパティ:

    プロパティ

    説明

    name

    コンポーネントの一意の名前。インスタンスを取得するために使用されます。

    type

    コンポーネントのクラスです。

    args

    コンストラクターの引数。必須パラメーターと一致する必要があります。

カスタムビルドの作成

すべてのコンポーネント

すべてのコンポーネントをビルドします。出力: /dist/aliplayer-components/aliplayercomponents-[version].min.js

$ npm run build

コンポーネントのカスタムセット

バンドルサイズを削減するには、特定のコンポーネントのみをビルドします:

$ npm run build componentsName # componentsName はコンポーネント名

componentsName はスペース区切りのリストです。 例:

$ npm run build AliplayerDanmu BulletScreen # AliplayerDanmu と BulletScreen コンポーネントをパッケージ化します。