Unity Automated QA雑感

Unity Automated QA パッケージが公開されました。 まだアルファリリース (0.2.0-preview.3) ですが、少し触ってみたメモ。

［12/26追記］v0.8.1対応の『Unity Automated QA攻略ガイド』をコミックマーケット99で頒布します。詳しくはこちらの記事を参照してください

www.nowsprinting.com

概要

Unityエディタ上で動く、uGUI操作のキャプチャ＆リプレイ機能です。 Required: Unity 2019.4+

操作記録はjsonで保存され、エディタ上で再生できます。 また、Play mode testsに組み込んで実行でき、さらにAWS Device Farm上のAndroid端末で実行することもできます。

細かいところはまだ発展途上という感ですが、再生機能がかしこくなってくれればそれ単独で使いではありそうですし、 コンポジット機能が実用的になってくれれば（具体的にはuGUI以外も扱えるようになれば）Unityアプリの統合テストフレームワークとして有力になりそうです*1。

以下、検証したときのメモです。

Recorded Playback

• Window | Automated QA | Recorded Playback でウィンドウ表示
• RecordクリックでPlay modeになり、StopクリックまでのuGUI操作がjsonに記録される
• 記録したjsonはリスト表示され、Playクリックで再生
• jsonファイル名はデフォルトでタイムスタンプ、リネーム可能
• Assertの機構はない
• 対象オブジェクトが無いなど操作できない場合、コンソールに Warning Error *2 メッセージを出して再生が継続される
• 実行時にスクショを取っている（~/Library/下に出力され、参照するUIは無い）

jsonフォーマットについて

• 時間(timeDelta)、座標、object name, tag, hierarchy, offset が記録されている。いい感じに再生時に解釈してくれていることを期待
• イベントはpointer-down/upで記録しているので、長押しやドラッグも表現できている
• ButtonのTextやImageは（要するに子オブジェクトまでは）拾っていない
• idも保持していない。都度変わるので保存しても仕方ないから？
• Sceneも記録されているがRecorded Playbackでは使用されない（PlayでそのSceneを開いたりはしない）。後述のRecorded Testing機能で使用される

Composite Recordings

• Window | Automated QA | Advanced | Composite Recordings でウィンドウ表示
• 複数の操作記録jsonを選択し、つなげたjsonを生成（マージされるのでなく各jsonをポイントするjsonを生成）
• 部分操作を記録できる（上記Recorded PlaybackだとPlay modeのライフサイクルでしか撮れないので）
• こちらもAssertの機構はない
• 将来的に、記録した操作だけでなくC#スクリプトやML-Agentsのエージェントを組み込めるようにしたいとのこと
  • v0.3.1で Automators が追加された

Recorded Testing

• Tools*3 | Automated QA | Generate Recorded Tests で、 Assets/AutomatedTesting/GeneratedTests下にPlay modeテストコードが出力される
• asmdefも作られる
• テストコードは操作記録jsonと1:1で、中身はjsonを読んで再生している。再生終了後にAssertを自分で追加することは可能
• テストケースごとに、jsonに記録されているSceneをロードしてから再生してくれる
• 対象オブジェクトが無いなど操作できない場合、コンソールに Warningメッセージを出して再生が継続される（Recorded Playbackウィンドウでの再生と同様） Errorログを出力して再生は継続されるが、このログのためテストはFailする *4

生成されるテストコードの例

[UnityTest]
[RecordedTest("Recordings/composite-recording-2021-04-19-T01-05-01.json")]
public IEnumerator CanPlayToEnd()
{
    yield return RecordedTesting.TestPlayToEnd();
    Assert.IsTrue(true);
}

この機能で遭遇したエラーとその回避方法はこちらのエントリを参照。

www.nowsprinting.com

Running Recorded Tests on a Cloud Device Farm

• AWS Device Farm上のAndroid端末でもテスト実行できる*5。AWSとの直接契約・操作は不要
  • アーリーアクセス機能
  • 2021/6まで、Unity Proアカウントに100hのクラウドテストを無料トライアル
  • 以降 $10/device/hour *6 *7
• アップロードなどのUIは実装されている（権利がなくて未検証）

参考

docs.unity3d.com

forum.unity.com

blogs.unity3d.com

*1:到達点は統合テストだと思うので、QAという名前は違和感ありますが。それはそれ

*2:v0.3.1で変更された

*3:なぜ一箇所にまとめてくれないのか

*4:v0.3.1で変更された。もし操作不能を無視してテストを成功させたければ、LogAssertを使えばいい

*5:Automated QAのテストに限らず、and other Unity testsが実行可能。であればパッケージ分けてほしかった

