Bounds Control (バウンズコントロール)

Bounds control

BoundsControl (バウンズコントロール) は、以前は BoundingBox にあったマニピュレーション動作のための新しいコンポーネントです。バウンズコントロールは、セットアップにおける多くの改善と簡素化が行われ、新しい機能が追加されています。このコンポーネントはバウンディングボックスの代替品であり、バウンディングボックスは非推奨となります。

BoundsControl.cs スクリプトは、Mixed Reality でオブジェクトを変化させるための基本的な機能を提供します。バウンズコントロールは、ホログラムの周りにボックスを表示して、インタラクション可能であることを示します。ボックスの角と辺にあるハンドルを使って、オブジェクトを拡大縮小、回転、平行移動させることができます。バウンズコントロールは、ユーザーの入力にも反応します。例えば、HoloLens 2 では、バウンズコントロールは指の接近に反応し、オブジェクトからの距離を知覚するのに役立つ視覚的なフィードバックを提供します。すべてのインタラクションとビジュアルは簡単にカスタマイズできます。

サンプルシーン

バウンズコントロールの設定の例は、BoundsControlExamples シーンで見ることができます。

インスペクターのプロパティ

Target Object (対象オブジェクト)

このプロパティは、バウンズコントロールの操作によってどのオブジェクトが変化させられるかを指定します。オブジェクトが設定されていない場合、デフォルトでコンポーネントを所有するオブジェクトになります。

Activation Behavior (活性化の動作)

バウンズコントロールインターフェイスを活性化するには、いくつかのオプションがあります。

Activate On Start (スタート時に活性化): シーンが開始されるとバウンズコントロールが表示されます。
Activate By Proximity (近接時に活性化): 多関節ハンドがオブジェクトに近づいたときにバウンズコントロールが表示されます。
Activate By Pointer (ポインターで活性化): ハンドレイポインターでターゲットされたときにバウンズコントロールが表示されます。
Activate By Proximity and Pointer (近接時とポインターで活性化): ハンドレイポインターでターゲットされたときや多関節ハンドがオブジェクトに近づいたときにバウンズコントロールが表示されます。
Activate Manually (手動で活性化): バウンズコントロールは自動的には表示されません。boundsControl.Active プロパティにアクセスすることで、スクリプトを使って手動で活性化することができます。

Bounds Override (境界のオーバーライド)

境界の計算のためにオブジェクトからボックスコライダーを設定します。

Box Padding (ボックスのパディング)

バウンズコントロールの範囲を計算するために使用されるコライダーの境界にパディングを追加します。これはインタラクションだけでなく、ビジュアルにも影響を与えます。

Flatten Axis (平坦化軸)

バウンズコントロールが2次元になって1つの軸に沿った操作ができなくなるように、1つの軸について平坦化されるかどうかを示します。この機能は、スレートのような薄いオブジェクトに使用できます。 Flatten Axis が Flatten Auto に設定されている場合、スクリプトは自動的に最小の範囲を持つ軸を Flatten Axis として選択します。

Smoothing (スムージング)

スムージングのセクションでは、バウンズコントロールのスケールと回転に対するスムージングの動作を設定することができます。

Visuals (ビジュアル)

バウンズコントロールの見た目は、対応するビジュアルコンフィギュレーションの1つを変更することで設定できます。ビジュアルコンフィギュレーションはリンクされたオブジェクトかインラインのスクリプタブルオブジェクトで、詳細はコンフィギュレーションオブジェクトのセクションで説明されています。

Configuration Objects (設定オブジェクト)

バウンズコントロールには、スクリプタブルオブジェクトとして保存され、異なるインスタンスやプレハブ間で共有することができる設定オブジェクトのセットが付属しています。設定は、個々のスクリプタブルアセットファイルとして、またはプレハブ内にネストされたスクリプタブルアセットとして、共有したりリンクしたりすることができます。また、外部のスクリプタブルアセットやネストされたスクリプタブルアセットにリンクすることなく、インスタンス上で直接設定を定義することもできます。

