async/awaitとは？ async/awaitは、C#で非同期処理を書くための構文です。 時間のかかる処理を実行している間にメインの処理をブロックせず、完了を待ってから続きを実行できます。 本来、非同期処理はコールバックやスレッド管理が必要で複雑になりがちですが、 async/awaitを使うと、見た目は同期処理のように直列なコードで非同期の流れを記述できます。 外部記事 非同期プログラミング - C# async、await、Task、および Task を使用して非同期プログラミングを行うための C# 言語サポートの概要を探る。 learn.microsoft.com Unityでは従来、フレームを跨ぐ処理にCoroutineを使うのが定番でしたが、 C#本来の機能であるasync/awaitも利用でき、Unity 2023.1以降ではAwaitableというUnity独自の型も追加されています。 AwaitableはTaskより軽量で、Unityのフレーム単位の待機にも対応した型ですが、本記事ではまず標準のasync/awaitとTaskの基本に絞って解説します。

コルーチンとは？ Unityでゲームを作っていると、「3秒待ってから次の処理を実行したい」「フェードアウトを少しずつ進めたい」といった、時間に関わる処理を書きたくなる場面が出てきます。 こうした処理をUpdateだけで書こうとすると、経過時間を測るための変数を用意し、毎フレーム加算して、しきい値を超えたかどうかを判定して……と、コードがあっという間に膨らんでいきます。 using UnityEngine; public class WaitWithUpdate : MonoBehaviour { private float _elapsedTime; private bool _isWaiting = true; private void Update() { if (_isWaiting) { // 経過時間を加算する _elapsedTime += Time.deltaTime; // 3秒経過したかチェックする if (_elapsedTime >= 3f) { Debug.Log("3秒経過しました"); _isWaiting = false; } } } } たった「3秒待ちたい」だけなのに、状態を管理するフラグや経過時間の変数が必要になってしまいます。 こんなときに便利なのがコルーチン（Coroutine）です。 コルーチンを使うと、処理の途中で一時停止して、後で再開するような書き方ができます。 Updateに状態管理を持ち込まずに、自然な流れで「待つ」処理を書けるのが利点です。 Unity Docs Unity - Manual: Write and run coroutines docs.unity3d.com 先ほどの3秒待つ処理を、コルーチンで書き直してみると以下のようになります。 using System.Collections; using UnityEngine; public class WaitWithCoroutine : MonoBehaviour { private void Start() { // コルーチンを開始する StartCoroutine(WaitAndLog()); } private IEnumerator WaitAndLog() { // 3秒待つ yield return new WaitForSeconds(3f); Debug.Log("3秒経過しました"); } } フラグも経過時間の変数もなくなり、コードを上から下へ追うだけで処理の流れが読み取れます。

Versionクラスとは？ Versionはバージョン番号を表現するためのC#標準のクラスです。 System名前空間にあるので、追加のパッケージは必要ありません。 バージョンをMajor.Minor.Build.Revisionの4つの数値として保持し、 大小比較や文字列からの変換を用意してくれています。 外部記事 Version クラス (System) アセンブリ、オペレーティング システム、または共通言語ランタイムのバージョン番号を表します。 このクラスは継承できません。 learn.microsoft.com

Tag / Layer / LayerMask とは？ Unityでオブジェクトを扱っていると、「これは敵かどうか判定したい」「カメラに映すものを制限したい」「Raycastで特定の対象だけ拾いたい」といった場面が出てきます。 これらを実現するために用意されているのがTag、Layer、LayerMaskの3つです。 役割を一言でまとめると以下のようになります。 機能 役割 主な用途 Tag オブジェクトを文字列で識別する プレイヤーや敵の判定、Find系メソッド Layer オブジェクトを整数で分類する Cameraの描画制御、Physicsの衝突制御 LayerMask 複数のLayerをビット表現で扱う Physics.RaycastなどのAPI引数 どれも似ているように見えますが、それぞれ得意な領域があります。 どの場面でどれを使うのか、順を追って見ていきます。 Unity Docs Unity - Manual: Tags and Layers project settings reference docs.unity3d.com

Time.deltaTimeとは？ Time.deltaTimeは、前回のフレームから今回のフレームまでに経過した時間を秒単位で表す値です。 なぜこの値が重要かというと、ゲームの処理はフレーム単位で実行されるため、各フレームの間隔は一定とは限らないからです。 例えば60FPSで動作している場合、1フレームあたりのTime.deltaTimeはおよそ0.0167秒（1/60秒）になります。 一方30FPSに下がれば、1フレームあたりおよそ0.0333秒（1/30秒）になります。 Time.deltaTimeは実行環境やフレームレートによって変動するので、これを掛け合わせればフレームレートに左右されない処理になります。 Unity Docs Time-deltaTime - Unity スクリプトリファレンス The interval in seconds from the last frame to the current one (Read Only). docs.unity3d.com

AspectRatioFitterとは？ AspectRatioFitterは、UnityのUIシステムの一部で、 RectTransformを指定したアスペクト比(縦横比)を保ったままリサイズする機能を提供します。 例えばサムネイル画像やムービーをUIに表示するとき、親のサイズに合わせて引き伸ばすと縦横比が崩れて不格好になってしまいます。 AspectRatioFitterを使えば、画面サイズや親の大きさが変わっても、常に元の比率を維持したまま表示できます。 Unity Docs Aspect Ratio Fitter - Unity マニュアル Aspect Ratio Fitter はそれ自体のレイアウト要素のサイズを管理するレイアウトコントローラーとして機能します。これを使用することで、高さを幅に合わせたり、もしくはその逆に調整することができます。また、要素を親の内側に収まるようにしたり、親を覆うようにすることもできます。Aspect Ratio Fitter は 最小サイズや推奨サイズといったレイアウト情報を考慮しません。 docs.unity3d.com

DontDestroyOnLoadとは？ DontDestroyOnLoadとは、シーンを切り替えても指定したGameObjectを破棄せずに残し続けるためのUnityのメソッドです。 通常、SceneManager.LoadSceneなどで別のシーンを読み込むと、それまでのシーンに存在していたGameObjectはすべて破棄されます。 しかしゲームを作っていると、シーンが変わってもずっと存在し続けてほしいオブジェクトが出てきます。 そういったオブジェクトをDontDestroyOnLoadに登録しておくと、シーン遷移をまたいでも破棄されず、状態を保持したまま生き続けます。 // このGameObjectをシーン遷移後も破棄しないようにする DontDestroyOnLoad(gameObject); Unity Docs Unity - Scripting API: Object.DontDestroyOnLoad docs.unity3d.com 🔗 関連記事 シーンの切り替えそのものについてはSceneManagerの記事で解説しています。 【Unity】SceneManagerの使い方 SceneManagerのLoadScene、Additive、非同期ロード、シーン間のデータ受け渡しを実装例付きで解説します。 GARNET LOG あとで読む

SceneManagerとは？ SceneManagerは、Unityでシーンの読み込みやアンロードを行うためのクラスです。 タイトル画面からゲーム本編へ移動したり、ステージごとにシーンを分けて切り替えたりと、ゲーム制作では必ず登場する仕組みですね。 UnityEngine.SceneManagement名前空間に含まれており、using UnityEngine.SceneManagement;を書けば利用できます。 Unity Docs SceneManagement.SceneManager - Unity スクリプトリファレンス 実行時のシーン管理 docs.unity3d.com そして、シーンを切り替えた時に消えてほしくないオブジェクト（BGMを鳴らすAudioSourceや、各種マネージャークラスなど）を持ち越すにはDontDestroyOnLoadを使います。 DontDestroyOnLoadは専用の記事で詳しく解説しているので、本記事ではSceneManagerを中心に扱います。 🔗 関連記事 DontDestroyOnLoadでオブジェクトを永続化させるには。 【Unity】DontDestroyOnLoadの使い方｜シーン遷移でオブジェクトを残す方法と重複防止 DontDestroyOnLoadでシーンを切り替えてもGameObjectを残す方法を解説。Singletonと組み合わせた重複生成の防止、解除の方法、シーン側の参照が切れる注意点まで紹介します。 GARNET LOG あとで読む

Unityでスクリプトを書いていると、ConsoleにCS0246やCS0103といった番号付きのエラーが表示されます。 このCSから始まる番号は、C#コンパイラがエラーの種類を区別するためのコードです。 慣れないと原因を理解するのが大変かもしれませんが、 長い英語メッセージを最初からすべて読むより、まず番号を見ると確認箇所を絞れます。 この記事では、Unity開発で遭遇しやすいコンパイルエラーを、エラーになるコードと修正後のコードを並べて説明します。 探している番号やメッセージをページ内検索すれば、該当する項目へ直接移動できます。 Consoleウィンドウの開き方、絞り込み、ファイルと行番号の確認方法は別の記事で解説しています。 記事末尾の関連ページから参照してください。 🔗 関連記事 Consoleウィンドウの開き方や、エラーだけに絞り込んで行番号を確認する手順はこちらで解説しています。 【Unity】Consoleのログが流れて読めないときの設定｜重複まとめ・エラーで一時停止・タイムスタンプ Consoleウィンドウのログを追いやすくする設定を解説。Collapseによる重複まとめ、Error Pauseでのエラー時停止、タイムスタンプの表示や行数変更まで、デバッグを効率化する使い方を紹介します。 GARNET LOG あとで読む よくあるコンパイルエラー早見表 エラー 主な原因 CS0246 型、名前空間、パッケージが見つからない CS0103 変数名やメソッド名が現在のスコープに存在しない CS1061 対象の型に指定したメンバーがない CS0029 代入元と代入先の型が一致していない CS0117 型に指定した静的メンバーがない CS0120 インスタンスが必要なメンバーを型から呼んでいる CS0019 指定した型の組み合わせでは演算子を使用できない CS0234 名前空間内に指定した型や名前空間がない CS1002 セミコロンが不足している CS1513 閉じ波括弧が不足している 表の「主な原因」は、最初に調べる場所を示したものです。同じ番号でも、メッセージ内の型名やメンバー名はコードによって変わります。 まずエラー番号とメッセージ内の型名・メンバー名を、手元の表示と照合してください。一致したら、失敗例とコードを比べ、原因に合う確認項目を順に追います。

RectTransformの重なり判定とは？ UIを作っていると、2つのUI要素が重なっているかどうかを判定したい場面があります。 たとえば以下のようなケースです。 ドラッグ&ドロップで、アイテムをスロットに重ねたときの判定 UI同士が重なっていないかのチェック 特定のエリアにUI要素が入ったかどうかの検出 こうした判定は、RectTransformの矩形情報を使えば実現できます。