*6:AWS Device Farmを直接使っても $0.17/device/minute == $10.2/device/hour なのでむしろ少し安い。see: https://aws.amazon.com/device-farm/pricing/

*7:表記がhourなのでhour単位に切り上げられる恐れはあるかも。要確認

Unity 2020.2時点のRoslyn Analyzerサポート状況まとめ

Unity 2020.2でRoslynアナライザによる静的解析が動作するようになりました。しかし、まだ色々と制限があるようなので現時点のサポート状況を検証してまとめてみました。

検証に使用したプロジェクト も公開していますので、認識違い等あれば教えていただると嬉しいです。

Unity 2020.2以降の主な更新内容

Unity 2020.3.4

• Packages下（Embedded package, Local package, Package from UPM registry/ Git URL）かつAssembly Definition File (.asmdef) 管理下のアナライザDLLが認識されるようになった
• 通常のコンパイルステップで診断が実行されるようになった（以前はファイル更新かReimport契機）

Unity 2020.3.6

• IDEsプラグインパッケージの対応バージョン*1との組み合わせで、IDEsでもAnalyzer Scope（asmdefの依存関係を反映した適用範囲）が機能するようになった（2021.1.2からのバックポーティング）

Unity 2021.1.0

• Rulesetの変更が即時反映されるようになった（Unity 2020ではReimportが必要）
• BatchmodeでビルドするときにもRulesetが反映されるようになった
• Roslyn AnalyzerがあるとDeterministic Compilationが効かなくなる問題*2が修正された*3
• Roslyn Analyzerによる重要度Errorの検出がある状態でAssets | Open C# Projectを実行してもslnおよびcsprojファイルが生成（更新）されない問題が修正された*4

Unity 2021.1.2

• IDEsプラグインパッケージの対応バージョンとの組み合わせで、IDEsでもAnalyzer Scope（asmdefの依存関係を反映した適用範囲）が機能するようになった*5

Unity 2021.2.0

• 内包するMicrosoft.CodeAnalysis.CSharpバージョンがv3.5からv3.9に変更され、Microsoft.CodeAnalysis.CSharp v3.6以降を使ってビルドされたアナライザ*6が動作するようになった

Unity 2022.1.0

• 内包するMicrosoft.CodeAnalysis.CSharpバージョンがv3.9からv3.11に変更された [2024-02-29 追記]

アナライザのスコープ/ .csprojへの反映

	Unity 2020.2+	JetBrains Rider Editor v2.0.6+	Code Editor Package for Visual Studio Code v1.2.0+	Code Editor Package for Visual Studio v2.0.7
Analyzer Scope (asmdefの依存関係を反映) *7	○	☓ *8 → ○*9	☓ *10 → ○*11	☓ *12 → ○*13
Assetsフォルダ下のDLLs	○	○	○	- → ○*14
Embedded package下のDLLs *15	☓ → ○ *16	○	○	- → ○*17
Local package, UPM registry or Git URLから取得したPackage下のDLLs	☓ → ○ *18	☓ *19 → ○*20	☓ *21 → ○*22	- → ○*23

Unity 2020.2+ 列は、Unity Editor GUIで診断実行する際のアナライザのスコープ（適用範囲）について。

その他は、Assets | Open C# Project でIDEを開くときに生成される.csprojへの反映状況です。 JetBrains Rider Editorはv2.0.6で、Visual Studio Code Editorはv1.2.0で、Unityエディタ向けに設定されたRoslynアナライザのDLLがあると.csprojに <Analyzer> ノードが追加されるようになっています。

Unityエディタ (GUI) / IDEでの診断実行

	Unity 2020.2+	JetBrains Rider 2021.1	VSCode	VS 2019
診断実行	○ *24	○
重要度設定（.ruleset）	○ *25	☓ → ○*26
重要度設定（.editorconfig）	☓	○
重要度設定（IDE独自）	-	○ *27
診断の抑止（シンボル） *28	○	○
診断の抑止（行）*29	○	☓ → ○ *30
特定のアナライザ*31	☓ → ○ *32	○

空欄は未検証です

CLIでの診断実行

	Unity 2020.2+ Batchmode	JetBrains ReSharper CLT 2021.1	dotnet build	Standalone Analyzer
診断実行	○ *33	☓ *34
重要度設定（.ruleset）	☓ → ○ *35	-
重要度設定（.editorconfig）	☓	-
重要度設定（IDE独自）	-	-
診断の抑止（シンボル）	○	-
診断の抑止（行）	○	-

空欄は未検証です

所感

もうなにも信じられない

参考

docs.unity3d.com

forum.unity.com

github.com

