DEV Community: KOGA Mitsuhiro

Unity2018.2 + il2cppでgRPCアプリをAndroid/iOS向けにビルドする

KOGA Mitsuhiro — Sat, 04 Apr 2020 20:35:00 +0000

はじめに

「UnityでgRPCアプリ(iOS, Android)をビルドできるようになった」でUnityのiOS, AndroidでもgRPCアプリを動かせるようになりました。
ここから更にil2cppでビルドする際に起きる問題の対処をまとめました。

共通

*.protoでoneofかenumを使っている場合はSystem.Reflection.Emitが走って実行時エラーになってしまいます。
protocで生成したコード中のenumすべてを以下のTに指定すると回避できます。
oneofでenumを使った場合はそのフィールドを含むクラスもこの対策が必要みたいです。RPC周りの例外メッセージにSystem.Reflection.Emitが出てきたら対象のクラスを指定すれば大丈夫だと思います。

一度だけ実行すればいいので静的コンストラクタなどに書いておくといいでしょう。

using Google.Protobuf.Reflection;

FileDescriptor.ForceReflectionInitialization<T>();

Android向け

C#: Fix il2cpp build on Unity Android. #18039でダミー関数がマージされたのでコピー不要になりました。

DLLImportの名前が合わずにリンク時にビルドエラーが発生してしまいます。
Unity2018.2からPluginsフォルダにcppを配置するとビルドされるようになったので、以下のダミー関数のソースを配置しInclude PlatformsからiOSとEditorを除外します。

/Assets/Plugins/Grpc.Core/runtimes/grpc_csharp_ext_stub.c
/Assets/Plugins/Grpc.Core/runtimes/grpc_csharp_ext_stub.c.meta

ネットワークアクセスがgRPCのみだとAndroidManifest.xmlにINTERNETパーミッションが付与されません。
確実に有効にするためにPlayerSettings > Other Settings > Internet AccessをRequireにします。

iOS向け

iOS向けのライブラリのアーキテクチャはx86_64とarm64だけなのでPlayerSettings > Other Settings > ArchitectureをARM64にします。

また、bitcode非対応なのでXCodeのBuild SettingsでENABLE_BITCODEをNOにします。
~~Enable bitcode for ios native libraries #20113でbitcodeに対応するビルドオプションが追加されたので対処不要になりました。~~
bitcode対応するとlibgrpc.aが250MB以上増えたのでv1.24.xブランチはRevert "Enable bitcode for ios native libraries" in v1.24.x #20233で、masterブランチはa2dbf0a99d1fc1c0059dbb28c4b530a58584cd71で差し戻されてしまいました。

リンク対象のライブラリにlibzが必要なのでBuild Phases > Link Binary With Librariesから追加します。

この操作は以下のエディタ拡張を配置すればビルド時に自動的に反映できます。

~~参考にしたBuildHelper.csはlibresolv.tbdを追加していますがビルドエラーにならなかったので今も必要なのかよく分かりません…~~
参考にした先と公式ではビルドオプションが異なり、公式のライブラリを使うならlibresolv.tbdは不要でした。

#if UNITY_IPHONE

using System.IO;
using UnityEngine;
using UnityEditor;
using UnityEditor.Callbacks;
using UnityEditor.iOS.Xcode;

public class BuildHelper
{
    // Add libz.tbd and disable bitcode when building for iOS
    // Thanks to https://github.com/jsmouret/grpc-unity-package/blob/master/example/UnityGrpcClient/Assets/Scripts/Editor/BuildHelper.cs

    [PostProcessBuildAttribute(1)]
    public static void OnPostProcessBuild(BuildTarget target, string path)
    {
        if (target == BuildTarget.iOS)
        {
            var projectPath = PBXProject.GetPBXProjectPath(path);
            var project = new PBXProject();
            project.ReadFromString(File.ReadAllText(projectPath));
            var targetGUID = project.TargetGuidByName(PBXProject.GetUnityTargetName());

            project.AddFrameworkToProject(targetGUID, "libz.tbd", false);

            project.SetBuildProperty(targetGUID, "ENABLE_BITCODE", "NO");

            File.WriteAllText(projectPath, project.WriteToString());
        }
    }
}

#endif

最後に

2018/10/15現在、このような対策が必要ですが今後不要になったり対策が変わるかもしれないのでgrpc/grpcやprotocolbuffers/protobufのissuesなどで動向を追ってください。

※追記
Experimentalパッケージが出る前のバージョンは「UnityプロジェクトでのgRPC導入方法について」の手順でビルドすれば利用できるようです。

参考リンク

Unite Tokyo 2019で発表されたUnity Render Streamingを試す

KOGA Mitsuhiro — Sat, 04 Apr 2020 20:34:00 +0000

はじめに

Unity Render StreamingとはUnityのゲーム画面をWebブラウザに流し、Webブラウザからはキーボード、マウス、タッチ、ボタンで入力できるようにした仕組みです。この仕組みでHDRPをサポートしないPCでもブラウザ経由で確認できるといったもののようです。詳細や制約などはUnity & WebRTC – ブラウザーと Unity を繋げる – Unity Blogが詳しいです。
この仕組みはチュートリアルが用意されていてHDRPのサンプルプロジェクトで動作確認できます。
なかなか面白い仕組みなのでサンプルプロジェクトを調べて自前のプロジェクトに組込む手順をまとめました。

Unity Render Streaming https://t.co/ak84aB2Gw8 @YouTubeさんから
— KOGA Mitsuhiro (@shiena) September 29, 2019

使い方

試した環境

Windows 10
Unity2019.2.6f1
Unity Render Streaming 1.1.1

更にドキュメントによるとGraphics APIはDirectX11のみをサポートして、NVIDIA VIDEO CODEC SDKに公開されているグラフィックボードを推奨しています。

インストール

