ビデオファイルの互換性

Unity には多くの形式のビデオファイルをインポートできます。Unity はインポートしたビデオファイルを VideoClip アセットとして保存します。

Unity でビデオファイルをプレビューするためには、そのファイルが Unity エディターを実行するプラットフォームと互換性がある必要があります。また、ファイルはターゲットとなるビルドプラットフォームと互換性がある必要もあります。Unity はファイルを一般的にサポートされている形式にトランスコードするオプションを提供しますが、互換性を自身で管理することもできます。詳しくは、後述の ターゲットプラットフォームとの互換性 を参照してください。

エディタープラットフォームとの互換性

ビデオソースファイルは、エディタープラットフォームがサポートする形式を使用する必要があります。各プラットフォームは、異なるビデオファイル形式をサポートします。

ビデオファイルトラックのエンコードには、サポートされているコーデックを使用する必要があります。各プラットフォームは、そのプラットフォームのバージョンごとに変更される可能性がある特定のコーデックをサポートします。

サポートされていないコーデックを使用するビデオファイルからは、エディターでエラーメッセージが表示されます。この場合、互換性のあるコーデックに変換しないと使用できません。

H.264 は、ほとんどのプラットフォームでサポートされている最適なビデオコーデックです。クロスプラットフォームの互換性が最も高いのですが、Linux エディターはこのコーデックをサポートしていません。

Linux の場合、最適なエンコーディングは、以下のコーデックを使用した .webm コンテナです。

• ビデオトラックの場合、VP8。
• オーディオの場合、Vorbis。

コーデックのサポートについては、エディターのプラットフォームの公式ドキュメントを参照してください。Windows と macOS のコーデックの互換性については、以下のリンクを参照してください。

• Windows のコーデック互換性
• macOS のコーデック互換性

ビデオクリップインポーター

ビデオクリップインポーター は、Unity にインポートするビデオファイルをトランスコードできます。これは、ビデオがエディタープラットフォームがサポートするコーデックを使用しているが、ファイルとターゲットプラットフォーム間に互換性がない場合に便利です。

サポートされていないビデオファイルをエディターで使用する

ターゲットプラットフォームと互換性があるが、エディタープラットフォームと互換性のないビデオファイルを使用するには、それらを ストリーミングアセット として設定します。例えば、エディターが VP8 しかサポートしていない場合でも、Android ビルドに VP9 コーデックを使用したいなどの場合に役立ちます。

ビデオファイルをストリーミングアセットとして設定するには、それらをプロジェクトの StreamingAssets フォルダーに保存します。Video Player コンポーネントがストリーミングアセットを指すようにするには、URL プロパティを使用します。

また、Application.streamingAssetsPath を使用して、スクリプトをとおしてストリーミングアセットへのプラットフォーム固有のパスにアクセスすることもできます。これらのパスをエディターでプレビューすることはできません。

エディターと互換性のあるバージョンのプレースホルダーを用意したいが、ターゲットプラットフォームには別のバージョンを使用したい場合、両方のバージョンをプロジェクトに加え、エディターと互換性のあるバージョンをプレースホルダーとして使用し、ランタイムにどちらのバージョンを使用するか決定することができます。

以下の例は、異なるプラットフォームで異なるビデオ URL を使用する方法を示しています。詳細については、プラットフォーム依存のコンパイル に関するドキュメントを参照してください。

void SetupMovieFile(VideoPlayer vp)
{
#if UNITY_EDITOR || UNITY_LINUX
vp.url = pathToMyVp8File;
#elif UNITY_ANDROID
vp.url = pathToMyVp9File;
#elif UNITY_STANDALONE_WIN
vp.url = pathToMyWmvFile;
#else
vp.url = pathToMyMp4File;
#endif
}

ターゲットプラットフォームとの互換性

Video Player コンポーネントは、エディタープラットフォームのネイティブのオーディオおよびビデオデコーディングライブラリを使用して、エディターでビデオファイルを再生します。また、ファイルがターゲットプラットフォームの要件を満たしていることを確認する必要があります。

エンコードに関する推奨事項

• ハードウェアアクセラレーションにネイティブでサポートされている最高のビデオコーデックは H.264 です。

• VP8 は、クロスプラットフォームサポートを優先する場合に適しています。幅広くサポートされており、包括的な機能セットを備えていますが、H.264 などのハードウェアアクセラレーションコーデックよりも多くのリソースを消費します。

• H.265 は、H.265 をサポートするデバイスで使用できます。詳細は、後述の H.265互換性 を参照してください。

• Android はネイティブライブラリを使用して VP8 をサポートします。そのため、一部の Android デバイスでは VP8 もハードウェア支援される場合があります。

• Unity エディターでは .ogv 形式をサポートしていますが、他のプラットフォームではあまりサポートされていません。ターゲットプラットフォームに応じて、.ogv ファイルを .mp4 (H.264) または .webm (VP8) にトランスコードします。

キーエンコード値

以下の表は、エンコードパラメーターで確認するキー値の一覧です。

VideoClips のトランスコード

ビデオクリップインポーター には、VideoClip アセットを以下のいずれかのビデオコーデックにトランスコードするオプションがあります。

• H.264
• H.265
• VP8

トランスコードされた VideoClips は適切なオーディオコーデックを自動的に使用します。

• H.264 または H.265 でエンコードされた AAC ビデオ
• VP8 でエンコードされたビデオの Vorbis

ノート: ビデオクリップインポーター には、基本的なトランスコードオプションのみが用意されています。ソースファイルのエンコード方法によっては、インポーターオプションを使用してトランスコードしたクリップから最適なパフォーマンスが得られない場合があります。その場合は、外部のトランスコードプログラムを使用すると、より良い結果が得られる場合があります。

外部プログラムを使用した VideoClip のエンコード

ターゲットシステムで確実にサポートされているビデオを使用する場合は、ビデオクリップインポーターの トランスコードオプションを無効にすることができます。無効にすると、Unity はファイルを変更しません。エンコードは外部プログラムで管理でき、より細かい制御が可能になります。

互換性に関するノート

このセクションでは、ビデオの互換性に関する有用な情報と、外部リソースへのリンクを提供します。

メディアサポートに関するベンダーの推奨事項

コーデックのサポートについては、ベンダーの推奨事項に従ってください。古いモバイルプラットフォームで、コーデックの選択が制限されます。複数のデバイスで実行するゲームに加える予定のビデオに対しては注意深く検査し、変換/再エンコードする必要があるかもしれません。

• Androidサポートされているメディア形式
• Windows: サポートされるメディア形式、H.265
• iPhone:iPhone モデルの比較
• UWP:サポートされるコーデック

H.265 互換性

以下の表は、H.265 コーデックのプラットフォーム固有の要件と情報を示しています。

• 2019–05–07

• Unity 5.6 の新機能