docs.microsoft.com

docs.microsoft.com

*1:JetBrains Rider Editor v3.0.9+, Code Editor Package for Visual Studio Code v1.2.4+, Code Editor Package for Visual Studio v2.0.11+

*2:検証プロジェクト https://github.com/nowsprinting/DeterministicCompilationWithRoslynAnalyzer

*3:Unity 2020.3.26f1では修正されていない

*4:Unity 2020.3.27f1では修正されていない

*5:Unity 2020.3.6にバックポートされた

*6:Microsoft.Unity.AnalyzersやNUnit.Analyzers

*7:https://docs.unity3d.com/2020.2/Documentation/Manual/roslyn-analyzers.html

*8:asmdefの依存関係に関わらず、全てのアナライザが全ての.csprojに設定される

*9:v3.0.9で対応。ただしUnity 2020.3.6f1以降もしくは2021.1.2f1以降も必要

*10:asmdefの依存関係に関わらず、全てのアナライザが全ての.csprojに設定される

*11:v1.2.4で対応。ただしUnity 2020.3.6f1以降もしくは2021.1.2f1以降も必要

*12:常に /Applications/Visual Studio.app/Contents/Resources/lib/monodevelop/AddIns/MonoDevelop.Unity/Analyzers/Microsoft.Unity.Analyzers.dll だけが追加される

*13:v2.0.11で対応。ただしUnity 2020.3.6f1以降もしくは2021.1.2f1以降も必要

*14:v2.0.11で対応。ただしUnity 2020.3.6f1以降もしくは2021.1.2f1以降も必要

*15:https://docs.unity3d.com/2020.2/Documentation/Manual/roslyn-analyzers.html に記述のある、Plugin Inspectorでラベルの設定がPackages下のDLLでは表示されないため、Assets下でラベル設定した後にPackages下に移動して検証しています

*16:Unity 2020.3.4で解消（Release notesおよびIssue trackerには記載なし）。なお、Unity 2020.3.3以前でもasmdef下にないDLLは有効

*17:v2.0.11で対応。ただしUnity 2020.3.6f1以降もしくは2021.1.2f1以降も必要

*18:Unity 2020.3.4で解消（Release notesおよびIssue trackerには記載なし）。なお、Unity 2020.3.3以前でもasmdef下にないDLLは有効

*19:.csprojに<Analyzer>ノードは追加されるが、パスがUnityエディタ上のPackages下を指すためDLLの実体が無く無効

*20:v3.0.9で対応

*21:.csprojに<Analyzer>ノードは追加されるが、パスがUnityエディタ上のPackages下を指すためDLLの実体が無く無効

*22:v1.2.4で対応。ただしUnity 2020.3.6f1以降もしくは2021.1.2f1以降も必要

*23:v2.0.11で対応。ただしUnity 2020.3.6f1以降もしくは2021.1.2f1以降も必要

*24:Unity 2020.2では診断は当該ファイルのコンパイルもしくはReimportの契機でのみ実行されたが、Unity 2020.3.4で通常のコンパイルステップで動作するよう変更された

*25:Unity 2020では変更を反映するのにReimportが必要だったが、Unity 2021.1でRuleset適用タイミングを早める修正が入ったことによりこの問題も解消

*26:Rider Editor package v3.0.9で対応

*27:Preferences...で設定して.sln.DotSettingsに保存

*28:SuppressMessageアトリビュート

*29:#pragma warning disable/restoreディレクティブ

*30:Rider 2021.1以前ではクイックフィックス候補に"// ReSharper disable"が出るが、Roslynアナライザの診断結果には無効。Rider 2021.2 EAP1以降で"Disable with #pragma"が選択可能になった

*31:NUnit.Analyzersが適用されない。要因は不明

*32:Unity 2021.2で解消

*33:ビルドログに出るのでパースが必要

*34:https://youtrack.jetbrains.com/issue/RSRP-480257 voteしましょう

*35:Unity 2021.1で解消

『ソフトウェア品質を高める開発者テスト アジャイル時代の実践的・効率的なテストのやり方』レビュー

昨日発売された『ソフトウェア品質を高める開発者テスト アジャイル時代の実践的・効率的なテストのやり方』、ざっくりと読んだので簡単にレビューします。

ソフトウェア品質を高める開発者テスト アジャイル時代の実践的・効率的なテストのやり方

対象読者

まず対象読者について。タイトルにある「開発者テスト」や「ユニットテスト」というものを実践している方はもちろん、言葉は知っていて良いテストを書きたいを思っている方などには 向きません *1。

そうではなく、旧来の、開発の後工程としてテストを実施し、バグを潰しきれずに疲弊している組織の方におすすめしたい書籍です。

