ドキュメント

Unity Engine

Unity Engine

ビデオプレイヤーコンポーネントターゲット

ビデオプレイヤーコンポーネントがビデオコンテンツを再生できるターゲットについて学習します。
読み終わるまでの所要時間 10 分最終更新 6日前

ビデオプレイヤーコンポーネントを使用して、シーン内のさまざまなサーフェスでビデオ (URL またはビデオクリップから) を再生します。
ビデオプレイヤーコンポーネントを使用すると、ビデオコンテンツを異なるターゲットで再生できます。ターゲットによって、シーンのビデオコンテンツの表示場所が変わります。ビデオのターゲットを変更するには、ビデオプレイヤーコンポーネントを開き、レンダリングするモードプロパティを任意のターゲットに設定します。
このページでは、使用可能なビデオターゲットの一部の詳細を説明します。
レンダリングするモードプロパティーとそのオプションの詳細については、レンダリングするモードドロップダウンを参照してください。
ビデオプレイヤーコンポーネントのすべての設定については、ビデオプレイヤーコンポーネントリファレンスを参照してください。コンポーネントの作成方法については、ビデオプレイヤーコンポーネントの作成 を参照してください。

ビデオプレイヤー のデフォルトターゲット

コンポーネントの作成時に Unity がデフォルトのターゲットを決定します。ビデオクリップやビデオプレイヤーコンポーネントをゲームオブジェクトオブジェクトにドロップすると、ゲームオブジェクトオブジェクトのレンダラーのテクスチャがターゲットになります。
ビデオクリップをシーンにドラッグすると、ターゲットはシーンのメインカメラのファークリップ面に設定されます。それ以外の場合は、VideoPlayer は
レンダーテクスチャ

?

レンダリングするモードを使用します。

ビデオコンテンツをカメラ平面にディスプレイ

ビデオをカメラのニアクリップ面またはファークリップ面に投影できます。この設定を有効にするには、レンダリングするモードをカメラニアクリップ面またはカメラファークリップ面に設定します。
ニアクリップ面は、シーン内のすべてのオブジェクトの正面にビデオを表示します。この平面にビデオを表示することは、シーンをオーバーレイ必要があるビデオカットシーンや UI 要素に役立ちます。
ファークリップ面はシーンの背景にビデオを表示します。これは背景のアニメーションに最適です。

ゲームオブジェクトオブジェクトのマテリアルとテクスチャに動画コンテンツをディスプレイする

ビデオプレイヤーコンポーネントを使用すると、ビデオファイルを GameObjects にアタッチ、設定、添付、ゲームオブジェクトのテクスチャでのビデオコンテンツのランタイム再生ができます。
Renderer コンポーネントを含むゲームオブジェクトにビデオプレイヤーコンポーネントをアタッチ、設定、添付すると、Unity はそのコンポーネントのマテリアルプロパティをゲームオブジェクトのメインテクスチャに自動的に設定します。
以下のスクリーンショットは、球面的なゲームオブジェクトにアタッチされたビデオプレイヤーコンポーネントを示しています。ゲームオブジェクトには Mesh Renderer コンポーネントがあるため、ビデオプレイヤーはそれを自動的に Renderer フィールドに割り当てます。つまり、ビデオクリップはメッシュレンダラーのテクスチャで再生されます。

A Video Player component attached to a spherical GameObject. The Video Player plays the video clip on the GameObject’s main Texture (in this case, the Texture of the Mesh Renderer component).

レンダーテクスチャにコンテンツをディスプレイする

ビデオプレイヤー を使用して、レンダーテクスチャにビデオコンテンツをディスプレイできます。これは、ビデオを複数のGameObjectsオブジェクトに投影したい場合や、コンテンツにポストプロセスエフェクトを適用したい場合に便利です。ビデオ用のレンダーテクスチャを設定して最適化する方法については、ビデオをディスプレイするレンダーテクスチャの設定 を参照してください。

スクリプトを使用したターゲットの設定 (API のみ)

レンダリングモードを API のみに設定すると、ビデオプレイヤーコンポーネントは自動的にターゲットを割り当てたり、ビデオコンテンツをどこにも描画しません。代わりに、このモードでは C# コードを使用してビデオレンダリングを手動で処理します。スクリプトを使用して、
VideoPlayer.texture
プロパティからビデオフレームにアクセスします。
このレンダリングモードでは、ビデオをレンダーテクスチャまたはテクスチャオブジェクトとして提供し、コードを通じてシーンのテクスチャフィールドに動的に割り当てることができます。このアプローチは、中間レンダーテクスチャを手動で作成および管理する必要がなくなるため便利です。
API Only では、Raw 画像 UI 要素やゲームオブジェクトオブジェクトのマテリアルなど、Unity API でテクスチャを割り当てることができる場所ならどこでもビデオコンテンツを使用できます。

追加リソース