はてなブックマーク

Unityでasync/await、Taskを実用レベルでしっかり理解するために必要な情報をまとめました。 はじめに - async?await?Taskとは? MonoBehaviourのメソッド（Startとか）を非同期メソッドにする 結果を返すTaskを作る 複数のTaskを直列で実行する 複数のTaskを並列で実行する Taskをキャンセルする 例外処理について タイムアウト処理 await後に元のスレッドに戻さない 参考 Unity2018.2 C#6 はじめに - async?await?Taskとは? async/await、Taskを学ぶ上で最初にするべきことは非同期処理の概念を理解することです。 次の記事では非同期処理の概念とasync/await、Taskの基本的な使い方をわかりやすく説明しています。 必要に応じて参照してください。 light11.hatenadiar

Unityプロジェクトをあらゆる観点から静的解析してくれる公式ツール『Project Auditor』の使い方をまとめました はじめに インストール 基本的な使い方 解析実行フロー ビルドレポートを見る場合 スクリプトから実行する 各解析項目の説明 Code > Diagnostics Code > Assemblies Code > C# Compiler Messages Assets > Resources Assets > Shaders Assets > Shader Variants Settings > Diagnostics Build Report > Steps Build Report > Size 参考 Unity 2021.3.0f1 Project Auditor 0.8.1-preview はじめに Project Auditor を使うと Unity プロジ

効率的なスクロールビューを実装するためのOSS『Loop Scroll Rect』使い方をまとめました。 Loop Scroll Rectとは？ シンプルなスクロールビューを実装する スクロールビューを作成する 要素のPrefabを作成する スクリプトを作成する 動作確認 オブジェクトを使い回す 無限ループするビューを作る 要素ごとに高さを変える 要素ごとにPrefabを変える グリッドスクロールビューを実装する 参考 Unity 2020.3.15f2 Loop Scroll Rect 1.1.0 Loop Scroll Rectとは？ Unity標準のスクロールビューは、要素の数が増えるほど処理負荷とメモリの使用量が大きくなるため、スケール可能にするためには工夫が必要です。 例えば表示範囲外のGameObjectを非アクティブにしたり、オブジェクトプールを使って使い回したりすることが考

UnityのAddressableアセットシステムで同期ロードが公式にサポートされたので、その使い方とResources.Loadを置き換える方法についてまとめました。 Addressablesと同期ロード 今までは非同期なロード方法しかなかった 同期ロードが公式サポートされた 同期ロードの仕方 Resources.Loadと置き換えるには Addlerを使って一行で書く さらにシンプルに書く ついでにEZAddresserを宣伝（Resourcesライクなアドレスを自動的に付与する） 同期ロード使用時の注意点 すべてのAsyncOperationが終わるまで待機される Unity2021.2.0以降じゃないと遅い（どの程度遅いかは謎） ダウンロードには原則使わない 関連 参考 Unity2019.4.0 Addressbles 1.17.4 Addressablesと同期ロード 今までは

UniTaskのキャンセル処理についてまとめました。 非同期メソッドのキャンセル方法 Taskの場合 UniTaskの場合 UnityのAsyncOperation系 GameObjectのライフサイクルに紐づいたCancellationToken キャンセルのハンドリング方法 基本的にはtry-catch SuppressCancellationThrowでキャンセル状態を戻り値として得る Unity2020.1.10 UniTask 2.0.37 非同期メソッドのキャンセル方法 まず非同期メソッドのキャンセル方法についてまとめます。 Taskの場合 UniTaskについて書く前にTaskについてまとめます。 Taskをキャンセルにするには、以下のようにCancellationTokenを非同期メソッドに渡します。 using System.Threading; using System