早期工程でのバグ検出・品質作り込み（本書では「上流品質向上」と表現）、ユニットテスト、リファクタリング、CI（継続的インテグレーション）といったモダンな開発手法に馴染みのない方にとって、一通りの知識をこの一冊でざっくり得られるはずです。

おすすめできる点

• はじめにモチベーションとして、上流品質向上やShift Leftの効果についてしっかり語られている
• コードカバレッジについて、ステートメントカバレッジ (C0) とブランチカバレッジ (C1) の違いについて詳しく書かれている
• サイクロマティック複雑度（本書では単に「複雑度」や「McCabe数」と表現）について、詳しく書かれている
• Googleのバグ予測（修正回数の多いファイルはバグ混入率が高い）に触れられている
• テストケースを作るためのテスト技法について触れられている（ただし境界値テストと状態遷移テストのみ。これを目的にするのであれば後述する別書籍をおすすめします）
• システムテストなど後工程のテストにも言及、全体を俯瞰できるはず
• Android Studioを使ったユニットテスト、コードカバレッジ採取、Circle CIによるCIなど、実践的なサンプルやスクリーンショット（ただし巻末の1割程度のボリューム）

おすすめできない点

• 用語が独自なので、この書籍を読んだ次のステップで調べたり、他のテストエンジニアと交流する段階でギャップが出そう。本書を読んだ後、 JSTQB認定テスト技術者資格-シラバス（学習事項）・用語集- などを参照してテスト用語の認識を合わせたほうがよさそうです *2 *3
• リファクタリングの根拠がファイルの大きさとサイクロマティック複雑度のみなので、もう少し内部品質やSOLID原則あたりに言及してほしかった
• 「7.5　出口は1つ」は鵜呑みにしてほしくない。サイクロマティック複雑度を根拠にしているので仕方ないが、関数/メソッドから早期リターンすることはネストを下げて可読性向上につながるので

テスト技法についてのおすすめ資料・書籍

ユニットテストを書く開発者が、テストケースを作るために参考となる「テスト技法」についての資料・書籍を紹介します。

JaSST'21 Tokyoでの河野哲也さんのセッション資料。ユニットテストで使える「同値分割」「デシジョンテーブル」「状態遷移図」が例題とともに紹介されています。

The use of test design for organizing specifications from Tetsuya Kouno

www.slideshare.net

こちらも各テスト技法を解説している書籍です。

ソフトウェアテスト技法ドリル―テスト設計の考え方と実際

各テスト技法の事例・問題集。

ソフトウェアテスト技法練習帳 ～知識を経験に変える40問～

所感

書籍などでユニットテストについて紹介するとき、テストケースを作るためのテスト技法は省略されがちです*4。 しかし、開発者もテストを書くならば持つべきスキルだと考えており、その点で本書のように開発者テストとテスト技法を結びつける書籍に期待していました。

本書は残念ながら方向性の異なるものでしたが、「開発者テスト」の概念を知らない方に向けて、薄く広く、俯瞰して理解できる書籍ですので、最初の一冊としてはおすすめできそうです。

*1:内容が悪いという意味ではなく、タイトルがミスリードなのでは感

*2:ISTQB/JSTQBが絶対ということではないのですが

*3:私が「単体テスト」でなく「ユニットテスト」という言葉を使うのは、「単体テスト」が人によって様々なバリエーションを持っているため無用な混乱を避けるためです。この点、本書p.34でも言及されていながら「単体テスト」の語を使っていたりする

*4:自著『iOSアプリテスト自動化入門』では、同値クラス、境界値テスト、デシジョンテーブルについては紹介していましたが

ML-Agentsに入門するならUnity LearnのML-Agents: Penguinsがおすすめ

個人差があるとは思いますが、最初のチュートリアルとして良いサイズだと思うので（そしてUnity Learnの検索で出てこないので）紹介します。

おすすめポイントは、

• ダウンロードするファイルはペンギン等のfbxのみ
• コードは説明付きで小分けに提示されていて、コピペするにしても内容を把握しながらできる*1
• 学習用Python環境のセットアップも解説されている（Anacondaを使用）

なお、Unity Learnは無料で提供されています。

ML-Agents: Penguins

learn.unity.com

このコンテンツ、内容が古いためかUnity Learnの検索で出てきません。 Unity ML-Agents Toolkitは2020年5月に晴れてバージョン1.0がリリースされ、最新版はRelease 12です*2 *3。 一方、このPenguinsチュートリアルはBeta 0.13をベースとしています。

そのため、上記ページそのままではなく、チュートリアルを提供しているImmersive Limit LLCが別に公開しているアップデート情報*4を元に進めます。