バウンズコントロールのインスペクターは、設定が共有されているか、現在のインスタンスの一部としてインライン化されているかを、プロパティインスペクターにメッセージを表示することで示します。さらに、共有されたインスタンスはバウンズコントロールのプロパティウィンドウで直接編集することはできず、かわりに、共有された設定を誤って変更しないようにリンク先のアセットを直接修正しなければなりません。

現在のところ、バウンズコントロールは以下の機能のための設定オブジェクトのオプションを提供しています。

ハンドル
リンク / ワイヤーフレーム
ボックス表示
近接効果

Box Configuration (ボックス設定)

ボックス設定は、コライダーのサイズとボックスのパディングで定義された境界を持つソリッドボックスのレンダリングを担当します。以下のプロパティを設定可能です。

Box Material (ボックスのマテリアル): インタラクションが行われていないときにレンダリングされるボックスに適用されるマテリアルを定義します。ボックスは、このマテリアルが設定されている場合にのみレンダリングされます。
Box Grabbed Material (掴まれたボックスのマテリアル)：ユーザーがニアまたはファーインタラクションで掴んでバウンズコントロールとインタラクションしたときのボックスのマテリアルです。
Flatten Axis Display Scale (平坦化軸の表示スケール): 軸の1つが平坦化されている場合にボックスの表示に適用されるスケールです。

Scale Handles Configuration (拡大縮小ハンドル設定)

このプロパティでは、バウンズコントロールの拡大縮小ハンドルの動作や見た目を変更することができます。

Handle Material (ハンドルのマテリアル): ハンドルに適用されるマテリアルです。
Handle Grabbed Material (掴まれたハンドルのマテリアル): 掴まれたハンドルに適用されるマテリアルです。
Handle Prefab (ハンドルのプレハブ): 拡大縮小ハンドルのオプションのプレハブです。何も設定されていない場合は MRTK はデフォルトとしてキューブを使います。
Handle Size (ハンドルのサイズ): 拡大縮小ハンドルのサイズです。
Collider Padding (コライダーのパディング): ハンドルのコライダーに追加されるパディングです。
Draw Tether When Manipulating (操作時のテザー描画): アクティブにすると、インタラクションの開始点から現在の手またはポインタの位置までテザー線を描画します。
Handles Ignore Collider (ハンドルが無視するコライダー): コライダーがここにリンクされている場合、ハンドルはこのコライダーとの衝突を無視します。
Handle Slate Prefab (ハンドルスレートのプレハブ): バウンズコントロールが平坦化されたときにハンドルに使われるプレハブです。
Show Scale Handles (拡大縮小ハンドルを表示): ハンドルの表示をコントロールします。
Scale Behavior (拡大縮小動作): 一様もしくは不一様のスケーリングに設定できます。

Rotation Handles Configuration (回転ハンドル設定)

この設定では回転ハンドルの動作を定義します。

Handle Material (ハンドルのマテリアル): ハンドルに適用されるマテリアルです。
Handle Grabbed Material (掴まれたハンドルのマテリアル): 掴まれたハンドルに適用されるマテリアルです。
Handle Prefab (ハンドルのプレハブ): ハンドルのオプションのプレハブです。何も設定されていない場合は MRTK はデフォルトとして球を使います。
Handle Size (ハンドルのサイズ): ハンドルのサイズです。
Collider Padding (コライダーのパディング): ハンドルのコライダーに追加されるパディングです。
Draw Tether When Manipulating (操作時のテザー描画): アクティブにすると、インタラクションの開始点から現在の手またはポインタの位置までテザー線を描画します。
Handles Ignore Collider (ハンドルが無視するコライダー): コライダーがここにリンクされている場合、ハンドルはこのコライダーとの衝突を無視します。
Handle Prefab Collider Type (ハンドルプレハブのコライダータイプ): 作成されるハンドルに使われるコライダーのタイプです。
Show Handle For X (X のハンドル表示): X 軸のハンドル表示をコントロールします。
Show Handle For Y (Y のハンドル表示): Y 軸のハンドル表示をコントロールします。
Show Handle For Z (Z のハンドル表示): Z 軸のハンドル表示をコントロールします。

Translation Handles Configuration (移動ハンドル設定)

