Table of Contents

Configuring universal render pipeline（URP）

このドキュメントでは、Universal Render Pipeline（URP）プロジェクトで EasyAR 機能を統合する際の設定方法について説明します。

Before you begin

Creating universal render pipeline asset

注記

Unity プロジェクトが URP プロジェクトテンプレートで作成されている場合、またはプロジェクトに既に UniversalRenderPipelineAsset と Universal Renderer が存在する場合は、プロジェクトが URP レンダーパイプラインに切り替わっていることを確認するに直接進んでください。

Project ウィンドウで右クリックメニュー Create > Rendering > URP Asset(with Universal Renderer) を選択し、必要なアセットを作成します：

Unity6.2_URP_Create_Asset

Finding universal render pipeline asset for the target platform

  1. メニューバーから Edit > Project Settings > Graphics をクリックします。

    上部の Default Render Pipeline スロットには Universal Render Pipeline Asset が割り当てられている必要があります。

    Unity6.2_URP_Graphics

    ヒント

    このオプションは古いバージョンの Unity では Scriptable Render Pipeline Settings という名前でした。

  2. メニューバーから Project Settings > Quality をクリックします。

    ターゲットプラットフォームの品質レベルを選択し、下の Render Pipeline Asset がターゲットプラットフォームで使用される Universal Render Pipeline アセットです。空の場合、ターゲットプラットフォームで使用される Universal Render Pipeline アセットは Graphics ウィンドウで設定されたアセットになります。

    Unity6.2_URP_Quality

    ヒント

    Quality の設定が Graphics と一致しない場合、システムは Quality のアセットを優先的に使用します。

Configuring universal render pipeline asset

重要

Unity エディタと Android/iOS などのデバイスで使用される Universal Render Pipeline アセットは異なる場合があるため、エディタ上で使用する場合とデバイスで使用する場合でそれぞれ設定する必要があります。

  1. ターゲットプラットフォームで使用する Universal Render Pipeline Asset を選択し、それが使用する Universal Renderer Data を選択します。

    Unity6.2_URP_Renderer

    ヒント

    プロジェクトに複数の Renderer が設定されている場合、AR カメラが使用しているレンダラーを選択していることを確認してください。シーンカメラの Camera コンポーネント > Rendering > Renderer オプションで現在のインデックス値を確認できます。

  2. Universal Renderer Data の Inspector パネル下部で Add Renderer Feature をクリックし、EasyARCameraImageRendererFeature を追加します。

    Unity6.2_URP_Renderer_Add_Feature

Notes on using easyar samples

EasyAR Unity プラグインに付属のサンプルシーンは、デフォルトで Built-in レンダーパイプラインのマテリアルとシェーダーを使用しています。Unity はこれらのマテリアルとシェーダーを自動的に URP 互換バージョンに変換しますが、一部のリソースはレンダリング異常を起こす可能性があり、Convert assets using the Render Pipeline Converter を参照して手動で変換する必要があります。

非 URP レンダリング異常

メニュー Window > Rendering > Render Pipeline Converter をクリックし、Built-in to URP を選択して変換ウィンドウを開きます。Material Upgrade と Readonly Material Converter にチェックを入れる > 下部の Convert Assets をクリックします。

Render Pipeline Converter

変換が完了すると、サンプルのマテリアル表示が正常に戻ります。

Common issues

正しく設定されていない場合、実行時にカメラ映像が表示されず、多くの場合真っ暗な画面になりますが、ターゲットをトラッキングした際に、トラッキングターゲット下に追加されたコンテンツは正常に表示されます。

4000 以降のバージョンでは、session が Broken 状態になり、画面やログに BrokenReason が URP RenderPipeLineAsset not properly setup と表示されます：

Session_Broken_Caused_By_URP

この問題を解決するには、本ドキュメントの説明に従って Universal Render Pipeline Asset を正しく設定する必要があります。