www.immersivelimit.com

以下、個人的な補足です。

• Unity packageはUPM、Python packageはpipで取得できるため、Unity ML-Agents Toolkit リポジトリのclone取得は不要です*5
• UnityのPackage Managerウィンドウでは ML-Agents 1.0.6 (verified) までしか出ませんが、Packages/manifest.jsonを直接編集すれば 1.7.2-preview も指定できます
• Anacondaは必須ではありません。ただし何かしらのPythonパッケージ+環境管理ソリューション*6は使ったほうがよさそう
• Anacondaで環境を作るとき、名前は ml-agents より、Python packageのバージョンを加えて ml-agents-0.23 などとするのがよさそう
• gitリポジトリで管理するとき、ML-Agentsの生成するファイルは.gitignoreに下記を追加することでトラッキング対象外にできます

Assets/ML-Agents*
results/

自分で学習させたペンギンが動くのはかわいくて、ずっと見てても飽きないですね。

その他のUnity Learnコンテンツについて

Karting Mod：スマートカートのトレーニングガイド

learn.unity.com

日本語対応しているものですが、以下の理由で最初にはおすすめしません。

• Penguins同様 0.13 ベースで古い（ML-Agentsはプロジェクトに内包しているので動かしてみるだけなら問題はない）
• Penguinsに比べて要素が多い

ML-Agents: Hummingbirds

learn.unity.com

こちらはバージョン1.0 (Release 1) 時点でのコンテンツです。 動画による前提の説明もあり、「強化学習なんもわからん」人にはこちらから入ってもいいかもしれません。

ただ、説明がほとんど動画で時間もかかるので途中までで止めてしまいました。 続きを進めたらこの記事を更新するつもりです。

参考

Unity ML-Agents Toolkit に入ってるexamplesの解説

ml-agents/Learning-Environment-Examples.md at release_12_docs · Unity-Technologies/ml-agents · GitHub

Unity ML-Agents Toolkit のマイグレーション情報

ml-agents/Migrating.md at main · Unity-Technologies/ml-agents · GitHub

ML Agents 1.0以降に入った変更などの話

https://blogs.unity3d.com/jp/2020/12/28/happy-holidays-from-the-unity-ml-agents-team/blogs.unity3d.com

*1:完成プロジェクトで説明される場合、どこまでML Agentsでどこから自作した機能なのかわからないことが起こりがち

*2:Unity packageとPython packageで別々のバージョンが振られているためこの表現。ちなみにRelease 12のUnity packageは1.7.2、Python packageは0.23.0

*3:これを書いた2日後にRelease 13が出ました

*4:ML-Agents Release 10 向けアップデートとなっていますが、Release 12でもそのまま動きました

*5:多数のExamplesがあるので次のステップとして触ってみるには良いと思います

*6:Minicondaとかvenvとか

#cluster 勉強会・イベント登壇Tips

yokohama.unity をはじめ、オンライン勉強会の会場として cluster が使われることも珍しくなくなりました。 つまり、clusterで登壇する機会も増えているということです。

clusterでの登壇には、リアル会場やZoomなどWeb会議サービスとは異なる特性があります。 本記事では主に、はじめてclusterで登壇する方向けのTipsをまとめます。

機材の準備

PC

clusterのイベントにはスマートフォン (iOS, Android) でも参加できますが、スライドや動画の再生操作を行なうためにはPC (Windows, Mac) からのログインが必要です。

もちろん、スライド操作を誰かに代行してもらって自分はスマートフォンで話すという選択肢もあります。どうしてもPCが使えない場合など、主催者に相談してみてもいいでしょう。

ヘッドホン / イヤホン

音声のループバック対策は重要です。 ループバックは、スピーカーから出た音をマイクが拾ってしまうことで再びスピーカーから同じ音声が（遅延して）出力されてしまう現象です。 Zoomではサービス側でノイズリダクションが効いているのでノートPC内蔵のスピーカーとマイクでも大丈夫ですが、clusterではこの機能が弱いため、あらかじめユーザ側で対策しておく必要があります。

具体的には、ヘッドホンやイヤホンを使うことで、clusterからの音声出力がマイクに入らないようにする対策が効果的です。

スマートフォンに同梱されているイヤホンで十分ですが、Bluetooth接続やノイズキャンセリングなどあれば快適さは増します。 あえておすすめと言われるとこれですね。

Apple AirPods Pro ワイヤレス充電対応

もしくは、Krispのようなノイズリダクションできるソフトウェアを導入する方法もあります。

krisp.ai

マイク（任意）

