Unity の AR Foundation でユーザーの環境を把握

ご自身のアプリで Scene Semantics API を使用する方法を学びます。

Scene Semantics API は、ML モデルベースのリアルタイムのセマンティック情報を提供することで、ユーザーの周囲のシーンを理解できるようにします。屋外のシーンの画像を基に、API は空、建物、木、道路、歩道、車両、人など、一連の有用なセマンティッククラスから各ピクセルのラベルを返します。ピクセルラベルに加えて、Scene Semantics API は各ピクセルラベルの信頼値と、屋外シーンにおける特定のラベルの占有率を簡単にクエリする方法も提供します。

左から順に、入力画像の例、ピクセルラベルのセマンティック画像、対応する信頼度画像を示しています。

入力画像、セマンティック画像、セマンティック信頼度画像の例。

前提条件

続行する前に、AR の基本的なコンセプトと ARCore セッションを構成する方法を理解しておいてください。

シーンのセマンティクスを有効にする

新しい ARCore セッションで、ユーザーのデバイスが Scene Semantics API をサポートしているかどうかを確認します。処理能力の制約により、すべての ARCore 対応デバイスが Scene Semantics API をサポートしているわけではありません。

リソースを節約するため、ARCore では、Scene Semantics がデフォルトで無効になっています。アプリで Scene Semantics API を使用するには、セマンティックモードを有効にします。

ARCoreExtensionsConfig で Semantics Mode を有効に設定します。

セマンティクスモードを有効に設定しました。

iOS を使用している場合は、プロジェクト設定でセマンティクスも有効にする必要があります。

[Edit] > [Project Settings] > [XR Plug-In Management] > [ARCore Extensions] に移動します。
[オプション機能] で [iOS のセマンティクス] を選択します。

オプション機能で iOS のセマンティクスを有効にしました。

セマンティック画像を取得する

Scene Semantics を有効にすると、セマンティック画像を取得できます。セマンティック画像は TextureFormat.R8 画像で、各ピクセルは SemanticLabel で定義されたセマンティックラベルに対応しています。

ArSemanticManager.TryGetSemanticTexture() を使用して、セマンティック画像を取得します。

if (semanticManager.TryGetSemanticTexture(out Texture2D semanticImage))
{
    using (semanticImage)
    {
        // Use the semantic image here.
    }
}

セマンティック画像の出力は、セッションの開始から約 1 ～ 3 フレーム後に利用可能になります（デバイスによって異なります）。

信頼度の画像を取得する

各ピクセルにラベルを提供するセマンティック画像に加えて、API は対応するピクセル信頼値の信頼画像も提供します。信頼度画像は TextureFormat.Alpha8 画像で、各ピクセルは [0, 255] の範囲の値に対応しており、各ピクセルのセマンティックラベルに関連付けられる確率に対応しています。

ArSemanticManager.TryGetSemanticConfidenceTexture() を使用して、セマンティック信頼度の画像を取得します。

if (semanticManager.TryGetSemanticConfidenceTexture(out Texture2D semanticConfidenceImage))
{
    using (semanticConfidenceImage)
    {
        // Use the semantic confidence image here.
    }
}

出力信頼度画像は、セッションの開始から約 1 ～ 3 フレーム後に利用可能になります（デバイスによって異なります）。

セマンティックラベルのピクセル数をクエリする

また、現在のフレーム内の、空などの特定のクラスに属するピクセルの割合をクエリすることもできます。このクエリは、セマンティック画像を返して特定のラベルをピクセル単位で検索するよりも効率的です。返される分数は、[0.0, 1.0] の範囲の浮動小数点数値です。

ArSemanticManager.GetSemanticLabelFraction() を使用して、特定のラベルの割合を取得します。

var fraction = semanticManager.GetSemanticLabelFraction(SemanticLabel.SKY);