2019-03-01

UnityプロジェクトをGithubリポジトリ+SourceTreeで管理するセッティング方法（Windows10）（動作確認2019年2月28日）

Unity C# チュートリアル xR チーム開発 git github gitlfs sourcetree

こんにちは　開発チームのmawaです。

想定読者

Unityプロジェクトをチーム開発したい
GithubでUnityプロジェクトのコードやモデルをチーム開発に使いたい
Windows10でUnityEditor使って開発したい

という方向けです。Unityでは３Dや２Dのグラフィックデータをたくさん扱うことが多いため、他のWebアプリなどの作成プロジェクトのようにGit+Githubというシンプル構成では対応がなかなか厳しいものになりやすいので、プラスアルファの運用知識が必要です。具体的にはGitLFSという仕組みも利用しながら、UnityEditor～GitHubまで統一的に連携が撮れた状態で開発することになります。そのためのノウハウをまとめました。

今回はWindows10でのメモです。Macでも大幅には変わらないと思いますが、GPUリソースが現状比較的低コストで使えるWindowsマシンでのUnity開発からのチーム共有のノウハウについて、まとまった記事が見つからなかったので自分でまとめました。

必要なパッケージ一覧

WSL(Windows10で使えるUbuntu)
Git for Windows
Git LFS(Git とは別のパッケージなので注意)
SourceTree for Windows
BitBucketアカウント（SourceTreeセットアップ時に強制加入させられる。bitbucket自体は今回は使わない）
GitHubアカウント
BitBucketアカウント（SourceTreeセットアップ時に強制加入させられる。bitbucket自体は今回は使わない）
Unity(バージョンは、3.3f1)

作業工程

[1]WSLがセットアップされている状態にあること
↓
[2]Git for Windows のインストール
↓
[3]GitHubのアカウント取得 ↓
[4]GitHubの管理用リポジトリ作成（unity用 .gitignoreの指定がおススメ）
↓
[5]SourceTree for Windows のインストール
↓
[6]SourceTree と GitHubアカウントの連携
↓
[7]SourceTree にて管理するローカルリポジトリの登録
↓
8Git LFSのインストール
↓
[9]SourceTree にて管理するローカルリポジトリでのGit LFS の適用（初期化）
↓
[10]SourceTree にて管理するローカルリポジトリとGitHubの管理用リポジトリの連携
↓
[11]1度git pullしてリモートとローカル同期initial commit
↓
[12].gitignore と .gitattributes　のgit add → git commit →git push
↓
[13]通常のgithub運用開始、git pull からの作って、git add → git commit →git pushのサイクル開始

作業別具体的メモ

[1]WSLがセットアップされている状態にあること

WSLのセットアップはこういう記事がたくさんあるので参考になさってください qiita.com

[2]Git for Windows のインストール

ここからダウンロード gitforwindows.org

ダウンロード時は下記以外はデフォルト設定でインストールしました。

Git Bashと、Git LFSは欲しいので、チェックしておきます。あとは惰性。 f:id:k_mawa:20190301005648p:plain

パスが変化するのは怖いのでこれを選択 f:id:k_mawa:20190301005702p:plain

これでうまくいきました。なぜかSourceTreeの運用中にGit LFSインストールされてないよとかウィンドウがでてインストール再度したので、なんかこのときのGitLFSが効いているのかどうか謎です。でも一応インストールしておいたほうが無難かなぁ・・・

[3]GitHubのアカウント取得

[4]GitHubの管理用リポジトリ作成（unity用 `.gitignore`の指定がおススメ）

[5]SourceTree for Windows のインストール

ここからインストールください
ja.atlassian.com

[6]SourceTree と GitHubアカウントの連携

[7]SourceTree にて管理するローカルリポジトリの登録

[8]SourceTree にてGit LFSのインストール

[9]SourceTree にて管理するローカルリポジトリでのGit LFS の適用（初期化）