環境音やエコーを防ぐため、外付けのマイクの使用が望ましいです。 指向性のあるコンデンサマイク（数千円のもので十分）で自分の声のみ拾うようにするだけで、ハウリングやタイプ音が軽減できます*1。

私が使っているのはこれ。

FIFINE USBマイク フレキシブルマイク コンデンサーマイク グースネックアーム搭載 ミュート機能付き 音量調節可能 単一指向性 PC用マイク ネット通話 ライブ配信 ゲーム実況 在宅勤務 テレワーク Windows/Mac/PS4対応 K052

VRヘッドセット（任意）

これは任意ですが、VRヘッドセットを使ってVR登壇する体験はおすすめです。デスクトップに比べ、以下のメリットがあります。

• 見回しやすい：オーディエンスの反応と投影されているスライドを交互に見ることも簡単です*2
• 指し棒が使いやすい：会場によっては指し棒が用意されています。デスクトップ版でも手に持って指すことはできますが、VRのほうが断然、扱いやすいです
• 細かいリアクション：デスクトップでは移動でしかアバターが動きませんが、VR登壇であれば身振り手振りを交えたプレゼンテーションが可能です（意識して動かすのでなく、自然な動きがアバターにも反映される）
• 会場のギミックで遊べる：会場によってはギミックやアイテムが転がっていたりします。デスクトップでも遊べますが、VRのほうが楽しいです

なお、オーディエンスとして参加する場合はPCデスクトップのほうがキーボードでコメントを打てるので楽しいと思います。

PC向けVRヘッドセットは色々と出ていますが、今なら（PCのグラボが要件を満たしているならば）Oculus Quest 2をUSBケーブルで接続して使う (Oculus Link) のがおすすめです*3。

Oculus Quest 2—完全ワイヤレスのオールインワンVRヘッドセット—256GB

support.oculus.com

2021/12/9に、Oculus Quest 2単体で動作するclusterクライアントがリリースされました。これでPCを接続することなくclusterを使うことができるようになりました。

note.com

プレゼンテーション資料

スライドはpdf、動画はmp4形式で準備し、あらかじめclusterにアップロードしておきます。

会場のスクリーン比率はほとんど16:9ですが、一部4:3やオリジナルな比率である可能性もあります。念のため主催者に確認することをおすすめします。

文字サイズは、リアル会場で投影するものと同じ感覚で作るのが良さそうです。 ただ、リアル会場と異なり、見づらい場合は自由に前に来て見ればいいわけなので、遠くからでも読める必要はありません。

また、スライドの途中に動画を挟む場合、pdfファイルは動画の前と後ろで分割しておくことをおすすめします。 ファイルを切り替えたときにスライドのページが先頭に戻ってしまいますので、動画再生後スムーズに続きのスライドを表示できるようにしておきます。

ファイルサイズ上限は下記ページを参照してください。

アップロードできるファイルとサイズ上限 – ヘルプセンター | cluster（クラスター）

画面共有［2022/4/18追記］

cluster v2.23で、画面共有機能が追加されました。これで、事前にスライドや動画をアップロードすることなく、手元のPC画面を共有してプレゼンすることができそうです。

note.com

なお、VRヘッドセットをかぶったままPCでスライドのページ送りなどを行なうことは難しそうですが、指に装着できるコントローラを併用すれば、さながらリアル会場のようにプレゼンできるのではないでしょうか*4。

[asin:B077L7WG9R:detail]

アバター（任意）

clusterのイベントでは 「スタッフ」に割り当てられていると独自アバターを使うことができます。 ほとんどのイベントでは登壇者は「スタッフ」になるはずですが、アバターが使えない「ゲスト」を割り当てるケースも考えられます。事前に主催者に確認することをおすすめします。 2021年3月26日より、イベント参加者全員が独自アバターを使用できるようになりました。

アバター使用は任意ですが、SNSアイコンのようにオーディエンスに印象づける効果が見込めます。

アバターは、主に以下いずれかの方法で用意できます。

1. REALITYアバターをコンバート

REALITY の自分のアバターをclusterに持ち込めます。カスタマイズ幅は限定されてしまいますが、もっともお手軽な方法です。

コンバート手順は下記記事を参照してください。

note.com

2. VRoid Studio

VRoid Studio を使ってオリジナルのアバターを作り、VRM形式にエクスポートしてclusterにアップロードします。 BOOTH などでVRoid対応の服テクスチャやアクセサリなども販売されており、独自のアバターを作りたいのであればこれが最有力です。

なお、cluster準拠のVRMにするためにエクスポート時にリダクションする必要があります。概ね、

• マテリアル数: 8
• テクスチャ解像度: 2048x2048

