Video Player コンポーネント

Video Player コンポーネント を使って ビデオファイル を ゲームオブジェクト にアタッチし、ランタイムにビデオファイルをゲームオブジェクトの テクスチャ 上で再生できます。

下の図は、球状のゲームオブジェクトにアタッチされた Video Player コンポーネントを表示しています。

デフォルトでは、Video Player コンポーネントの Material Property は _MainTex に設定されています。つまり、レンダラーを持つゲームオブジェクトに Video Player コンポーネントをアタッチすると、自動的にそのレンダラーのテクスチャに割り当てられます (なぜなら、これはゲームオブジェクトの主要テクスチャであるため)。ここでは、ゲームオブジェクトに Mesh Renderer コンポーネントが設定されているので、Video Player コンポーネントは自動的にそれを Renderer フィールドに割り当てます。つまり、ビデオクリップは Mesh Renderer のテクスチャで再生されます。

ビデオを再生する特定の対象 (以下を含む) を設定することもできます。

• カメラ 面

• レンダーテクスチャ

• マテリアル テクスチャパラメーター

• コンポーネントの テクスチャ フィールドすべて

VideoPlayer コンポーネント

Video Playerスクリプトの例

次のスクリプトは、VideoPlayerコンポーネントの機能の一部を示しています。

//VideoPlayer 関数の例
using UnityEngine;

public class Example : MonoBehaviour
{
    void Start()
    {
        // VideoPlayer を main camera にアタッチ
        GameObject camera = GameObject.Find("Main Camera");

        // VideoPlayerは、カメラオブジェクトに追加されると、カメラのバックプレーンを自動的にターゲットにします。
        // videoPlayer.targetCameraを変更する必要はありません。
        var videoPlayer = camera.AddComponent<UnityEngine.Video.VideoPlayer>();

        // Play on awake はデフォルトで true。Start() を使用しているため、
        // 以下に設定されている URL が自動再生を開始しないようにするには、falseに設定します。
        videoPlayer.playOnAwake = false;

        // デフォルトで カメラに加えられた VideoPlayers はファークリップ面を使います。
        //代わりに、ニアクリップ面をターゲットにします。
        videoPlayer.renderMode = UnityEngine.Video.VideoRenderMode.CameraNearPlane;

        // これにより、再生中のビデオを通してシーンが表示されます。
        videoPlayer.targetCameraAlpha = 0.5F;

        // 再生するビデオを設定します。 URLは、ローカルの絶対パスまたは相対パスをサポートします。
        // Here, using absolute.
        videoPlayer.url = "/Users/graham/movie.mov";

        // 最初の 100 フレームをスキップ
        videoPlayer.frame = 100;

        // 完了したら、最初からやり直します。
        videoPlayer.isLooping = true;

        // 最後に到達するたびに、再生速度が10分の1になります。
        videoPlayer.loopPointReached += EndReached;

        // 再生を開始します。 これは、VideoPlayerが準備をしなければならない可能性があることを意味します(リソースの予約、数フレームのプリロードなど)。 
        // この準備に関連する遅延をより適切に制御するために、
        // videoPlayer.Prepare（）をそのprepareCompletedイベントと一緒に使用できます。
        videoPlayer.Play();
    }

    void EndReached(UnityEngine.Video.VideoPlayer vp)
    {
        vp.playbackSpeed = vp.playbackSpeed / 10.0F;
    }
}

• 2017–05–07 修正されたページ

• 5.6 の新機能