Unityエディタ上でスマホ実機がシミュレーションできるDevice Simulatorの使い方をまとめました。 Device Simulator? インストール 基本操作 カスタムアセンブリに設定を反映する カスタムデバイスを追加する 参考 Unity2020.2.7f1 Device Simulator 2.2.4-preview Device Simulator? Device Simulatorを使うとゲームが実際に実機上でどのように見えるかをシミュレートできます。 Device Simulator インストール Device SimulatorはUnity2021以降ではUnityに組み込まれるようですが、 インストールされていなかったらPackage Managerからインストールしてください。 Package Managerについては以下の記事にまとめていますので必要に応じて

UnityのuGUIをTimelineで制御できる「Unity UI Playables」を公開しました。 github.com 概要 Unity UI(uGUI)をタイムラインで制御可能 イージング、アニメーションカーブに対応 ブレンド可能 使い方 インストール トラックとクリップを作成 制御できるパラメータ一覧 デモ ライセンス リポジトリ 概要 Unity UI PlayablesはUnity UI(uGUI)をTimelineで制御するためのTrackやClipのセットです。 Demo Unity UI(uGUI)をタイムラインで制御可能 あらゆるuGUIのコンポーネントとそのパラメータを制御することができます。 uGUIをタイムラインで制御 イージング、アニメーションカーブに対応 アニメーションはイージング関数を使って簡単に設定することができます。 また、複雑なアニメーションを作