SourceTree「new tab」開く
↓
「＋Create」ボタン
↓
「Create a repository」
- 保存先のパスを、Unityのプロジェクトのトップディレクトリを参照 - Proj名は参照後自動で入る
- 管理→Git
↓
「次のアカウントでリポジトリを作成」→空欄（リモートリポジトリは後で登録するため）
↓
「作成」
↓
「クローン作成先のパス～はすでに存在しています。続行して、このフォルダにリポジトリを作成しますか？」→「はい」を選択
↓
作業ツリーのファイルのところにファイルが並び、コミット前の状態になる。
↓
git init まで完了した状態になる。
↓
Git LFS initを行う。下記方法①と②どちらかを行えばOKだと思われる。(自分は両方やったので、どっちが効いたかわからない。たぶん①が効いた気がする。)

方法①「リポジトリ」＞Git　LFS　＞「リポジトリを初期化」>トラックファイルを適当にpngとかだけ設定する>.gitattributesもつくられる＞あとでトラックファイル種類など追記する（git lfsが未インストールの場合、「ツール」＞「オプション」でGitの設定を見て閉じようとすると「git lfs まだインストールされてませんけどしますか？」とでる）

方法②git bash を立ち上げて $ git lfs install

[10]SourceTree にて管理するローカルリポジトリとGitHubの管理用リポジトリの連携

リモートリポジトリの設定
GitHubのURLをコピーしておく
↓
「リモート」を選ぶ＞「追加」

リモート名はorigin,URLはgithub リポジトリパス
RemoteAccountはGithubのアカウント（SourceTreeに設置しておく）

↓
設定したら「OK」

[11]1度git pullしてリモートとローカル同期initial commit

1度リモートからプルしておく！（同期がおかしくなるエラーになる）
やらかしたときは、Pushに失敗してたらリセットで！

SourceTreeでGit訂正操作
qiita.com

[12]`.gitignore` と `.gitattributes`　のgit add → git commit →git push

.gitignoreファイル生成（Win10だとなんかGUIで隠しファイルつくれないので、WSLでtouchコマンド叩いて作る。（Win10の場合、/mnt/c/Users/（ユーザー名）/Documents/配下にUnityプロジェクトのフォルダがデフォルトでは作られている。編集は普通にできる。） ↓ .gitattributeファイル編集

下記記事が.gitignore と .gitattributesの設定についてわかりやすい記事でした ikep.hatenablog.com

[13]通常のgithub運用開始、git pull からの作って、git add → git commit →git pushのサイクル開始

Unityの設定を変更

VersionControl→Mode　VisibleMetaFiles
AssetSerialization→Mode　Force Text

（よくわからないけど、最初からなってた）

↓
UnityProj保存
↓
残りのファイルをGitHubにプッシュ

2019-02-25

OculusGoでレーザーで自在に操作可能なコントローラー配布中！と、そのパッケージControllerの調整記録

Unity VR OculusGo 入門講座チュートリアル xR xRGameDev

OculusGoでUIやそのほかゲームオブジェクトの挙動をレーザーで制御できるUnitypackageが配布されてまして、調整した時の記録です。

OculusGo　UI操作の出来合いのアセットが無事動きました^^ 現状だと、UI操作などは、OVR～のスクリプトを自分で書き換えなきゃいけないから、とても大変。これは、そのうちOculusIntegrationのデフォルト機能になるだろう・・・ありがたや～ #oculus #unity pic.twitter.com/LKYjnkl9Gg
— mawa (@k_mawa82) February 25, 2019

配布元ページ

これです。そのうちOculus公式アセットに組み込まれそうですね

developer.oculus.com

留意事項

2点注意事項あります。そのままビルドするとOculusGoコントローラーが回転して表示されてしまいます。ここを180と入れ込めばOKでした（2019年2月25日現在）

f:id:k_mawa:20190225175948p:plain

もう一点は、この公式ブログでの配布パッケージはrar形式で圧縮されているのですが、Win10だと7zipという解凍ソフトでないとエラーになることがあります。なお自分はPart1だけ7zipで解凍できました。Part2,3は解凍エラーになりました。謎です。

2019-02-11

OculusGoテレポート移動の実装したときのメモ

Unity VR OculusGo 入門講座チュートリアル xR xRGameDev

f:id:k_mawa:20190211210808p:plain

OculusGoでテレポート移動の実装をしてみました。

単にカメラをフレームごとに座標移動させるとVR酔いしやすいといわれています。テレポート移動はVR酔いを防ぐのに有効と言われています。 xrdevja.hatenablog.com

参考になった記事

これです。日本語だとこれしかなかったかな・・・

qiita.com