Package Managerを開き、AdvancedからShow dependenciesとShow preview packagesをチェックします。
In ProjectをクリックしてAll packagesに切り替えます。
パッケージ一覧からUnity Render Streamingを探して右下のInstallボタンからインストールします。検索窓にStreamingと入力するとパッケージ一覧を絞りこめるので探すのが楽です。
Unity Render StreamingはInput Systemに依存していて有効にするか確認ダイアログが出るので問題なければYesボタンを押します。
Webサーバーとの連携はサンプルプロジェクトのスクリプトを流用すると楽なので取り込みます。
1. もう一度Package ManagerからUnity Render Streamingを選択してHDRPのImport in projectボタンを押します。
2. サンプルプロジェクトをインポートするダイアログが開くのでScriptsのみ選択してインポートボタンを押します。
3. サンプルプロジェクトはHigh Definition RPに依存していてImport in projectボタンを押した時にインストールされています。ですが不要ならアンインストールしても構いません。

Render Streamingの設定

まずはブラウザに表示するカメラをHierarhyに追加してSimpleCameraControllerをアタッチ、Audio Listenerを削除します。
次にRender Streaming用に空のGameObjectをHierarhyを追加してRenderStreamingをアタッチ、CaptureCameraにブラウザ用カメラを設定します。
メニュー > Render Streaming > Download web appからWebサーバーをダウンロードします。保存先はデフォルトでプロジェクト直下ですがどこに保存しても構いません。

Render Streamingを試す

ダウンロードしたwebserver.exeを実行します。
Unityエディタのプレイボタンを押してゲームを実行します。
ブラウザでhttp://localhostを開きます。再生ボタンが表示されているのでクリックしてしばらく待つとゲーム画面が表示されます。
ブラウザで左ドラッグすると移動、右ドラッグすると回転します。

この動画ではブラウザを操作した時にカメラのTransformが変化しているのが分かると思います。

Unity Render Streaming https://t.co/ak84aB2Gw8 @YouTubeさんから
— KOGA Mitsuhiro (@shiena) September 29, 2019

ブラウザ側のボタンカスタマイズ

残念ながらダウンロードしたバイナリのwebサーバーはボタンに関してカスタマイズできないようです。
Webサーバーソースをダウンロードして、app.js#L42-L67あたりを変更すると任意のテキストと色のボタンを作れそうです。
また、ブラウザの入力はブラウザ入力処理に従って送信されてRemoteInput.csでいい感じに処理がふりわけられるようです。

参考リンク

UnityのUniversalRPで開発中のCamera Stacking Systemを試す

KOGA Mitsuhiro — Mon, 30 Mar 2020 09:05:00 +0000

はじめに

現在はUnity2019.3以上のPackage ManagerからCamera Stacking Systemに対応したUniversalRP7.2以上をインストールできます。
またUniversalRenderingExamplesのCharacter UIと3D SkyboxにCamera Stacking Systemを利用したサンプルプロジェクトがあります。

Character UI

3D Skybox

UnityのLWRPはカメラスタックをサポートしないと明言されていました。
流石に不便だったのかUnity2019.2のロードマップにカメラスタックが追加されました。

Camera Rendering in LWRP

2019.2 でCamera Stacking Systemが実装されるので、LWRPでカメラの結果を重ねるのはそこから可能になる感じですね pic.twitter.com/4HoWunmCQv
— h.omae (@pigeon6) April 25, 2019

残念ながら2019.2のリリースに間に合わなかったのですがUniversal/2019.3/backports by phi-lira · Pull Request #5462でrelease/2019.3ブランチにマージされたので試してみます。

Camera Stacking for URP has landed in main code base. This is definitely the longest PR I did in my life (6+ months), but it's finally here. This is target to be released in 7.2.0 package for URP end of this month. https://t.co/5Pi19Lzot3
— Felipe Lira (@phi_lira) January 9, 2020

現在はmasterブランチとrelease/2019.3ブランチにマージされました。以下はそれぞれのブランチに対するPull Requestです。

またドキュメントはcom.unity.render-pipelines.universal/Documentation~/cameras.mdに用意されています。

Camera Stacking System

環境

Unity2019.3.0f3
release/2019.3ブランチのUniversalRP 7.2.0
Unity Samples: UI (動作確認用)

UniversalRPのダウンロード

zipでダウンロードする方法とgitでcloneする方法、更にgitで対象のフォルダのみcloneする方法がありそれぞれ利点、欠点があるので使いやすい方法を選んでください。

zipでダウンロード
- 利点: ブラウザからダウンロードできる
- 欠点: zipのサイズが1GB程度ある
gitでclone
- 利点: git logを辿れる
- 欠点: zipよりもダウンロード時間が長いのでおすすめしない
gitで対象のフォルダのみclone
- 利点: 必要最小限のフォルダのみダウンロードするので速い
- 欠点: gitといくつかのコマンド操作が必要なので慣れていないと操作が難しい

zipでダウンロードする

以下のリンクからrelease/2019.3ブランチを開き、右側のClone or download > Download ZIPボタンからダウンロードします。

https://github.com/Unity-Technologies/ScriptableRenderPipeline/tree/release/2019.3

gitでcloneする

以下のコマンドでuniversal/camera-stackingブランチをcloneします。

git clone -b release/2019.3 https://github.com/Unity-Technologies/ScriptableRenderPipeline.git

gitで対象のフォルダのみcloneする

以下のコマンドでCore RP Library, Universal RP, Shader Graphのみcloneします。

# 不要なfetchしないためにリモートのみを設定したローカルリポジトリを作る
git init ScriptableRenderPipeline
cd ScriptableRenderPipeline
git remote add origin https://github.com/Unity-Technologies/ScriptableRenderPipeline.git

# sparse checkoutを有効にしてCore RP Library, Universal RP, Shader Graphのみをcheckout対象にする
git config core.sparsecheckout true
echo /com.unity.render-pipelines.core/ > .git/info/sparse-checkout
echo /com.unity.render-pipelines.universal/ >> .git/info/sparse-checkout
echo /com.unity.shadergraph/ >> .git/info/sparse-checkout