Unityのシェーダでプロシージャルに髪のハイライトを作る方法です。 やりたいこと binormalを使ってハイライトを作る jitterテクスチャを使う 結果 関連 Unity2019.2.18 やりたいこと この記事では下図のような感じの髪のハイライト表現をシェーダで作ります。 ハイライト 適用したもの 制約として、処理負荷はモバイルでも使えるくらい軽いものを目指すものとします。 binormalを使ってハイライトを作る ブリンフォン鏡面反射モデルでは、ハーフベクトルと法線の内積を使ってスペキュラを表現します。 スペキュラ ここで、法線の代わりに従法線を使うと以下のような結果が得られます。 従法線を使う この性質を利用して、従法線をハーフベクトルの内積値を上手く加工してハイライト表現を作ってみます。 シェーダは以下のように書きます。 Shader "HairHighlight" { P

Unity2020.2から使えるC#8の機能をまとめました。 Unity2020.2からC#8の機能が使えるようになりました 使えない機能 readonly members Switchが式として使えるように パターンマッチングの強化 プロパティパターン タプルパターン 位置指定パターン（Positional Patterns） using宣言 静的ローカル関数 破棄可能なref構造体 null参照許容型 null合体割り当て演算子 Genericな構造体のアンマネージドの取り扱い 文字列挿入の書き方 関連 参考 Unity2020.2.3 Unity2020.2からC#8の機能が使えるようになりました Unity2020.2のアップデートで、C#8の機能の大部分が使えるようになりました。 以下のページに列挙されている機能のうち一部機能を除いたものが使えます。 docs.microsoft

UnityでDIコンテナVContainerの使う方法についてまとめました。 はじめに インストール シンプルな（Service Collectionのような）IoC Containerとして使ってみる VContainerの基本的な使い方 IInitializable以外のライフサイクルイベント 生存期間を管理するLifetime LifetimeScopeの親子関係の設定方法 LifetimeScopeのInspectorから 子のシーンやPrefabを読みこんで設定する コードベースで子を生成する IContainerBuilderに登録を行う方法まとめ 色んな依存性注入方法 基本的なインジェクション 該当する型のインスタンスを全て注入 IObjectResolverを注入する 参考 Unity2020.1.10 VContainer 1.4.0 はじめに VContainerはUn

UnityにMicrosoft.Extensions.DependencyInjectionを導入する方法と、ServiceCollectionの基本的な使い方についてまとめました。 はじめに インストール 基本的な使い方 サービスの有効期間 参考 Unity2020.1.10 (Api Compatibility Level : .NET Standard 2.0) はじめに 本記事ではUnity（ゲームエンジンの方）にMicrosoft.Extensions.DependencyInjectionを導入する方法とその使い方についてまとめます。 www.nuget.org UnityにはVContainer（下記）のような素晴らしいDIライブラリがあるので実際にこれを使う機会はないかもしれませんが、 DIのコアな部分のみの実装となるためDIの基本的なコンセプトと使い方を学ぶためには良いと

Taskのマルチスレッドを実現するための機能という側面からUniTaskについて考えてみます。 はじめに SynchronizationContextとは？ TaskAwaiterとTaskのスレッド管理 UniTaskはSynchronizationContextを使わない UniTaskでマルチスレッド 参考 Unity2020.1.10 UniTask 2.0.37 はじめに UniTaskはUnityにおいてTaskの代わりに使えるように作られたライブラリで、処理効率に優れています。 github.com Taskの代わりといいましたが、Taskの役割には「非同期処理」と「マルチスレッド」という二つの側面があります。 そしてこのUniTaskはどちらかというとこのうちの非同期処理の方を代替するためのものとのことです。 UniTaskはどちらかというとJavaScript的（シングル

マルチスレッドプログラミングの概要と、そのメリット・デメリットについて簡単にまとめます。 マルチスレッドプログラミングとは? 効果1 処理時間が短縮される 効果2 画面のフリーズを防ぐ マルチスレッドで処理してみる 効果があるのはあくまでCPUの処理 参考 関連 Unity2018.3.9 （C#の記事ですがUnityを使って動作確認しています） マルチスレッドプログラミングとは? まずマルチスレッドでないプログラムでは、1つのCPUコアで処理を先頭から順番に行っていきます。 CPUコアを一つしか持たないシングルコアのCPUではもちろん、 マルチコアのCPUにであっても一つのCPUだけを使って処理を行います。並列では行いません。 ここでマルチスレッドのプログラムを書くと、マルチコアCPUではスレッド毎に別のCPUコアで別の処理を行います。 シングルコアのCPUでは、一つのCPUコアで処理を

なんとなく雰囲気で設定されがち(?)なCanvasのRender Modeについてわかりやすくまとめてみました。 基本的な考え方 World Space Screen-Space Camera Screen-Space Overlay Unity2018.3.1 基本的な考え方 平面上に表示されるGUIも結局は3D空間上に置かれたGameObjectなので、Cameraに映すことで描画されます。 CanvasのRender Modeとは「GUIをカメラにどのように映すか」を設定する項目です。 Render Modeには下記の三つが存在します。 Screen-Space Overlay Screen-Space Camera World Space 以下、この三つについて説明していきます。 World Space まずRender ModeをWorld Spaceにします。 この設定は一番使

Unity2020のリリースと同時にverifiedとなった新しいInput Systemの使い方をざっとまとめます。 全体感を把握することを目的としているので細かい部分の説明は割愛します。 インストール 基本的な入力の受け取り方（UI以外） Input Actionアセットを作る Input Actionを制御するスクリプトを自動生成する 入力を受け取る 入力イベントの色々な受け取り方 インタフェースを実装する コールバックを登録する ポーリングする より手軽に入力を受け取れるPlayerInput ActionやActionMapをMonoBehaviourに直接シリアライズする uGUIとの連携 参考 Unity2020.1 Input System 1.0.0 インストール Input SystemのインストールはPackage Managerから行います。 （PackageMan

Addressableがいい感じになってきたしそろそろResourcesフォルダを使った開発を卒業しようという話です。 Resourcesフォルダは非推奨 なぜ非推奨なのか？ Resourcesを使ってもいいケース Addressableアセットシステムを使う 「アドレス」を使ってロードする 設定一つで組み込み/DLCを切り替え プロトタイプからAssetBundleに移行するためのコストがゼロに 厳密なメモリ管理 実際にAddressableをResourcesの代わりとして使ってみる アドレスを登録する 読み込みスクリプトを書く 実機ビルドする Addressableのビルドを自動化する 同期ロードもサポートされた（2021.06.08追記） 便利ツールの紹介 アドレス設定を自動化するEZAddresser Unity Addressable Importer Addressableア

Unityで参照をシリアライズするSerializeReferenceアトリビュートについてまとめました。 はじめに 注意点：結構バグってた 以前書いた記事 SerializeFieldを復習する プリミティブ型・構造体をシリアライズできる UnityEngine.Objectの派生型の参照をシリアライズできる 非UnityEngine.Objectなクラスのインスタンスは値としてシリアライズできる 抽象クラスやインタフェースには非対応 Genericな型はシリアライズできる（Unity2020.1から） SerializeReferenceの仕様を理解する SerializeReferenceは非UnityEngine.Objectのための機能 参照をシリアライズする 抽象型やインタフェース型のフィールドをシリアライズできる 参照を二つのMonoBehaviour間で共有することはできな

.NET関連のフレームワークは概念も歴史も複雑でよくわからなくなりがちです。 .NET 5という大きい転換点が訪れるこのタイミングで、現時点で.NETの理解に必要な知識をざっとまとめてみました。 はじめに.NET Frameworkありき いろんな言語で書ける.NET Frameworkの思想 マルチプラットフォームの.NET Core .NETの互換環境であるMono / Xamarin .NET Standardで互換性を担保 そして.NET 5へ 参考 はじめに.NET Frameworkありき .NETをめぐる物語は2000年にマイクロソフトがMicrosoft .NETという戦略を発表するところから始まります。 そしてその後に、この構想が実装されたものとして、.NET Frameworkが誕生します。 .NET Frameworkを使うとWindowsアプリケーションやWebアプ

Cinemachineを使うとあらゆるカメラワークを簡単な設定で作成できます。 ただし多機能で使いこなすのはなかなか大変なので、この記事ではまず簡単に使ってカメラワークを作ってみます。 Cinemachineの概要とセットアップ手順 とりあえず使ってみる Virtual Cameraとは何なのか？ Virtual Cameraの基本 - BodyとAim 複数のVirtual Cameraを取り扱う Bodyの種類一覧 Aimの種類一覧 まとめ Unity2018.4.0 Cinemachine2.2.9 Cinemachineの概要とセットアップ手順 Cinemachineはカメラを制御するためのUnityの公式アセットです。 ゲームを作るうえで必要なあらゆるカメラワークを簡単な設定で作成できます。 インストールはPackage Managerから行えます。 Window > Packa

UnityでMVPと、UniRxを使ったMV(R)Pを実装してみました。 また、調べたらいろんな実装方法があったのでそのあたりの考察も加えています。 まずは全部Viewに書く MVP MV(R)P いろんな実装がある ViewとPresenterは1:1にするべき? PresenterはMonoBehaviourにするべき? Viewはインタフェースにするべき? ViewはModelを知るべき? 参考 まずは全部Viewに書く まず、アーキテクチャを使わない状態、 すなわち全ての処理を一つのクラスに書いたものを作ってみます。 using UnityEngine; using UnityEngine.UI; public class CountingButton : MonoBehaviour { [SerializeField] private Button _button; [Seria

物理ベースレンダリングに入門するための連載の第1回です。 今回は物理ベースレンダリングの概念とその背後にある考え方についてまとめます。 はじめに 物理ベースレンダリングとは 物体に入射する光の行方 エネルギー保存の法則 フレネル反射 反射した光の行方 マイクロファセット 幾何減衰 屈折した光の行方 サブサーフェイス・スキャタリング 拡散反射の簡易モデル まとめ 連載一覧 はじめに この連載では物理ベースレンダリングに関する基礎的な知識をまとめていきます。 まずこの第1回目では物理ベースレンダリングの概念について説明します。 第2回では実装を行う上で用いる式を一通り紹介し、第3回ではUnityにおける実装を行います。 リアルタイムレンダリングを前提としているため、オフラインのパストレーシングなどの話題は取り扱いません。 また物理ベースレンダリングと銘打ってはいますが、シェーディングモデルを中

Unity Test Runnerの基本的な使い方と使う上での注意点をまとめました。 インストール Unity2019.1以前の場合 Unity2019.2以降の場合 Windowを開く テスト用のアセンブリを定義する Assembly Definition Fileを作る Edit ModeとPlay Mode Edit ModeとPlay Modeのアセンブリ定義 テスト対象のアセンブリを設定する テストを書く 簡単なテストを書く コルーチンを使う Assert.Thatの書き方 Assertクラスについて テストを実行する Unity上でテストを実行する ビルドしてテストを実行する 参考 Unity 2019.3.5 Test Framework 1.1.11 インストール Unity2019.1以前の場合 Unity2019.1まではTest RunnerがUnityエディタに組み

Unity2019.3から抽象クラスやインタフェースがシリアライズ対象として指定できるようになりました。 この記事ではその使い方と注意点についてまとめます。 ちゃんと理解するための記事を書きました 従来のシリアライズ - SerializeField 抽象クラスやインタフェースがシリアライズできるように - SerializeReference SerializeReferenceは「参照」をシリアライズする 初期化処理の違い YAMLを見て理解を深める Unity2019.3.0 ちゃんと理解するための記事を書きました SerializeReferenceをしっかり理解するための記事を別記事として投稿しました。 light11.hatenadiary.com より踏み込んだ内容となっていますので、必要に応じてこちらも参照してください。 従来のシリアライズ - SerializeField

自作のポストエフェクトをPost Processingのカスタムエフェクトとして実装する方法です。 Post Processingを導入する シェーダを書く PostProcessEffectSettingsを書く PostProcessEffectRendererを書く 使ってみる シェーダがビルドに含まれない？ カスタムポストエフェクトの適用順序を変更する Inspectorを拡張する FXAAを使う場合は書き方に注意する 関連 参考サイト Unity2018.3.1f1 Post Processing 2.1.2 Post Processingを導入する Post Processingの導入方法は下記の記事にまとめてありますので必要に応じて参照してください。 light11.hatenadiary.com シェーダを書く まずはシェーダを書きます。 今回はレンダリング結果を拡大できる

Unityのシェーダで0～1の値の強度をpow()を使わずに変換する方法です。 やりたいこと pow()より直感的に調整できる関数 Unity2019.2.10 やりたいこと いま、シェーダで0～1を取る値があるとします。 これを、何らかの関数を用いて非線形の値に変換することを考えます。 このような場合、シェーダではよくpow関数を使います。 float dst = pow(src, x); この形式はフォン反射などでも使われます。 ただ、この計算式は入力値がマイナスであるほど結果が大きくなったりピーキーな部分があったりとイマイチ直感的ではありません。 特に入力値をマテリアルプロパティとして外から見えるように実装する場合にはもっと直感的な調整を可能にするべきです。 そこで本記事ではもう少し直感的な関数を作ってみます。 pow()より直感的に調整できる関数 前節の課題を解消するため、dst

UnityのAddressableアセットシステムのメモリ管理の仕組みについてまとめました。 はじめに ロードとリリース（アンロード）をペアにするのが基本 GameObjectの生成方法とメモリ管理 2つの生成方法 メモリのリリース方法の違い どちらを使えばいいのか？ シーンのアンロードタイミング その他明示的なリリースが必要なもの 自動的に解放されるもの 参照カウントを見る 関連 参考 Unity2019.2.10 Addressable1.3.8 はじめに この記事ではAddressableアセットシステムのメモリ管理の仕組みについてまとめます。 Addressableの概念や基礎知識についての説明はこの記事では省略しますが、 以下の記事にまとめていますので、必要に応じて参照してください。 light11.hatenadiary.com また、ロードやアンロードの基本的なやり方について