上から順にやればいいのですが、初めてOculusのSDKをさわる方には、つまづく可能性もいくつかあったのでそれを補強します。

順序とつまづきポイント

0：必要なもの

Unity
Oculus Integration(OculusのSDKセット)
ArcLocomotion.unitypackage

1:OculusSDKをダウンロード

最近（前どうやったかな・・・）AssetStoreにありますね

https://assetstore.unity.com/packages/tools/integration/oculus-integration-82022?aid=1101lGoY&utm_source=aff

つまづきポイント：ArcLocomotion.unitypackage　というサンプルはOculusSDKには入ってないので注意。

2: MainCameraをOVRCamerarigに切り替え

つまづきポイント：MainCameraは削除でOK

3: Tracked Remoteをコントローラーのアンカーに追加

ドラッグアンドドロップだけで完了^^

つまづきポイント：特になし

4: ArcLocomotion.unitypackageを入手

developer.oculus.com

つまづきポイント：下記の部分のリンクで入手です。なおUnitypackage直リンクではなく、rar圧縮ファイルになってますので注意ください。

5: ArcLocomotion.unitypackageを解凍

つまづきポイント：Win10の場合、なぜか解凍ツールでメジャーなLhaplusというソフトではエラーが起きました。7zipというツールでは解凍できました。

sevenzip.osdn.jp

こういうことは時々あるみたいです。

itojisan.xyz

6: ArcLocomotion.unitypackageをUnityにインポートしてブログ記事通りに実装

そのままドラッグアンドドロップするだけでした。

つまづきポイント：特になし

7: ビルド

つまづきポイント:特になし。

8: 完成

OculusGo テレポート実装できた^^ あとで躓きポイントまとめます #oculusgo pic.twitter.com/o65yeYs2Az
— mawa (@k_mawa82) February 11, 2019

これでステージづくりに進めますね^^

2019-02-05

xrdevjaゲーム共同開発プロジェクト議事録日時：2019年2月5日

議事録本編
xrdevjaゲーム共同開発プロジェクト議事録
日時：2019年2月5日

参加者さん：
kannonjiさん
kuroさん
keiさん
torikasyuさん
mawa

・進捗報告
(mawa)Voxelの初歩的なモデリング→Unityへの取り込みができるようになりました
(keiさん)blender進捗中。

■確認項目・23日にリアルミーティングをする前に、各自できるところまででOKで、1面つくってみる。・2月23日の14時に新宿（場所未定）で、リアル開発ミーティング＆　もくもく会をすることになったので、各人ご都合合えば是非^^

・Oculus Go 移動コントローラーは公式のものを使ってみる・OculusGoでテレポート機能をインポートするためには OculusGo 2018.3.3f1以上のバージョンが必要

https://developer.oculus.com/blog/teleport-curves-with-the-gear-vr-controller/ https://developer.oculus.com/blog/-avatar-locomotion-sample/ https://qiita.com/noitak/items/c7283d912a723e8c27fd

・UnityHub使うと便利。

VRミーティングしたい
・Oculus Rooms 何人までいけるか？　4人（2018年5月確認記事による）・次回Mtg OculusRoom できるなら

https://www.moguravr.com/oculus-rooms/

・BigScreenというものもあるらしいです knowledge.sakura.ad.jp

clusterでの報告
・cluser、モバイルアプリだとtwitterでログイン失敗する
・Webでログインしておいたら成功しました

2019-02-04

VirtualVirtualRealityのゲーム構造の報告

参考URL１

VIRTUAL REALITY INCEPTION! | Virtual Virtual Reality (Oculus Go Gameplay)

参考URL２ www.youtube.com

Virtual Virtual Realityをやってみた

VRゲームでは有名らしいです。ついにやってみました。その感想など書いておきます。 VRゲーム開発のお役に立てばと^^

どんなゲームか詳細に書くのでネタバレ注意です。

環境面での気づき

・プレイ環境はOculusGo

・OculusGoでプレイして１度も落ちなかった！

・アプリ落ちがなかった原因のひとつと思われるのが、オブジェクトのデータは極限まで簡素化してあるように思いました。リアルな描写は捨てられ、Unity基本３Dオブジェクトをちょっと手を加えたようなオブジェクトを色合いやライトのあて具合などで雰囲気をうまく出すところに注力されているように思いました。