# checkoutしたいブランチと同名のローカルブランチを作る
git checkout -b release/2019.3

# shallow cloneで履歴を1つだけpullする
git pull --depth 1 origin release/2019.3

UniversalRPをインストールする

以下のようにcom.unity.render-pipelines.core, com.unity.render-pipelines.universal, com.unity.shadergraphを[Project Folder]/Packagesにコピーします。

正常にインストールできているとPackage ManagerのCore RP Library, Universal RP, Shader Graphのバージョンが7.2.0 (in development)になっています。

従来のRP

まずは確認のためにUnity Samples: UIのMenu 3Dを開いてみます。このシーンは背景用のMainCameraとUI用のGUI Cameraの2つがあります。

Camera Stacking System未対応のUniversal RP

次にCamera Stacking System未対応のUniversal RP 7.1.2 で確認するとGame ViewはGUI Cameraで背景も上書きされてしまいます。
描画順序は従来のRPと同様にDepthで決まるようですがUniversalRPに切り替えるとInspectorから見えなくなります。

Camera Stacking System対応のUniversal RP

まずはUniversalRPのアセットを作り、Opaque Textureを有効にします。これは1パスしか扱えないUniversalRPでGrabPassと同様の機能でカメラスタックに必要なようです。 Opaque Textureを有効にしなくても描画されるようになりました。UniversalRPアセット
後から描画するカメラ(GUI Camera)の~~Background TypeをUninitializedかSolid Colorに変更して~~Render ModeをOverlayに変更します。 ~~Render Modeを変えるとBackground Typeが見えなくなるので必ずBackground Typeを先に変更します。~~ 事前にBackground Typeを変更しなくても背景が上書きされなくなりました。
先に描画するカメラ(Main Camera)のStackにGUI Cameraを追加します。

以上の設定でUniversalRPでも従来のRPと同様に複数のカメラを重ねて描画できました。

他の方法でカメラスタックする

こちらは試していませんがLWRPを拡張する方法とPostProcessingとしてオーバーレイする方法もあります。
ですがLWRPの拡張はv3あたりがベースなのでそのまま使えるか分からなかったりPostProcessingは遅かったりとなかなかうまくいかないようです。

最後に

Unityの中の人によると以下のスレッドでUnity2019.4LTSを目標としていて2019.3リリース直後にパッケージに含まれそうと言っているので期待できそうです。

参考リンク

Qiitaの記事とストックをバックアップする

KOGA Mitsuhiro — Sun, 29 Mar 2020 16:27:00 +0000

はじめに

最近PowerShellを使っているので力試しにQiitaの記事とストックをバックアップするスクリプトを作りました。
LGTM一覧は残念ながらQiita APIにないのでWebページをスクレイピングしないと取得できなさそうです。

動作環境

Windows PowerShell 5
PowerShell Core 6
PowerShell 7

使い方

記事のバックアップ

qiita-item-exporter.ps1

ファイルの先頭に$userIdを自分のアカウント名に変更します。
記事中の画像ファイルのURLはデフォルトでファイル名のみに置換しますが他のURLに置き換えたい場合に設定します。たとえば$imageFolder = "https://example.com/images/"にすると記事中の画像のURLが以下のように置換されます。
- 変更前 https://qiita-image-store.s3.amazonaws.com/0/00000/ffffffff-ffff-ffff-ffff-ffffffffffff.png
- 変更後 https://example.com/images/ffffffff-ffff-ffff-ffff-ffffffffffff.png

$userId = 'your-user-name'
$imageFolder = "" # replace image path

qiita-item-exporter.ps1を実行すると以下のような構造で記事と画像が保存されます。

- items
  +- readme.md                                   # 各記事へのリンク
  +- xxxxxxxxxxxxxxxxxxxx                        # 記事のID
     +- xxxxxxxxxxxxxxxxxxxx.md                  # ダウンロードした記事
     +- readme.md                                # 画像のURLを置換した記事
     +- ffffffff-ffff-ffff-ffff-ffffffffffff.png # 記事中の画像
     +- meta.json                                # 作成日時、更新日時、タイトル、タグを保存したJSON

ストックのバックアップ

qiita-stock-exporter.ps1

$userIdと$imageFolderはqiita-item-exporter.ps1と同様の設定です。
ストックの総数はQiita APIで取得できないのでストック一覧の一番下からページ数を確認して$pagesを設定します。このスクショでは29がページ数です。

$userId = 'your-user-name'
$pages = 1 # your-stock-pages
$imageFolder = "" # replace image path

qiita-stock-exporter.ps1を実行すると以下のような構造で記事と画像が保存されます。

- stokcs
  +- readme.md                                   # 各記事へのリンク
  +- xxxxxxxxxxxxxxxxxxxx                        # 記事のID
     +- xxxxxxxxxxxxxxxxxxxx.md                  # ダウンロードした記事
     +- readme.md                                # 画像のURLを置換した記事
     +- ffffffff-ffff-ffff-ffff-ffffffffffff.png # 記事中の画像
     +- meta.json                                # ユーザーID、ユーザー情報、タイトル、タグを保存したJSON

さいごに

PowerShellは文法こそ独特なもののC#のLINQのようにパイプで文字列だけではなくオブジェクトを流せるのでデータの加工が楽でした。

Unity Accelerator + Prometheus + GrafanaをDockerでサービス化する

KOGA Mitsuhiro — Sat, 28 Mar 2020 12:38:00 +0000

はじめに

Unity2019.3からAsset Pipeline v2が追加されてUnity Acceleratorを組み合わせるとインポートしたアセットをキャッシュおよび共有することができます。

Unity Accelerator でチームの作業をスピードアップ

それまでのUnityにもAsset Pipeline v1とキャッシュサーバーでキャッシュできていましたが、Unity Acceleratorには以下の違いがあります。