に設定してエクスポートすれば大丈夫なはずです。

vroid.com

ただし、リッチなアバターになるとVRoid Studio標準のエクスポート機能だけではcluster準拠にまで落とせないケースもあります。 下記記事などを参考にリダクションしてみてください。

qiita.com

3. その他

BOOTH などでアバターを購入したり、自分でフルスクラッチしたモデルをUnityと UniVRM を使ってVRM形式にエクスポートしてclusterにアップロードします。

販売されているアバターには、あらかじめVRMファイルが同梱されているものもありますが、clusterにアップロードできる要件を満たしているとは限らないので注意してください。 自分でリダクションができない場合、cluster準拠と明記されていないVRMファイルは使えないと思ったほうが良いです。

詳しいスペックは下記ページを参照してください。

カスタムアバターの制限 – ヘルプセンター | cluster（クラスター）

会場の下見

イベント会場には「スタッフ」であれば開場前に入ることができます。 登壇慣れしていない場合など特に、事前に会場の様子、スクリーンのサイズやオーディエンスからの見え方などを確認しておくと良いでしょう。 手軽に下見できるのはclusterの良いところです*5。

なお、デスクトップ版およびスマートフォンの場合、デフォルトで「三人称モード」がオンになっているためやや遠い視点になっています。これをオフにした一人称視点での見え方でプレゼンテーションは調整することをおすすめします。

当日

clusterクライアントは頻繁にアップデートされているため、「ログインしようとしたらアップデート待ち」ということもよく起こります。 時間に余裕を持ってログインするとよいでしょう。

登壇してみよう！

clusterイベントへの登壇は、リアル登壇と比べても、Zoom等による登壇と比べても*6、ハードルが低いです。ぜひ機会を見つけて登壇してみましょう！

ちょうど良いところに、たいへん「ユルい」ことで有名な yokohama.unity が募集しているようですよ？

meetup.unity3d.jp

トラブルシュート

まれに、会場に入っても他の参加者が見えないというトラブルがあります。再ログインしても解消しない場合、そもそものインターネット接続経路の問題である可能性があります。

clusterを利用するには、以下のポートが開放されている必要があります。
TCPポート：80, 443, 1883

他の人が表示されない・すぐに切断される（ポート設定） – ヘルプセンター | cluster（クラスター）

この問題がイベント当日に発覚しても、すぐ対処できることは稀でしょう。 登壇者向けの接続確認会が設けられているときは、極力イベント当日に接続する環境からログインして確認しましょう。

その他の参考記事

bibinbaleo.hatenablog.com

www.crossroad-tech.com

*1:タイピングするわけではないので（clusterではライブコーディングはできないので）必須とまでは言いませんが、部屋の壁の反響などもあるのでやはり音声品質には影響します

*2:投影しているスライドは別ウィンドウで表示されるのですが解像度低いので実際に投影されているものを見たくなります。会場によっては返しのモニターが設置されていることもあります

*3:Oculus Quest 2のマイクはかなり音を拾うので、イヤホンを使いましょう

*4:まだ試していないのですが…

*5:リアルイベントだとなかなか下見できる機会がない

*6:オーディエンスの反応が見えない状態でプレゼンするのはとてもつらいです

UPMパッケージをunitypackage形式で配布する

Unityのエディタ拡張などは Unity Package Manager (UPM) で配布するのが便利です。 UPMのメリットとしては以下の点が挙げられます。

• バージョン管理、アップデートが容易
• 依存関係を設定できるため、依存先もUPMであれば同梱・再配布を回避できる
• Assetsディレクトリ下を汚さない

しかし、Unity 2019.2より前のバージョンではPackage ManagerウィンドウでGit URLが指定できなかったり、scopedRegistriesの指定のために Packages/manifest.json ファイルを直接編集しなければならず、手軽に使ってもらうにはややハードルがあります。

また、VRChatユーザへの露出を考えると BOOTH からダウンロードできる形式での配布にはメリットがありそうです。

折衷案を探っていたところ、UPMパッケージをインポートしてくれるunitypackage形式のインストーラを生成してくれるサービスを見つけたので紹介します。

glitch-package-installer

前提として、配布するUPMパッケージは OpenUPM などどこかしらのレジストリに登録されている必要があります（Git URLではできません）。

インストーラの生成は、下記のようにAPIを実行します。

$ curl -o installer.unitypackage https://package-installer.glitch.me/v1/installer/OpenUPM/com.nowsprinting.blender-like-sceneview-hotkeys?registry=https%3A%2F%2Fpackage.openupm.com