バウンズコントロールの移動ハンドルの有効化や設定ができます。移動ハンドルはデフォルトでは無効になっていることに注意してください。

Handle Material (ハンドルのマテリアル): ハンドルに適用されるマテリアルです。
Handle Grabbed Material (掴まれたハンドルのマテリアル): 掴まれたハンドルに適用されるマテリアルです。
Handle Prefab (ハンドルのプレハブ): ハンドルのオプションのプレハブです。何も設定されていない場合は MRTK はデフォルトとして球を使います。
Handle Size (ハンドルのサイズ): ハンドルのサイズです。
Collider Padding (コライダーのパディング): ハンドルのコライダーに追加されるパディングです。
Draw Tether When Manipulating (操作時のテザー描画): アクティブにすると、インタラクションの開始点から現在の手またはポインタの位置までテザー線を描画します。
Handles Ignore Collider (ハンドルが無視するコライダー): コライダーがここにリンクされている場合、ハンドルはこのコライダーとの衝突を無視します。
Handle Prefab Collider Type (ハンドルプレハブのコライダータイプ): 作成されるハンドルに使われるコライダーのタイプです。
Show Handle For X (X のハンドル表示): X 軸のハンドル表示をコントロールします。
Show Handle For Y (Y のハンドル表示): Y 軸のハンドル表示をコントロールします。
Show Handle For Z (Z のハンドル表示): Z 軸のハンドル表示をコントロールします。

Links Configuration (リンク設定) (ワイヤーフレーム)

リンク設定はバウンズコントロールのワイヤーフレーム機能を有効にします。以下のプロパティが設定可能です。

Wireframe Material (ワイヤーフレームのマテリアル): ワイヤーフレームのメッシュに適用されるマテリアルです。
Wireframe Edge Radius (ワイヤーフレームの辺の半径): ワイヤーフレームの厚みです。
Wireframe Shape (ワイヤーフレームの形状): ワイヤーフレームの形状を立方体か円柱のどちらかに設定できます。
Show Sireframe (ワイヤーフレームの表示): ワイヤーフレームの表示をコントロールします。

Proximity Effect Configuration (近接効果設定)

手との距離に応じたアニメーションでハンドルを表示・非表示します。2段階のスケーリングアニメーションがあります。デフォルトは HoloLens 2 スタイルの動作に設定されています。

Proximity Effect Active (近接効果の有効化): 近接ベースのハンドル有効化を有効にします。
Object Medium Proximity (オブジェクトへの中距離近接): 第1ステップスケーリングが実行される距離
Object Close Proximity (オブジェクトへの近距離近接): 第2ステップスケーリングが実行される距離
Far Scale (遠距離スケール): ハンドがバウンズコントロールのインタラクション範囲（上の 'Object Medium Proximity' で定義された距離）よりも外側にある場合のハンドルアセットのデフォルトスケール値（デフォルトでハンドルを非表示にする場合は 0 を利用してください)
Medium Scale (中距離スケール): ハンドがバウンズコントロールのインタラクション範囲（上の 'Object Medium Proximity' で定義された距離）の内側にある場合のハンドルアセットのスケール値（通常サイズで表示するには 1 を利用してください)
Close Scale (近距離スケール): ハンドがグラブインタラクション範囲（上の 'Object Close Proximity' で定義された距離）の内側にある場合のハンドルアセットのスケール値（拡大したサイズで表示するには 1.x を利用してください)
Far Grow Rate (遠距離での成長率): ハンドが中距離近接から遠距離近接へと移動したときの、近接スケールされたオブジェクトをスケールさせる割合です。
Medium Grow Rate (中距離での成長率): ハンドが中距離近接から近距離近接へと移動したときの、近接スケールされたオブジェクトをスケールさせる割合です。
Close Grow Rate (近距離での成長率): ハンドが近距離近接からオブジェクト中心へと移動したときの、近接スケールされたオブジェクトをスケールさせる割合です。

Constraint System (コンストレイントシステム)

バウンズコントロールはコンストレイントマネージャーを使用して、バウンズコントロールハンドルを使用している際の移動、回転、スケーリングの動作を制限または変更することをサポートしています。