キャッシュサーバーと同居できる
Collaborateのキャッシュに対応
不要なキャッシュを定期的にクリーンアップ
転送されたバイト数や接続されたエディターなどの情報をPrometheusから利用できるメトリクスで公開

フォーラムの以下のスレッドによるとDockerHubでイメージが公開されています。

Unity AcceleratorはPrometheusとダッシュボードのGrafanaを組み合わせるとメトリクスを可視化できるのでdocker-composeでサービス化しました。

Dockerでサービス化

https://github.com/shiena/docker-unity-accelerator

設定ファイル

COLLAB_REGISTRATION_TOKEN=ft0bJvbRD
DISABLE_USAGE_STATS=yes

Unity Collaborateと連携する場合はCOLLAB_REGISTRATION_TOKENにトークンを設定します。
統計情報の送信を抑制する場合はDISABLE_USAGE_STATSに任意の値を設定します。

サービスを実行

docker-compose up -d

サービスを起動するとそれぞれ以下からアクセスできます。

Unity Acceleratorおよびキャッシュサーバー: 起動したPCのIPアドレス
Prometheus: http://localhost:9090
Grafana: http://localhost:3000
- 初期アカウントとパスワードはadminとadmin

GrafanaではUnity - Manual: Unity Acceleratorの一覧にあるメトリクスを扱えます。

Local Administraotr Dashboard

v1.0.272+gb7c26b9からLocal Administrator Dashboardが追加されて http://localhost:10080 からアクセスできるようになりました。

ConfigurationとLogsは以下のコマンドでパスワード設定が必要です。

docker-compose exec accelerator /agent/unity-accelerator tool adminpw mysupersecretpassword

公式イメージ公開前にDocker化で工夫したこと

~~Unity AcceleratorをダウンロードするURLからバージョンが分からないのでバージョンを確認する方法を用意しています。~~
v1.0.196+ge1f9988で修正されました。キャッシュサーバー追加でインストーラーを非対話モードで実行するとnpmのパスが展開されないバグがあるので対話モードprintfで強引にインストールしています。(バグ報告済み)
v1.0.242+gf11031dで修正されました。~~v1.0.196+ge1f9988で初回起動時などpidファイルがなかったり空の時に起動できないバグがあるのでパッチを当てています。~~
公式イメージが公開されたので独自Dockerfileから切り替えました。

Unity2018.4はLTSだけどバージョンアップで破壊的変更されている

KOGA Mitsuhiro — Sun, 15 Mar 2020 10:15:00 +0000

修正以外の変更内容

Unity2018.4.1以降に修正以外で変更された内容を抜き出しました。
LTSなのにBackwards Compatibility Breaking Changesなんて項目もありますね。

https://unity3d.com/unity/whats-new/2018.4.4
Changes
- Android: Android Gradle plugin version updated up to 3.4.
- Android: Gradle version updated up to 5.1.1.
https://unity3d.com/unity/whats-new/2018.4.5
Improvements
- Version Control: Added "Overwrite Failed Checkout Assets" editor setting, turning it off makes unity not overwrite files that can't be checked out. (1010999, 1158593)
https://unity3d.com/unity/whats-new/2018.4.6
Backwards Compatibility Breaking Changes
- Apple TV: Remove support for Universal Harmony Remote, supporting this controller made Siri Remote and gamepads regrees by producing unintended double events for button clicks. For more information check UnityView+Keyboard.mm pressesBegan/pressesEnd functions.
Improvements
- XR: Updated Vuforia to version 8.3.8.
https://unity3d.com/unity/whats-new/2018.4.10
Backwards Compatibility Breaking Changes
- Android: Improve error messages for cases where android application fails to load libmain.so. Previously it was printing "Unable to find main", now it will print "Failed to load 'libmain.so', the application will terminate.", additionally it will print exception from System.loadLibrary with detailed info, where the application was looking for libmain.so
Improvements
- Graphics: Optimised Cluster Rendering networking.
https://unity3d.com/unity/whats-new/2018.4.14
Changes
- XR: Updated to Oculus 1.38 plugin and added support for valid tracking poses even when devices aren't fully tracked. (1197386)
https://unity3d.com/unity/beta/2018.4.16f1
Changes
- Package Manager: Changed the package installation process to no longer set package directories and files as read-only on disk. This prevents all sorts of possible corruption scenarios (e.g. read-only directories, partially-read-only packages in the package cache) and avoids some permission issues when removing packages.
- Package Manager: Changed the package installation process to systematically revert packages to their original state. Note: this has the side-effect of actively reverting local modifications in immutable packages, which could previously be kept until the dependency was updated to a different version of the package. In order to preserve local changes, a package should first be embedded in the project.
Improvements
- Package Manager: Added support for configuring additional SSL certificate authorities, including self-signed certificates. See the Unity Manual for more information on how to use this.
- Package Manager: Added support for Git URLs with the SCP format (e.g. git@github.com/user/repo).
- Package Manager: Added support for Git URLs without a trailing .git by using git:// URLs or prepending git+ to URLs (e.g. git+https://github.com/user/repo).
- Package Manager: Added support for tarball-based dependencies (e.g. "file:.tgz").
- Package Manager: Changed the UnityEditor.PackageManager.Client.Add method to make the @ prefix optional when adding Git-based dependencies and local dependencies (file:).
- Package Manager: Reduced the amount of data transferred over the network when fetching package metadata from the registry.
Features
- Multiplayer: Added UNET encryption support.
https://unity3d.com/unity/beta/2018.4.19f1
API Changes
- Particles: Added: Added NativeArray overloads to SetParticles and GetParticles
Improvements
- Editor: Greatly improves performance over large numbers of objects with RectTransforms, scene navigation is now very smooth. However actual picking is still very slow (no change). (1165982)
- XR: Updated minimum version of Windows Mixed Reality package.

リリースノートを調べた経緯

