Video
Videoウィジェットは、アプリ画面で動画を再生するメディアプレーヤーです。
再生・停止・音量・再生速度・繰り返しなどを設定でき、映像の上に再生コントロールUIを一緒に表示できます。
定義・役割
Videoウィジェットは、指定した動画ソース（ネットワーク・ファイル・アセット）を再生するプレーヤー領域を描画します。自動繰り返し、音量とミュート、再生速度、開始位置、再生コントロールUIの表示可否などをプロパティで設定します。
- カテゴリー: Contents
- デフォルトサイズ: 幅は横いっぱい・高さ200
- 編集画面のデフォルト表示:
Mediaラベルが入った空の領域
機能
| 機能 | 説明 |
|---|---|
| 動画の再生 | ネットワーク・ファイル・アセットのソースの動画を再生します。 |
| 再生の制御 | 再生・停止の状態（status）、開始位置（seek）、繰り返し（loop）を設定します。 |
| 音の制御 | 音量（volume）とミュート（mute）を設定します。 |
| 再生速度 | 0.5〜2.0倍の範囲で再生速度を調整します。 |
| コントロールUI | 映像の上に再生/停止・進行バー・音量・速度のコントロールを表示します。 |
| 表示領域 | 映像のうち表示する領域（切り抜き比率、viewport）を指定します。 |
使い方
- 左のウィジェットパレットでContentsカテゴリーを開きます。
- Video項目をキャンバスへドラッグ＆ドロップします。
- 右のプロパティパネルで動画ソース（
media）を指定します。 - 必要に応じて
loop、volume、playBackRate、showControlUIなどを調整します。
プロパティ
| プロパティ | 説明 | デフォルト値 | 値 / タイプ |
|---|---|---|---|
media | 再生する動画ソース（ネットワーク・ファイル・アセット） | 未設定 | メディアソース |
loop | 再生が終わると自動的に再生し直す | false（オフ） | true / false |
volume | 再生音量 | 0.5 | 数値0.0〜1.0 |
seek | 再生開始位置（全体の長さに対する百分率） | 0 | 数値0〜99 |
playBackRate | 再生速度の倍率 | 1.0 | 数値0.5〜2.0 |
showControlUI | 再生コントロールUIを表示するかどうか | true（表示） | true / false |
fullScreen | 全画面を使用するかどうか | true（使用） | true / false |
mute | ミュートにするかどうか | false（オフ） | true / false |
status | 再生状態 | Stop | Stop, Play |
viewport | 映像のうち表示する領域（切り抜き比率） | 全体（x:0, y:0, 幅:1, 高さ:1） | ビューポート値 |
注意・ヒント
ヒント
volumeは0.0〜1.0の範囲です。muteがオンの場合、音量の値に関係なく音は出ません。
注記
seekは秒単位ではなく、全体の長さに対する百分率（0〜99）です。たとえば50は映像の中間地点から再生を開始します。
さらに詳しく
ヒント
このウィジェットをスクリプトで制御するWidget Control（Property・Method・Event）の全体はVideo Widget Controlでご確認ください。