すると、installer.unitypackageというファイルが生成されます。 このファイルをUnityエディタにインポートすると、OpenUPMから com.nowsprinting.blender-like-sceneview-hotkeys の最新バージョンがインポートされます。

なお、installer.unitypackageの中身は独自のインストーラであり、実際はこのインストーラが働いて Packages/manifest.json を編集したのち、インストーラ自身を削除するという振る舞いをしています。

UPMパッケージ自体のインポートは Packages/manifest.json に従ってUPMが行なうため、以降のアップデートは Package Manager ウィンドウで行なえます。

ちなみに、レジストリにOpenUPMを使っている場合、ページ右上にある "Get installer.unitypackage" ボタンでダウンロードできるものはこれと同じものです*1。

APIの詳しい使い方はWebサイトを参照してください。

package-installer.glitch.me

ソースコードも公開されています。

github.com

補足

APIのサイトには、バージョン指定、スコープ指定の方法が書いてありますが、試したところ指定は反映されず、常にバージョンもスコープも指定なしのインストーラが生成されました*2。

また、

should work fine from 2019.1 to 2020.2+.

とありますが、 Unity 2018.4.20f1 へのインストールができることは確認しています。

(1/7追記) 上記の通り、生成されるunitypackageにはUPMパッケージ本体のコードは含まれません。従ってコードのバックアップとしては用をなさないのでご注意ください。

*1:ダウンロードされるファイル名にはパッケージのバージョン番号がついていますが、常に最新版がインストールされます

*2:時間があるときにちゃんとコード読みたい…

Blender 的なテンキー操作で視点操作できる Unityエディタ拡張

Blender 的なテンキー操作で視点操作できる Unityエディタ拡張 Blender-like SceneView Hotkeys を公開しました。 Unity 2018.3 以降で動くので VRChat SDK 向けの作業にも使えます。

3Dモデリングツール Blender の 3D Viewport では、マウス操作のほか、テンキーによって視点などを操作できます。 使ってみるととても便利で手放せなくなったので、これを Unity のシーン・ビューでも使えるよう、エディタ拡張として移植したものです。

機能

v0.2 時点で実装している機能を紹介します。

以下、スクリーンショットのモデルには火村ユウヤ氏製作の 大神ルゥ さんを使用しています。

視点の方向

テンキー 1 で正面ビュー

テンキー 3 で側面（右）ビュー

テンキー 7 で上面ビュー

また、 control + 1 で背面、 control + 3 で左面、 control + 7 で下面からのビューになります。

透視投影/ 正投影 切り替え

テンキー 5 で透視投影 (perspective) と正投影 (orthographic もしくは isometric) が切り替わります。

視点の回転

テンキー 8 2 4 6 で、上下左右に15°づつ軸を中心に視点を回転します。 また、 9 で現在の視点から180°回転した視点に切り替わります。

Roll

shift + テンキー 4 で左まわり、 6 で右まわりに、視点方向を軸に回転します。

Pan

control + テンキー 8 2 4 6 で、上下左右に視界を移動します。

Zoom

control + テンキー + でズームイン、 - でズームアウトします。

エディタ拡張のインポート方法

unitypackage ファイルからインポート

簡単なのは、 OpenUPM から installer.unitypackage をダウンロードしてインポートする方法です。

openupm.com

上のリンクを開き、ページ右の "Download installer.unitypackage" （下図の四角）をクリックします。

.unitypackage ファイルがダウンロードできますので、Unityエディタでプロジェクトを開いてインポートできます。

なお、通常の .unitypackage とは異なり、ファイルの実体は Assets フォルダ下には入らず、 Package Manager によって管理されます。 Window | Package Manager を開くと表示され、ここからアップデートも可能です。

(1/3追記) BOOTHにも.unitypackageをダウンロードできる商品（投げ銭用）を置きました。

ikagoya.booth.pm

その他の方法でインポート

その他、下記 GitHub リポジトリを直接 git URL として指定するなど、お好みの方法でインポートできます。

github.com

設定

テンキーを模倣 (Emulate Numpad)

お使いのキーボードにテンキーが無い場合、文字キー上部にある数字キーを使う設定が可能です。

Unity | Preferences ウィンドウを開いて "Blender-like SceneView Hotkeys" を選択、 "Emulate Numpad" を on にするだけです。 この設定は、UnityプロジェクトではなくPCごとに保持されます。

ただし、数字キーの 2 には別のホットキーが割り当てられています。 Unity 2019 以降であれば、ショートカットマネージャでこれを無効にするなどして競合を回避してご使用ください。

参考

Blender www.blender.org

Blender の 3Dビューポート操作マニュアル docs.blender.org

使用モデル booth.pm