Unity2018.4.9f1とOculus Integration v1.37を使ったプロジェクトがあり、Unityのパッチバージョンを上げてみると実機で起動できなくなりました。
公式フォーラムやAnswersでも原因を特定できておらず藁にもすがる思いで各バージョンのリリースノートをたどると2018.4.14fに以下の変更がありプロジェクト内のバージョンより大きくなっていました。

Changes

XR: Updated to Oculus 1.38 plugin and added support for valid tracking poses even when devices aren't fully tracked. (1197386)

恐らくこれが原因で2018.4.13f1でビルドしたものは起動できて2018.4.14f1でビルドしたものは起動できませんでした。
バージョンアップする時は下位互換性だけではなくライブラリのバージョンなど他の内容も確認が必要そうです。

色々なご意見

まじか... https://t.co/CAs7fn8tV1
— su10@ハイパーカジュアルゲーム開発 (@su10_dev) March 14, 2020

メチャクチャわかる…LTS(長期サポートするけど破壊的変更もする)
Unity2018.4はLTSだけどバージョンアップで破壊的変更されている https://t.co/gXPUAtceAf #Qiita
— izm (@izm) March 14, 2020

「LTSだから安心して上がるやろ」と思って上げると記事中にあるように統合されているSDKなどが影響して、たすけて！もなふわすい～とる～む！！ってなることもあり得るので注意せねばな...(自戒)
— mao (@test_h_) March 14, 2020

HoloLens2の機能周りも19系列だけでなく、LTSでも使えるようにちょいちょい更新かかっていたりするからなぁ
単純な不具合修正だけじゃなくて他SDK、デバイスサポートも更新し続けてるのがLTS

Unity2018.4はLTSだけどバージョンアップで破壊的変更されている - Qiita https://t.co/ZesQqheLnw
— Decoc (@deco_c_) March 14, 2020

UnityのLTSってLTSの意味理解してんのか？って思うくらいには安定感がないんだよなぁ...

Unity2018.4はLTSだけどバージョンアップで破壊的変更されている https://t.co/VPlMOgfhvu #Qiita
— TechNΘ (@Techno1109) March 14, 2020

Unity 2018.4は.16でAssetBundleの非同期ロードが止まってしまう破壊的破壊があったんですが、.18で治ったらしいです（これからテスト） https://t.co/mskEAGVqtP
— ichijo (@Takaaki_Ichijo) March 14, 2020

やっぱりバージョン上げるときはどんなときでも変更点を確認すべきだな
— たた (@pf35301) March 15, 2020

「Unity 2018.4 LTS (Long Term Supported) (Stableとは言ってない)」不定期の気配
— 獏星(ばくすたー) / Megumi Baxter (@baku_dreameater) March 15, 2020

LTSは新機能が入らないというだけで、他のライブラリのバージョンに追従するためやセキュリティー的な対応で破壊的変更にならざるを得ないはしょうがないのかなぁと。まぁ、それでもパッチバージョン上げたら動かなくなるパターンは萎える…。
— なっつー@BNUT (@yashinut) March 15, 2020

Unityはセマンティックバージョニングではないし、後方互換完全に保って2年間パッチし続けるリリース管理は不可能に近いっていうか間違いなく不可能だろうからしゃーないね...辛いけどさ...　https://t.co/xgOALpdGrJ
— Haruto Otake (@Trapezoid) March 15, 2020

UnityのLTSは「新機能を勉強せずに最長2年間使える」程度の意味しか無いのでこういうリリースノート読まずに起動しないバグを出すレベルのチームほど使わない方が無難 https://t.co/Kb4lt2iuYc
— 野生の男 WILDMAN (@yasei_no_otoko) March 15, 2020

UnityのLTSでリリースノート見ないのはただの自殺志願者やぞ
— はるっちー (@hal_chi) March 15, 2020

Extenject / UniRx / UniTaskをPackage Managerで扱いたい

KOGA Mitsuhiro — Mon, 09 Mar 2020 12:26:00 +0000

はじめに

Package Managerでパッケージの導入が楽になったのでよく使うライブラリでも使えないかと調べた所、各リポジトリにissueは立っているものの開発元はまだ対応していません。

ですが有志がUPM対応したりレジストリを建てたりしているのでそれを利用する方法をまとめました。

有志がUPM化したものを利用

ExtenjectとUniRxはissueにもコメントされていたものです。UniTaskはUPMに対応するPull Requestのリポジトリを利用できそうです。

{
  "dependencies": {
    "com.svermeulen.extenject": "https://github.com/starikcetin/Extenject.git#9.1.0",
    "com.neuecc.unirx": "https://github.com/starikcetin/UniRx.git#7.1.0",
    "com.cysharp.unitask": "https://github.com/twksos/UniTask.git#upm-1.2.0",
    ...
  }
}

Unofficial Unity Package Manager Registryを利用

もんりぃ先生(@monry)が建てたUnofficial Unity Package Manager Registryにもパッケージが登録されているのでこちらを利用する事もできます。
詳細は以下のリンクをご覧下さい。

こっちはパッケージを利用する方法に従ってmanifest.jsonに以下の内容を追加します。

{
  "scopedRegistries": [
    {
      "name": "Unofficial Unity Package Manager Registry",
      "url": "https://upm-packages.dev",
      "scopes": [
        "com.stevevermeulen",
        "jp.cysharp"
      ]
    }
  ],
  "dependencies": {
      "com.stevevermeulen.extenject": "9.1.0",
      "jp.cysharp.unirx": "7.1.0",
      "jp.cysharp.unitask": "1.0.0",
      ...
  }
}

更にExtenjectのバージョンの枝番に-5、scopesにdev.upm-packagesを追加するとテスト用のMoqとNSubstituteを一緒にインストールできます。

