コードインスペクション：代替の非割り当てメソッドが利用可能

レイキャスティングおよび衝突検出のメソッドで、 Physicsや Physics2Dオブジェクトが配列を返す場合、呼び出しごとに配列が割り当てられるため、頻繁に呼び出すとパフォーマンスに影響することがあります。 Unity 5.3では、結果を収集するために事前に割り当てた配列を渡せる、非割り当てバージョンのこれらのメソッドが導入されました。

このインスペクションは、これらのメソッドの割り当てバージョンに警告を追加し、呼び出しを割り当てなしバージョンに書き換えるための簡単な vix を提供し、テキストキャレットを既存の配列を参照する場所に残します。

Physics クラスの関連メソッドは以下のとおりです。

そして Physics2D の場合:

配列のサイズによって、これらの非割り当てメソッドで収集できる結果の最大数が決まることに注意してください。これらのメソッドは配列のサイズを変更せず、さらに結果が返される可能性があった場合でも通知しません。この配列の適切なサイズは、可能な最大結果数を決定するか、それ以上の結果が不要になる制限を選択することによって、ユーザー自身が選択する必要があります。すべてのヒットを処理することが重要な場合は、割り当てバージョンを唯一の選択肢として使用する必要がありますが、繰り返し割り当てを行うことによるパフォーマンスのオーバーヘッドに注意することが重要です。この警告は、コードコメントを使用するか、ハイライトの重要度を変更することで抑制できます。

詳細については、 Unity パフォーマンスのベストプラクティスに関する文書(英語)を参照してください。

2026 年 6 月 12 日