インスペクターのプロパティでは、同じゲームオブジェクトにアタッチされているすべての利用可能なコンストレイントマネージャがドロップダウンで表示され、スクロールや選択されているコンストレイントマネージャーのハイライト表示ができます。

Events (イベント)

バウンズコントロールは以下のイベントを提供します。この例では、これらのイベントを使用してオーディオフィードバックを再生します。

Rotate Started (回転開始): 回転が開始したときに発火されます。
Rotate Stopped (回転終了): 回転が終了したときに発火されます。
Scale Started (拡大縮小開始): 拡大縮小が開始したときに発火されます。
Scale Stopped (拡大縮小終了): 拡大縮小が終了したときに発火されます。
Translate Started (移動開始): 移動が開始したときに発火されます。
Translate Stopped (移動終了): 移動が終了したときに発火されます。

Elastics (エラスティックス) [Experimental]

エラスティックスはバウンズコントロールでオブジェクトを操作する際に使用することができます。Elastics System (エラスティックスシステム) はまだ実験段階であることにご注意ください。エラスティックスを有効にするには、既存のエラスティックスマネージャーコンポーネントをリンクするか、Add Elastics Manager ボタンを使って新しいエラスティックスマネージャーを作成してリンクします。

ハンドルのスタイル

デフォルトでは、単に BoundsControl.cs スクリプトを割り当てた場合、HoloLens 第1世代スタイルのハンドルが表示されます。HoloLens 2 スタイルのハンドルを使うには、適切なハンドルのプレハブとマテリアルを割り当てる必要があります。

Bounds Control

以下に、HoloLens 2 スタイルのバウンズコントロールハンドルのためのプレハブ、マテリアル、スケーリング値を示します。このサンプルは BoundsControlExamples シーンにあります。

ハンドル (HoloLens 2 スタイルのセットアップ)