{
  "scopedRegistries": [
    {
      "name": "Unofficial Unity Package Manager Registry",
      "url": "https://upm-packages.dev",
      "scopes": [
        "com.stevevermeulen",
        "jp.cysharp",
        "dev.upm-packages"
      ]
    }
  ],
  "dependencies": {
      "com.stevevermeulen.extenject": "9.1.0-5",
      "jp.cysharp.unirx": "7.1.0",
      "jp.cysharp.unitask": "1.0.0",
      ...
  }
}

Path query parameter (Subfolder)

Unity2020.1a21とUnity2019.3.4f1からpackage.jsonをサブフォルダに配置できるようになりました。既存構成のままupm化できるようになったので開発元に追加されれば利用できるようになります。

現状、Extenjectは以下のように指定すればPackage Managerから扱えますがバグがありコンパイルエラーになります。

{
  "dependencies": {
    "com.svermeulen.extenject": "https://github.com/svermeulen/Extenject.git?path=/UnityProject/Assets/Plugins/Zenject",
    ...
  }
}

まだpackage.jsonが追加された後にタグが作られてませんが以下のようにハッシュを直接指定すると固定できます。

{
  "dependencies": {
    "com.svermeulen.extenject": "https://github.com/svermeulen/Extenject.git?path=/UnityProject/Assets/Plugins/Zenject#a955dd60be11d9a1f92080cda1d87e425c519072",
    ...
  }
}

https://forum.unity.com/threads/some-feedback-on-package-manager-git-support.743345/#post-5425311

Unity 2019.3.4f1 から Unity Package Manager が「Git リポジトリのルート以外に package.json がある場合」もサポートしてくれるようになりました。https://t.co/gChvsXmgjb
こんな感じに ?path=... とパスを指定してあげれば良いようです。
（内部的に clone してから当該パス以下を読んでる？）
— もんりぃ先生 (@monry) March 6, 2020

最後に

どちらの方法も一次配布元ではないのでいつまで追従するのか不安があります。
また、Unofficial Unity Package Manager Registryのパッケージはそれに加えて一旦ダウンロードしないと内容が分からないので差分が分からないのと誰がアップロードしたのか分からない不安さがあります。
この辺りを踏まえて便利に利用しましょう。

【Unity】そろそろXR Managementに対応したOpenVR XR Pluginがリリースされそう

KOGA Mitsuhiro — Sun, 08 Mar 2020 10:31:00 +0000

はじめに

Unityの既存のVRサポートは2020.1で廃止されXR Managementに一本化されます。
今までOpenVR対応プラグインがなかったのでViveなど一部のHMDで移行の障害になっていましたがやっとリリースされそうな動きが見えてきました。

https://forum.unity.com/threads/xr-plugins-and-subsystems.693463/page-5#post-5562637

以下はInputSystemのPull Requestとそれを作った開発者のGitHubアカウントにあるテストパッケージです。

導入方法

リリース前なので導入しても動作保証はありません。

manifest.jsonに追加

UnityプロジェクトフォルダのPackages/manifest.jsonに以下の1行を追加するとUnityが自動でダウンロードします。
今はmasterブランチよりTestBranchの方が進んでいるので#TestBranchを指定します。

{
  "dependencies": {
    "com.valve.openvr": "https://github.com/zite/TestPackage.git#TestBranch",
    ...
  }
}

Pakcagesフォルダにコピー

TestPackageリポジトリをzipでダウンロードしたりgit cloneしてPackagesフォルダに配置するとUnityプロジェクトに取り込まれます。

OpenVR XR Pluginが認識されるとPackage Managerに追加されます。

OpenVR XR Pluginの設定

docker-composeでDBの起動完了を待ってからWebアプリを実行する

KOGA Mitsuhiro — Mon, 02 Mar 2020 15:35:00 +0000

はじめに

docker-composeで複数のコンテナを管理するとき、ほぼWebアプリとDBを一緒に使います。
大抵はWebアプリ側にdepends_onでDBのコンテナを指定して起動順序を制御しますが、あくまで起動順序だけなのでDBの起動完了前にWebアプリがDBにアクセスしてしまい起動失敗する事があります。

せっかくdocker-composeで1つにまとめて管理しているのに便利さが半減してしまうとモヤモヤしていたら、公式ではWebアプリ側でチェックせよと解説していました。

GitBucket + MySQLの場合

上述の公式の解説ではPostgreSQLを対象にしているのですが、MySQLをよく使うので書き換えてみました。

ファイル構成はこんな感じです。

docker-compose.yml
  + gitbucket/
      + Dockerfile
      + wait.sh

今回のメインとなるwait.shは引数からDBのホスト名、ユーザ名、パスワードを受け取って生存チェック後にWebアプリを実行します。

#!/bin/sh

set -e

host="$1"
shift
user="$1"
shift
password="$1"
shift
cmd="$@"

echo "Waiting for mysql"
until mysql -h"$host" -u"$user" -p"$password" &> /dev/null
do
        >&2 echo -n "."
        sleep 1
done

>&2 echo "MySQL is up - executing command"
exec $cmd

ベースイメージはalpine版なのでapkでmysql-clientをインストールしています。

FROM java:8-jre-alpine
MAINTAINER shiena
ENV GITBUCKET_HOME /var/gitbucket
VOLUME ["${GITBUCKET_HOME}"]
EXPOSE 8080
RUN apk add --no-cache mysql-client
COPY wait.sh /wait.sh
ENV GITBUCKET_VERSION 4.7.1
ADD https://github.com/gitbucket/gitbucket/releases/download/${GITBUCKET_VERSION}/gitbucket.war /gitbucket.war

最後にdocker-compose.ymlです。
wait.shにDBの情報を渡す必要があるため、commandでGitBucketを起動します。