・多言語翻訳対応実装:日本語の字幕のような感じの設定がなされる

・自動でセーブしてくれるとのことです（kurosanご指摘ありがとうございますm( )m）

・移動はテレポートタイプ：それでもちょっと酔ってしまう。これはしょうがなさそう。

ゲームのシーンの構造

1:チュートリアル的ステージ

f:id:k_mawa:20190204174741p:plain 引用元：VIRTUAL REALITY INCEPTION! | Virtual Virtual Reality (Oculus Go Gameplay) - YouTube

AI上司が登場。AI上司から、プレイヤーは人間リソース派遣会社のスタッフ（リソース）という設定と聞かされる。

AI上司にゴーグルを渡され、ゴーグルごとの世界のオーナーである無機物（主が、バターの世界、草（タンブルウィード。西部劇の風でからから回転する草）の世界、風車の世界そのほかもあるかも・・・）のリクエストに応える。うまく応えられないときはAI上司シーンに引き戻され、主からレビューがつく。たぶん悪いレビューがつくように設定されてるっぽい。悪いレビューによってAI上司がプレイヤーにキレてくる（結構リアルでちょっとウツな気分になります苦笑）

各シーンのクエスト内容は以下のとおり

バターが主のステージ

f:id:k_mawa:20190204175247p:plain 引用元：VIRTUAL REALITY INCEPTION! | Virtual Virtual Reality (Oculus Go Gameplay) - YouTube

・キッチンルーム風のステージ。巨大なしゃべるバターがキッチンの正面に配置されている。
・キッチンの周囲にはパンが入った大量の稼働中のトースターがある。きつね色になったパンをバターに貼り付ければ貼り付けるほどミッション成功。焦げたパン、焼けていないパンをバターに貼り付けると減点（のような感じ。明確なルール説明はなし。）
↓
一定時間（３分くらい？）経つとAI上司のいる仕事待機室シーンに引き戻される
↓
レビューが悪いとAI上司に怒られる

枯れ草が主のステージ

f:id:k_mawa:20190204175231p:plain 引用：VIRTUAL Virtual Reality - HTC Vive Gameplay (Part 1 of 2) - YouTube

・西部劇風ステージ。木でできたキャタピター（ルームランナーぽい機構）の上に草（タンブルウィード）が乗っていてしゃべってくる。風を送る装置を使って、キャタピターを回すことで草を永遠に回転できるようにするのがミッション。
↓
一定時間（３分くらい？）経つとAI上司のいる仕事待機室シーンに引き戻される
↓
レビューが悪いとAI上司に怒られる

風車が主のステージ

f:id:k_mawa:20190204175154p:plain 引用元：VIRTUAL REALITY INCEPTION! | Virtual Virtual Reality (Oculus Go Gameplay) - YouTube

・栽培する温室風のステージ。風車がしゃべりかけてくる。花壇に水をやるのが最初のミッション。花壇に育った歌う花を指定の場所に設置するのが２段階目のミッション。
↓
設置中に割ってしまった（割れないで成功するミッションもあるのかもしれない）
↓
風車がクレームしてくる
↓
AI上司のいる仕事待機室シーンに引き戻される
↓
レビューが悪いとAI上司に怒られる

2:脱出ステージへの移動シーン

３つミッションを終えた後で画面が突然暗くなり、別の次元に転送されたような状態になる。声が聞こえてきて「AI上司に服従する人生をやめて人間コミュニティに来たらいい」というメッセージと「そのためにコントローラーに武器を仕込んだ」というメッセージをもらう。武器は、OculusGoコントローラーを左右にスワイプすると武器モードになり、ゲームオブジェクトを吸い取ると、吐き出す（生成？）の２つのパターンがある。AI上司シーンで使うと「バレたら危ない！」と声が聞こえて武器は起動しない設定。
↓
AI上司シーンに引き戻される。AI上司から「いまノイズがあった。もしプレイヤーがこのバイト機構を抜け出すと大変なことになる。」と警告。
↓
バターからのバイト依頼があり、ゴーグルをつけバターステージに移動。（脱出スタートシーンと定義）
↓
バターステージで、武器を使うと、キッチン風ステージが張りぼてのように武器コントローラーに吸い込まれ、脱出用ステージが現れる。