Handle Material (ハンドルのマテリアル): BoundingBoxHandleWhite.mat
Handle Grabbed Material (掴まれたハンドルのマテリアル): BoundingBoxHandleBlueGrabbed.mat
Scale Handle Prefab (拡大縮小ハンドルのプレハブ: MRTK_BoundingBox_ScaleHandle.prefab
Scale Handle Slate Prefab (スレートの拡大縮小ハンドルのプレハブ): MRTK_BoundingBox_ScaleHandle_Slate.prefab
Scale Handle Size (拡大縮小ハンドルのサイズ): 0.016 (1.6cm)
Scale Handle Collider Padding (拡大縮小ハンドルのコライダーのパディング): 0.016 (掴めるコライダーをハンドルの見た目よりも少し大きくします)
Rotation Handle Prefab (回転ハンドルのプレハブ): MRTK_BoundingBox_RotateHandle.prefab
Rotation Handle Size (回転ハンドルのサイズ): 0.016
Rotation Handle Collider Padding (回転ハンドルのコライダーのパディング): 0.016 (掴めるコライダーをハンドルの見た目よりも少し大きくします)

Object Manipulator での Transform の変更

バウンズコントロールを ObjectManipulator.cs と組み合わせて使用することで、ハンドルを使用せずに特定のタイプのマニピュレーション (例えばオブジェクトに移動) を行うことができます。オブジェクトマニピュレーターは片手と両手の両方のインタラクションをサポートしています。ハンドトラッキングを使用して、オブジェクトと近くでインタラクションすることができます。

バウンズコントロールのエッジを ObjectManipulator のファーインタラクションを使って動かしたときと同じように動作させるには、上のスクリーンショットのように On Manipulation Started / On Manipulation Ended のイベントをそれぞれ BoundsControl.HighlightWires / BoundsControl.UnhighlightWires に接続することをおすすめします。

Unity のインスペクターを使ったバウンズコントロールの追加設定方法

オブジェクトに Box Collider を追加します
オブジェクトに BoundsControl スクリプトを割り当てます
'Activation' メソッドのようなオプションを設定します (インスペクターのプロパティセクションをご覧ください)
(オプション) HoloLens 2 スタイルのバウンズコントロールのためにプレハブとマテリアルを割り当てます (ハンドルのスタイルセクションをご覧ください)

Note

インスペクターの Target Object と Bounds Override フィールドを使用することで、複数の子コンポーネントを持つオブジェクトに特定のオブジェクトとコライダーを割り当てることができます。

Bounds Control

コードでのバウンズコントロールの追加設定方法

キューブの GameObject を生成します

GameObject cube = GameObject.CreatePrimitive(PrimitiveType.Cube);

AddComponent<>() を使ってコライダーを持つオブジェクトに BoundsControl スクリプトを割り当てます
```
private BoundsControl boundsControl;
boundsControl = cube.AddComponent<BoundsControl>();
```

バウンズコントロール上またはスクリプタブルコンフィギュレーションのいずれかにおいてオプションを設定します (インスペクターのプロパティと設定のセクションをご覧ください)

 // 有効化方法を変更する
 boundsControl.BoundsControlActivation = BoundsControlActivationType.ActivateByProximityAndPointer;
// 拡大縮小ハンドルを大きくする
boundsControl.ScaleHandlesConfig.HandleSize = 0.1f;
// X 軸の回転ハンドルを非表示にする
boundsControl.RotationHandlesConfig.ShowRotationHandleForX = false;

(オプション) HoloLens 2 スタイルのバウンズコントロールのためにプレハブとマテリアルを割り当てます。マテリアルとプレハブは動的にロードされなければならないので、これはまだインスペクターを通した割り当てが必要となります。

Note

Unity の 'Resources' フォルダーや Shader.Find を使って動的にシェーダーをロードすることは、シェーダーの組み合わせが実行時に見つからない可能性があるため推奨されません。

BoxDisplayConfiguration boxConfiguration = boundsControl.BoxDisplayConfig;
boxConfiguration.BoxMaterial = [Assign BoundingBox.mat]
boxConfiguration.BoxGrabbedMaterial = [Assign BoundingBoxGrabbed.mat]
ScaleHandlesConfiguration scaleHandleConfiguration = boundsControl.ScaleHandlesConfig;
scaleHandleConfiguration.HandleMaterial = [Assign BoundingBoxHandleWhite.mat]
scaleHandleConfiguration.HandleGrabbedMaterial = [Assign BoundingBoxHandleBlueGrabbed.mat]
scaleHandleConfiguration.HandlePrefab = [Assign MRTK_BoundingBox_ScaleHandle.prefab]
scaleHandleConfiguration.HandleSlatePrefab = [Assign MRTK_BoundingBox_ScaleHandle_Slate.prefab]
scaleHandleConfiguration.HandleSize = 0.016f;
scaleHandleConfiguration.ColliderPadding = 0.016f;
RotationHandlesConfiguration rotationHandleConfiguration = boundsControl.RotationHandlesConfig;
rotationHandleConfiguration.HandleMaterial = [Assign BoundingBoxHandleWhite.mat]
rotationHandleConfiguration.HandleGrabbedMaterial = [Assign BoundingBoxHandleBlueGrabbed.mat]
rotationHandleConfiguration.HandlePrefab = [Assign MRTK_BoundingBox_RotateHandle.prefab]
rotationHandleConfiguration.HandleSize = 0.016f;
rotationHandleConfiguration.ColliderPadding = 0.016f;

例: MinMaxScaleConstraint を使ってバウンズコントロールの最小スケール最大スケールを設定する

最小スケール最大スケールを設定するには、 MinMaxScaleConstraint をバウンズコントロールに追加します。バウンズコントロールはコンストレイントマネージャーを自動的にアタッチして有効にするため、MinMaxScaleConstraint がアタッチされて設定されると、MinMaxScaleConstraint は Transform の変更に自動的に適用されます。

MinMaxScaleConstraint は ObjectManipulator の最小スケール最大スケールを設定するためにも利用できます。

GameObject cube = GameObject.CreatePrimitive(PrimitiveType.Cube);
bcontrol = cube.AddComponent<BoundsControl>();
// 重要: BoundsControl はスタート時にコンストレイント マネージャーが存在しない場合は作成します。
// 手動でコンストレイント マネージャーをアタッチする必要はありません。
MinMaxScaleConstraint scaleConstraint = bcontrol.gameObject.AddComponent<MinMaxScaleConstraint>();
scaleConstraint.ScaleMinimum = 1f;
scaleConstraint.ScaleMaximum = 2f;

例: バウンズコントロールをゲームオブジェクトの周囲に追加する

オブジェクトの周囲にバウンズコントロールを追加するには、単に BoundsControl コンポーネントを追加します。

private void PutABoundsControlAroundIt(GameObject target)
{
   target.AddComponent<BoundsControl>();
}

Bounding Box からの移行

既存のプレハブや、Bounding Box を使用しているインスタンスは、MRTK Tools パッケージの一部である Migration Window を使用して、新しいバウンズコントロールにアップグレードすることができます。

Bounding Box の個々のインスタンスをアップグレードするために、コンポーネントのプロパティインスペクターの中に移行オプションもあります。

日本語翻訳ドキュメントはサポートを終了しました

Bounds Control (バウンズコントロール)

サンプルシーン

インスペクターのプロパティ

Target Object (対象オブジェクト)

Activation Behavior (活性化の動作)

Bounds Override (境界のオーバーライド)

Box Padding (ボックスのパディング)

Flatten Axis (平坦化軸)

Smoothing (スムージング)

Visuals (ビジュアル)

Configuration Objects (設定オブジェクト)

Box Configuration (ボックス設定)

Scale Handles Configuration (拡大縮小ハンドル設定)

Rotation Handles Configuration (回転ハンドル設定)

Translation Handles Configuration (移動ハンドル設定)

Links Configuration (リンク設定) (ワイヤーフレーム)

Proximity Effect Configuration (近接効果設定)

Constraint System (コンストレイントシステム)

Events (イベント)

Elastics (エラスティックス) [Experimental]

ハンドルのスタイル

ハンドル (HoloLens 2 スタイルのセットアップ)

Object Manipulator での Transform の変更

Unity のインスペクターを使ったバウンズコントロールの追加設定方法

Note

コードでのバウンズコントロールの追加設定方法

Note

例: MinMaxScaleConstraint を使ってバウンズコントロールの最小スケール最大スケールを設定する

例: バウンズコントロールをゲームオブジェクトの周囲に追加する

Bounding Box からの移行

関連項目

Bounds Control (バウンズ コントロール)

サンプル シーン

インスペクターのプロパティ

Target Object (対象オブジェクト)

Activation Behavior (活性化の動作)

Bounds Override (境界のオーバーライド)

Box Padding (ボックスのパディング)

Flatten Axis (平坦化軸)

Smoothing (スムージング)

Visuals (ビジュアル)

Configuration Objects (設定オブジェクト)

Box Configuration (ボックス設定)

Scale Handles Configuration (拡大縮小ハンドル設定)

Rotation Handles Configuration (回転ハンドル設定)

Translation Handles Configuration (移動ハンドル設定)

Links Configuration (リンク設定) (ワイヤーフレーム)

Proximity Effect Configuration (近接効果設定)

Constraint System (コンストレイント システム)

Events (イベント)

Elastics (エラスティックス) [Experimental]

ハンドルのスタイル

ハンドル (HoloLens 2 スタイルのセットアップ)

Object Manipulator での Transform の変更

Unity のインスペクターを使ったバウンズ コントロールの追加設定方法

Note

コードでのバウンズ コントロールの追加設定方法

Note

例: MinMaxScaleConstraint を使ってバウンズ コントロールの最小スケール最大スケールを設定する

例: バウンズ コントロールをゲーム オブジェクトの周囲に追加する

Bounding Box からの移行

関連項目

Bounds Control (バウンズコントロール)

サンプルシーン

Constraint System (コンストレイントシステム)

Unity のインスペクターを使ったバウンズコントロールの追加設定方法

コードでのバウンズコントロールの追加設定方法

例: MinMaxScaleConstraint を使ってバウンズコントロールの最小スケール最大スケールを設定する

例: バウンズコントロールをゲームオブジェクトの周囲に追加する