version: '2'
services:
  gitbucket:
    build: gitbucket
    image: gitbucket:4.7.1
    ports:
      - "8080:8080"
    volumes:
      - ./var/gitbucket:/var/gitbucket
    depends_on:
      - db
    command: sh /wait.sh db gitbucket gitbucket java -jar /gitbucket.war

  db:
    image: mysql:5.7
    ports:
      - "3306:3306"
    environment:
      - MYSQL_RANDOM_ROOT_PASSWORD=1
      - MYSQL_DATABASE=gitbucket
      - MYSQL_USER=gitbucket
      - MYSQL_PASSWORD=gitbucket
      - TZ=Asia/Tokyo
    command: mysqld --character-set-server=utf8 --collation-server=utf8_unicode_ci

以上、このようなスクリプトを挟む事でDBの起動完了を待ってからWebアプリを起動できるようになります。

参考

VulkanをサポートしたOculus QuestでVisual Effect Graphを使う

KOGA Mitsuhiro — Sun, 23 Feb 2020 16:51:00 +0000

はじめに

Unity2019.3になってOculus QuestでVulkanがサポートされました。
更にURP 7.2.0からXR周りが改善されたりXR Interaction Toolkitだけでクロスプラットフォームにカメラリグやコントローラーを扱えるようになっています。

そこでUnityとPackage Managerの機能だけで外部アセットを使わずにOculus QuestでVisual Effect Graphを使ってみます。

できあがったもの

スクリーンショットと動画
ソース
- https://github.com/shiena/QuestVulkan
ビルドしたapk
- https://github.com/shiena/QuestVulkan/releases/tag/1.0.0

開発環境

Unity2019.3.1f1
- Android Build Support
- Android SDK & NDK Tools
- OpenJDK
Oculus Quest v13以上

Unityインストール時にAndroid Build Supportを展開してAndroid SDK & NDK ToolsとOpenJDKもチェックします。

手順概要

新規プロジェクト作成
Oculus Quest向けにProject Settingsを変更
Package Managerから必要なパッケージを追加
VisualEffectGraph Additionsをインポート
シーン構築
ビルドと実行
クオリティ調整

新規プロジェクト作成

UnityHubで新規作成してUniversal Template Projectから作成します。

Oculus Quest向けにProject Settingsを変更

Androidプラットフォームに変更
- メニューのファイル > ビルド設定を開き、プラットフォームからAndroidを選択してSwitch Platformボタンを押します。
Oculus Quest向けにProject Settingsを変更
1. Build Settingsのプレイヤー設定ボタンを押してProject Settingsを開きます。
2. Player > Androidアイコン > その他の設定を開きます。
  - Graphics APIsをVulkanのみに変更
  - 最低APIレベルを4.4から6.0に変更
3. XR Plugin Managementを開きます。
  1. Install XR Plugin Managementボタン、Oculus XR PluginのInstallボタンの順に押します。
  2. AndroidアイコンのPlugin ProvidersにOculus Loadersを追加します。
4. Oculusを開きます。
  - 作成ボタンを押してOculus Quest用の設定を作ります。

Package Managerから必要なパッケージを追加

メニューのウインドウ > Package Managerを開き、AdvancedからShow preview packagesをチェックしてプレビューバージョンを見えるようにします。
プロジェクト内をすべてのパッケージに変更して以下のパッケージをインストールします。
- XR Integration Toolkit
- Visual Effect Graphの7.2以上
- Universal RPの7.2以上
- Android Logcat

VisualEffectGraph Additionsをインポート

Package ManagerのVisual Effect GraphからVisualEffectGraph AdditionsのImport into Projectボタンを押します。
Assets/Samples/Visual Effect Graph/7.2.1/VisualEffectGraph Additions/VFX/にアセットが作られますがそのままでは動かないのでメニューの編集 > Visual Effects > Rebuild All Visual Effect Graphsから再コンパイルします。

シーン構築

メニューのゲームオブジェクト > XR > Room-Scale XR Rigを選択するとMain CameraがVR用のXR Rigに変換されます。

元のカメラに合わせる場合は以下のTransformになります。
Assets/Samples/Visual Effect Graph/7.2.1/VisualEffectGraph Additions/Prefabs/にあるVFXのプレハブをヒエラルキーに追加します。
追加したVFXをカメラから見やすい位置に調整します。

ビルドと実行

メニューのファイル > ビルド設定を開きます。
デバイスを実行しますからOculus Questを選択します。
ビルドして実行ボタンを押します。
アプリを起動してメニューのウインドウ > 分析 > Android Logcatを開くとVulkanが使われているのが分かります。

クオリティ調整

このままでもVisual Effect Graphは動きますがBloomが弱いのでPCと比べると貧弱です。以下の設定を行うとBloomの違いが分かります。
ただしHDRとPostProcessingはOculusの開発者ブログでパフォーマンス低下させると指摘されているようにFPSが更に下がってしまいます。

Getting Started with Unity’s Lightweight Render Pipeline (LWRP)
クオリティ調整後のスクリーンショットと動画
ビルドしたapk
- https://github.com/shiena/QuestVulkan/releases/tag/1.1.0

Assets/Settings/UniversalRP-MediumQuality.assetsをAssets/Settings/UniversalRP-OculusQuest.assetsに複製して以下の項目を変更します。
- HDRを有効にする
- Anti Aliasing (MSAA)を4xにする
- Grading ModeをHigh Dynamic Rangeにする
Player Settings > 品質にOculusQuestを追加して以下の項目を変更します。
- AndroidのDefaultに設定する
- RenderingにUniversalRP-OculusQuestを設定する
- それ以外はMediumと同じ
Player Settings > グラフィックスのスクリプタブルレンダーパイプライン設定にUniversalRP-OculusQuestを設定します。

その他

カメラのPost Processingを有効にしてStereo Rendering ModeをMultiviewにすると右目の位置がおかしくなります。
Post Processingが重いのでFPSは40～60くらいしか出ません。Post Processingを無効にすると70FPSくらい出ます。
Visual Effect GraphをRebuildするとOpenGLES3でもVulkanと同様に表示できました。設定ミスの場合~~OpenGLES3だとVisual Effect Graphのエフェクトが謎のレーザーになってしまいました。~~

Groovy2系(Gradle)はコメント中の\uもUnicodeエスケープされる

KOGA Mitsuhiro — Wed, 05 Feb 2020 04:05:00 +0000

Groovy2系の文字列リテラルは\u0000のように\uに続けて4桁の数字でUnicodeエスケープされます。
このUnicodeエスケープは文字列リテラルだけではなく困った事にコメントにも適用されます。なので例えば以下のようなコメントを書くとエラーになります。

// C:\upload

この動作は以下のバグレポートによるとバージョン2系のパーサーはunicode readerでソースコードを読み込むので発生するとコメントされていました。つまり文字列やコメントだけではなくコードすべてに対してUnicodeエスケープしているという事です。

Certain string(s) in comments cause General error during parsing: Did not find four digit hex character code.

バージョン3系ではパーサーが新しくなりコメントに\uを含めることができます。またドキュメントから見つけられなかったのですがスラッシュ文字列とドルスラッシュ文字列も\uはUnicodeエスケープされなくなりました。

Release notes for Groovy 3.0

とは言え、まだリリースされていないので今はどうにかしてコード中から\uを取り除く必要があります。

そもそもの発端はUnityでAndroid用にカスタム build.gradle テンプレートを利用してDIR_UNITYPROJECTをプロジェクトフォルダの絶対パスに置換する機能を使った時にuで始まるフォルダがあった事が原因でWindowsでエラーが起きた事でした。
Unity2019.1以降ならDIR_UNITYPROJECTを置換する時にパス区切り文字をエスケープして\\で出力するのでこの変数で問題は起きないようです。

Windows版IntelliJでSource Han Code JPとMyricaがフォント一覧に表示されない

KOGA Mitsuhiro — Tue, 28 Jan 2020 18:10:00 +0000

はじめに

コーディング向けフォントにMyricaとSource Han Code JPがあります。
これらのフォントは視認性が高く気に入っていたのでWindows版のIntelliJで使おうとしたのですが使えなかった話です。
ちなみにMac版だと問題なく表示できます。ぐぬぬ…

原因を探る

IntelliJはOSSなのでフォント選択部分のソースを探します。

https://github.com/JetBrains/intellij-community/blob/143/platform/lang-impl/src/com/intellij/application/options/colors/FontOptions.java#L360-L387

大体、この辺りなのでチェックコードを抜き出して検証してみます。
以下の条件をすべて満たすとフォント一覧に表示されます。

フォント名が.boldで終わらない
フォント名が.italicで終わらない
標準フォントと太字フォントでアセントとディセントが0以上
標準フォントと太字フォントで小文字のl、大文字のW、スペースの幅が1以上

検証環境

OS: Windows8.1
Java: 1.8.0_60

検証用のコード

import java.awt.*;
import java.util.Arrays;
import javax.swing.*;

public class Main extends JPanel {

    private static final long serialVersionUID = -1L;

    public static void main(String[] args) {
        Main m = new Main();
        GraphicsEnvironment ge = GraphicsEnvironment.getLocalGraphicsEnvironment();
        Arrays.stream(ge.getAvailableFontFamilyNames()).forEach(m::checkFont);
    }

    void checkFont(String fontName) {
        Font plainFont = new Font(fontName, Font.PLAIN, 12);
        System.out.print("| " + fontName + " |");
        if (plainFont.canDisplay('W')) {
            Font boldFont = plainFont.deriveFont(Font.BOLD);
            FontMetrics plainMetrics = getFontMetrics(plainFont);
            FontMetrics boldMetrics = getFontMetrics(boldFont);

            int plainDescent = plainMetrics.getDescent();
            int plainAscent = plainMetrics.getAscent();
            int boldDescent = boldMetrics.getDescent();
            int boldAscent = boldMetrics.getAscent();
            System.out.printf(" %d | %d | %d | %d |", plainDescent, plainAscent, boldDescent, boldAscent);

            int plainL = plainMetrics.charWidth('l');
            int boldL = boldMetrics.charWidth('l');
            int plainW = plainMetrics.charWidth('W');
            int boldW = boldMetrics.charWidth('W');
            int plainSpace = plainMetrics.charWidth(' ');
            int boldSpace = boldMetrics.charWidth(' ');
            System.out.printf(" %d | %d | %d | %d", plainL, boldL, plainW, boldW, plainSpace, boldSpace);
        }
        System.out.println(" |");
    }
}

検証結果

Myrica

plainDescentとboldDescentが負数なのでNG

フォント名	plainDescent	plainAscent	boldDescent	boldAscent	plainL	boldL	plainW	boldW
Myrica M	-1	10	-1	10	6	7	6	7
Myrica N	-1	10	-1	10	4	5	4	5
Myrica P	-1	10	-1	10	6	7	6	7

Source Han Code JP

plainAscentとboldAscentが負数および文字幅が0なのでNG

フォント名	plainDescent	plainAscent	boldDescent	boldAscent
Source Han Code JP B	240	-239	240	-239
Source Han Code JP EL	240	-239	240	-239
Source Han Code JP H	240	-239	240	-239
Source Han Code JP L	240	-239	240	-239
Source Han Code JP M	240	-239	240	-239
Source Han Code JP N	240	-239	240	-239
Source Han Code JP R	240	-239	240	-239

ＭＳゴシックとＭＳ明朝

参考までにＭＳゴシックとＭＳ明朝の値です。

フォント名	plainDescent	plainAscent	boldDescent	boldAscent	plainL	boldL	plainW	boldW
ＭＳゴシック	2	11	2	11	6	7	6	7
ＭＳ明朝	2	11	2	11	6	7	6	7
ＭＳＰゴシック	2	11	2	11	3	4	9	10
ＭＳＰ明朝	2	11	2	11	3	4	11	12

結論

フォント周りは分からないので原因も分からないのですが見事にチェックに引っかかっています。
どうすればいいんだ…