はじめに

Vive Trackerを一定数以上繋いだ状態でUE4を起動するとクラッシュする、という不具合が報告されています… そこそこ本気でVTuberする上でこれは辛いので、修正方法を共有します…修正箇所は凄く少ないので対応コストは少ないです。
正式に入るのはUE4.21を予定しています。

関連issue
https://issues.unrealengine.com/issue/UE-54387
https://issues.unrealengine.com/issue/UE-63579 (申請が通れば公開されます)

修正内容

"\Engine\Plugins\Runtime\Steam\SteamVR\Source\SteamVRController\Private\SteamVRController.cpp"

30行目付近の MAX_TRACKED_DEVICES をコメントアウト

//#define MAX_TRACKED_DEVICES (int32)EControllerHand::Special_9 - (int32)EControllerHand::Left + 1

115行目付近のMaxControllers に入れる値を変更

/** Total number of motion controllers we'll support *///static const int32 MaxControllers = MaxUnrealControllers * CONTROLLERS_PER_PLAYER;// NOTE: This used to be MaxUnrealControllers * CONTROLLERS_PER_PLAYER, but we needed to support many more trackers than thatstaticconst int32 MaxControllers = vr::k_unMaxTrackedDeviceCount;

はじめに

突然ですが、UE4でVTuberムーブをキメることになったので、早速Ikinema Orionで遊び始めました！凄く楽しいです！！！

UE4 + Ikinema Orion、完全に理解した！(棒) #UE4pic.twitter.com/uE08w60P9f

— おかず (@pafuhana1213) September 3, 2018

せっかくなので、メモ代わりに記事書いていきます。
今回はIkinema Orionの紹介と、Orionを使う上で必要なVive Trackerの購入、固定方法について説明します。

Ikinema Orionについて

簡単言うと、HTC ViveとVIVE Trackerを使って全身モーションキャプチャできるソフトです。下の動画みたいなことが簡単にできてしまいます！しかも、年間ライセンス62,400円（税別）！超安い！…い、いや…安いんですって！
www.youtube.com

Ikinema Orionの詳細や契約周りはMogura VRさんのページをご確認ください。14日間の無料体験版があるので導入前のテストができて安心です（僕のときはメールを送ってすぐ返信がきました！素晴らしい！）
www.moguravr.com

注意点としては、
HTC Vive：1セット、Vive Tracker：3台以上
が必要になります。（両足、腰 に Vive Trackerを必ず使うため）

引用：IKINEMA | Motion Capture, VR, Games - Documentation

Vive Tracker購入編

Vive Trackerはご家庭に必ず8台あるものだと思いますが、念の為。

Vive Trackerは2018年9月現在2017版と2018版の2つがありますが、 互換性があるので2018年版を購入して問題ありません。購入するショップに関しては、公式サイトで丁寧にまとめられているので参考になります。
VIVE 正規取扱販売店 一覧

Vive Tracker 固定編

OrionでVive Trackerを使うためには、手・腰・足・肘などに固定する必要があります。
まずは今回セットアップする上で参考にした記事を紹介。
sumoch1.hatenablog.com

足に関しては、上記の記事で紹介されている「クロックス + ネジ」スタイルにしました。

UTEBIT 1/4インチ ネジ ホットシュー アダプタ 「4点セット」 強化アルミ製 フラッシュ 一眼レフ カメラ シュー マウント アダプター 三脚 ねじ 撮影用 for Canon Nikon

• 出版社/メーカー: UTEBIT
• メディア:エレクトロニクス
• この商品を含むブログを見る

手（肘）と腰に関しては、Genz( @Genz_3D )さんオススメのセットで組みました！

おおお、なんかすごそう…！！！ 調べてみます！！！

— おかず (@pafuhana1213) September 1, 2018

ザムスト！はじめて知りました！楽しそう…ポチってみます！ https://t.co/WkfzP9oxI9

— おかず (@pafuhana1213) September 1, 2018

なお、Track Strap は 以下から購入可能です。ガッツリ固定されて超いい感じです！
Track Strap 《送料無料》 - 自作PC・PCパーツが豊富！PC専門店【TSUKUMO】

腰固定用のザムストはZW-3 ソフトサポートを選択。穴を開けて足で使ったネジを使って固定しました。ちょっと固定が甘くてブルブル震えてる感があるので、ZW-5以降の硬めのものにした方がいいかもしれません…

ZAMST(ザムスト) ZW-3 腰サポーター 373304 ブラック LLサイズ

• 出版社/メーカー:ザムスト(ZAMST)
• メディア:スポーツ用品
• この商品を含むブログを見る

ひとまずこれでVive Trackerを固定できるようになりました！しばらくはこの構成でいこうと思います！

さいごに

次はUE4とOrionの連携について書こうと思います。
といっても、ビックリする程簡単です！お楽しみに！

はじめに

Windows上からMacをリモートで使ってiOSパッケージを作成するリモートビルドという機能がUE4にはあります。
そのリモートビルドが急に上手くいかなくなった時とかに試す証明書・プロビジョニングファイルの削除を
何度も何度も忘れるのでメモ。なお、自己責任でお願いします

Windows上での証明書・プロビジョニングファイルの作成手順
Unreal Engine | iOS クイックスタート

リモートビルドについて
Unreal Engine | Windows で iOS をビルドする

プロビジョニングファイルの削除

"C:\Users\\AppData\Local\Apple Computer\MobileDevice\Provisioning Profiles"
のファイルを全削除

証明書の削除

Win+Rを押した後に、certmgr.mscと入力・実行

Certificates->Personal->Certificates にある iPhone Developer :～ を全削除

以上

参考

Delete all certificates on PC - iOS Packaging - UE4 AnswerHub

はじめに

2018/10/14のアンリアルフェスにて、UE4でVTuberをする方法について講演しました。

その中で「Oculus LipSyncはいいぞ！」ムーブをキメました（p94以降）が…具体的にどのように導入・使用するのかについて触れなかったので記事にまとめようと思います。

Oculus LipSyncについて

Oculus LipSync ( 以下、OVRLipSync ) はOculus社が提供しているリップシンク（口パク）ライブラリで、2018/10/5にリリースされた v1.30.0 でUE4に対応しました。そして、2018/11現在（v.1.30.0）ではUE4.20に対応しており、サンプルプロジェクトも用意されています（v.1.30.0、UE4.21でも一応動きました）。

このライブラリを使うことで、マイク音声または事前に収録した音声データ( SoundWavアセット )からリップシンク情報を取得することができます。つまり、セリフに合わせたキャラクタの口パクアニメーションを簡単に作ることができます！
( 表情用のMorph TargetをキャラのSkeletalMeshに用意する必要はありますが… )

サンプルでは、OVRLipSyncが検出した口形素( Viseme )をSkeletal MeshのMorph Targetに渡すBPが用意されています。Visemeは音声から唇の形状を分類したもので、全部で15パターン用意されています。( ただ一般的によく用いられるのは母音(a, i , u, e, o)なので、全てのパターンを使い分ける必要はないかと思います。)

Visemeに関するドキュメント：Viseme Reference

以降は、サンプルに含まれるBPについて簡単にですが解説します。

サンプルのセットアップ・動作確認

まずはサンプルを動かしてみましょう。上述のダウンロードページからサンプルプロジェクトをダウンロードできます。

ダウンロード後、"LipSync\UnrealPlugin\OVRLipSyncDemo"にOVRLipSyncDemo.uproject を実行してみましょう！…以下のようなウィンドウが出てきます(；´∀｀)

残念ながら、OVRLipSync (v1.30.0)を使うためにプラグインをビルドする必要があります。「はい」を選択しビルドを走らせましょう。また、もしVisual Studioが入っていない場合はビルドに必要なのでインストールしましょう。

ビルドが完了すると自動的にサンプルプロジェクトが立ち上がります。やったね！

サンプルには以下の２つのレベルが用意されています。初回起動時に開かれるのはLiveCaptureレベルです。

• “Content/Maps/LiveCapture”：マイク音声を使用するサンプル
• “Content/Maps/CannedPlayback”　音声データを使用するサンプル

具体的な解説に行く前にサンプルが正常に動作するか確認しましょう！Playボタンを実行して、マイクに向かって喋ってみましょう。声に合わせてモデルが口パクしたら正常に動作しています。

もし正常に動作していない場合はOutput Logを確認してみましょう。以下の文字列が出力されていた場合、PCにマイクがデバイスとして認識されていません。「windowsマイク デバイス設定」などで検索して設定して下さい。

LogVoiceCapture: Warning: Failed to create capture device 0x88780078
LogTemp: Error: Can't create voice capture

もし音声データ（SoundWav）を持ってる方は CannedPlaybackレベルも試してみましょう。持ってないけど試したい方はサンプルボイスがプロジェクトにあります
“Content/Audio/vox_lp_01”

まずはSoundWavアセットを右クリックし、Generate LipSyncSequenceを実行すると、同じフォルダに OVRLipSync用のアセットが生成されます。

そして、このアセットをCannedPlaybackレベルに配置されているPlaybackBlueprint の OVRLipSyncPlaybackコンポーネントの Sequenceプロパティに設定すればOKです。

この状態でPlayを押すと、指定した音声が再生されつつ口パクしてくれます。

サンプルが正常に動作したという前提で、各レベルで使われているBPについて解説します。といっても、結構シンプルな作りになってるのでご安心ください！

LiveCaptureBlueprint について

LiveCaptureレベルの場合は”Content/Blueprints/LiveCaptureBlueprint”が 口パクの検出・適用処理をしています。

PlaybackBlueprint について

CannedPlaybackレベルの場合は、”Content/Blueprints/PlaybackBlueprint” が口パクの検出・適用処理をしています。更にシンプルな作りです。

まずボイスチャットの機能を使わないので、コンソールコマンドを使っていません。加えて、AssignVisemesToMorphTargetsノードというものだけが使われてます。…実はこの関数の中身は LiveCaptureBlueprintにおける各visemeの設定処理と全く同じです（つまり、笑い声の判定処理はありません）。

void UOVRLipSyncActorComponentBase::AssignVisemesToMorphTargets(USkeletalMeshComponent *Mesh, const TArray<FString> &MorphTargetNames)
{
	for (int cnt = 0; cnt < MorphTargetNames.Num(); cnt++)
	{
		Mesh->SetMorphTarget(FName(*MorphTargetNames[cnt]), Visemes[cnt]);
	}
}

じゃあ、AssignVisemesToMorphTargetsノードだけでいいじゃん！と思うかもしれませんが…残念ながらそうはいきません。

サンプルの問題点

これはサンプルで使用しているメッシュのMorphTargetです。見ての通り、名前と順番がOVRLipSyncが持つVisemesと全く同じです。この状態にしないと、AssignVisemesToMorphTargetsノードは正常に動作しません
更に言うなら、LiveCaptureBlueprintにおける実装も動作しません！！！

つまり、サンプルにあるBPの実装をそのまま別モデルに流用することはできないということです。と言っても、対応は簡単です！

長くなりましたので、一旦ここまで。
次回の記事では自分のプロジェクトでOVRLipSyncを導入する手順やサンプル以外のモデルに適用する際の手順について解説します

つづく

はじめに

この記事はこちらの記事の続きです
pafuhana1213.hatenablog.com

前回はOVRLipSyncのサンプルについて解説しました。しかし、サンプルに含まれるモデルはOVRLipSyncの仕様に超特化したものなので、そのまま他モデルに適用することはできません。
そこで、他モデルでOVRLipSyncを使うにはどうすればいいのかについて解説します。なお、今回の解説では皆大好きなGrayちゃんのモデル・ボイスをお借りしています。
3Dモデル：Grayちゃんモデルデータ – rarilog
ボイス：Grayちゃんボイスが、より扱いやすくなりました - Grayちゃん OFFICIAL WEBSITE

pic.twitter.com/6ogXKXbsnw

— おかず (@pafuhana1213) November 25, 2018

OVRLipSyncプラグインの導入

まずは公式サンプルプロジェクト( OVRLipSyncDemo )に含まれるOVRLipSyncプラグインを別プロジェクトで移植します。今回はGrayちゃんの3Dモデルに含まれるGrayChanProjectに移植します。

[Voice]
bEnabled=True

[OnlineSubsystem]
bHasVoiceEnabled=False

Grayちゃんボイスで口パクしてみる

今回はマイク音声ではなく、事前に収録された音声であるGrayちゃんボイスを使ってみます。マイクを使用する場合でもBPによる実装内容は殆ど変わりないからです。準備周りはサンプルからコピペしましょう！

最後に

これでサンプル以外のモデルでもOVRLipSyncを用いた口パクができるようになりました。しかし、改良の余地はまだまだまだまだあります。例えば、口をもっと大きく開くように補正処理をかけたり…

口パクパラメータ補正版 pic.twitter.com/epw1rZpyVo

— おかず (@pafuhana1213) November 25, 2018

アニメ的な表現を再現するために更新間隔を調整したりなどなど…色々あります！（ググると色々…ﾓﾆｮﾓﾆｮ…）
是非色々カスタムしてみてください！

補足

シーケンスレコーダーによるベイク処理を使って、OVRLipSyncによる口パクをアニメーションアセット化したい方がそれなりにいるかと思います。

しかし、Set Morph Targetでモーフターゲットを制御する場合はベイク処理の対象外になります。そのため、ベイク処理の対象にするためには、Animation BPのAnim Graphにて Modify Curveノードを使って各モーフターゲットの値を制御する必要があります。ご注意下さいまし。

おわり

はじめに

この記事はUnreal Engine 4 Advent Calender 2018の13日目の記事です。
qiita.com

おかげさまでUE4モバイル案件が増えてきたということもあり、ネット上にあまり情報がないiOS開発時の実機デバッグ・プロファイリング方法についてまとめてみました。
…社内外含めて情報全然ない！がんばた！

各記事のご案内

…予想以上に内容が膨らんだので記事を分割しました。

• ログの確認
  • 実行中のログ確認
  • 実行後のログ確認

pafuhana1213.hatenablog.com

• CPUデバッグ ( ゲームコード, エンジンコード )
  • Xcode上でBreakPointを貼ってデバッグ
• GPUデバッグ
  • XcodeのGPU Frame Capture機能を使って、各GPU処理の詳細・負荷を確認

pafuhana1213.hatenablog.com

• CPU, GPUプロファイリング
  • Instrumentsを使って、CPU・GPU処理の負荷を確認

pafuhana1213.hatenablog.com

注意

なお、全て実機上でのデバッグ・プロファイリングについてです。UE4エディタ上で行う際はモバイルプレビュア機能をご活用ください。ただしあくまで疑似再現なので、ちゃんとデバッグ・プロファイリングするときは実機でしましょう！
api.unrealengine.com

また、stat関連とログ取得以外に関しては必ずMacが必要になります。

mac miniポチった pic.twitter.com/EUe5yyV3FO

— おかず (@pafuhana1213) October 31, 2018

Macと仲良くできるかはまた別問題だけどな！

検証環境

• UE4：4.21.1
• iOS：12.1
• MacOS：Mojave (10.14.1)

開発環境構築について

皆さん大好きな証明書、プロビジョニングファイル、リモートビルドを含む開発環境の構築に関しては、わんちゃん( @WanchanJP )さんの神記事に全てが載っているのでご確認くださいまし…（本当に…本当にありがとうございます！）
soramame-games.com

最後に (各記事をご確認頂いた後にどうぞ)

手探り感が凄いですが、UE4でiOS開発をする際のデバッグ・プロファイリング方法について簡単にまとめてみました。
ただ、Macを使った開発をまだ勉強中ということもあり、「もっといい方法があるよ！」と思う方がいるかもしれません…

そういう方は…ぜひ教えてください！
なんでもしますから！

はい

以上です。あとは各記事をご確認ください。
明日は @dgtanakaさんの「なんか書きます」です！
いつも非常に有益な記事を公開して頂いているので今回も楽しみです！

はじめに

ゲーム中にPrintStringなどで出力したデバッグ情報の確認やクラッシュ時の原因調査など、ログファイルはすごく便利で得られるものも多いです！
ということで、まずはログの確認、ファイル取得から。

実行中のログ確認(Mac)

Macの場合は、UE4エディタのSessionFrontend 又は XcodeのConsole機能を使うことになります。Session Frontendに関してはWindowsでも同じ手順なので後述します。ここでは後者の方法について紹介します。

Xcodeからアプリを実機上で実行する方法

実行中のログ確認 (Win)

Windowsの場合は、少し前に触れたSession Frontendを使用することになります。
api.unrealengine.com

ちなみにAndroid実機とSession Frontendの接続に関しては、以下のスライドで紹介しました（p38以降）。

iOSの場合もほぼ同じなのですが…「Project SettingsにあるUDP MessagingのStatic Endpointsに [iOS端末のIPアドレス:6666] を追加する」作業が必要になる点が唯一異なります。

この設定を入れておかないと、ケーブルで直繋ぎしてもSession Frontendに認識されません。ちなみに、認識されると以下のように端末が表示されます。

Session Frontendと接続ができれば、実行中のログ確認だけでなく、コンソールコマンドの送信やCPUプロファイラなどの様々な機能が利用可能になります！ぜひ活用していきましょう！

実行後のログ確認(Mac)

次は、アプリ実行後に端末に保存されたログを取得する方法について紹介します。Macの場合は、以下の記事で書かれている方法を使うことになります。
qiita.com

.xcappdataのダウンロード後、右クリックメニューの「パッケージの内容を表示」を選択することで、実行中に出力されたログ、プロファイル系のファイルなどを確認することが可能です。ちなみに、ログファイルは、”AppData\Documents\[Project Name]\Saved\Logs”にあります。

実行後のログ確認(Win)

Windowsの場合は、”Engine\Binaries\DotNET\IOS” にある IPhonePackager.exeを使って、端末から各ファイルを抽出します。手順は以下の通り。

1 .IPhonePackager実行
2. ログを抽出したいアプリの uproject ファイルを指定
3. Advanced Tools の Other Development Tools を選択

4. 端末を選択し、Backup documentsを選択

5. アプリのインストール時に使用した .ipaファイルを選択

端末からの抽出処理が完了すると、“[Project Root]\IOS_backups” 以下に各ファイルが配置されます。ログファイルの場合は、”[Project Root]\[Device Name]\Documents\iOSTest\Saved\Logs” にあります。

（やることが…やることが多い…！！）

最後に

ここまでがログの確認・取得方法についてでした！地味な部分ではありますが、得られる情報は非常に多いです。ただ開発環境によってフローが異なるのでご注意下さい！
次の記事では、デバッグでお馴染みのBreakPointをどうやって使うのかについて。
pafuhana1213.hatenablog.com

はじめに

ゲームの動作や不具合を調査・デバッグする上でBreakPointは必要不可欠です。ということで、UE4&iOS開発時にどのようにしてBreakPointを使うのかについて紹介します。なお、Xcodeを使用する関係でMacが必須なのでご注意ください ( MacMiniはいいぞ )。

Mac上で開発する場合

リモートビルドは使わずにMac上で開発を進めている場合は、ゲームコード・エンジンコード共に簡単にデバッグ可能です。ただ、Xcodeと実機上で動作するアプリを接続する必要はあります。

接続する方法は2通りあります。まず１つ目は、前回の記事で紹介した「Xcodeからアプリを起動する方法」です。この方法ならXcodeとアプリが接続した状態で起動するため、BreakPointがすぐ使えます。
なお、エンジンコードにBreakPointを貼りたい場合は、ランチャー版ではなくビルド版を使用する必要があります。ご注意くださいまし。

もう一つ目の方法は、「既に起動しているアプリのプロセスにアタッチする方法」です。XcodeのDebug->Attach to Process からアタッチするとBreakPointが有効になります。ただし、前回の記事で軽く触れたとおり、この方法の場合はXcodeのConsole Areaにログが出力されない点にご注意ください。

リモートビルドを使う場合

Windowsからのリモートビルドの場合でも、Mac上でゲームコードのデバッグは可能です。

リモートビルド中、UE4プロジェクトとエンジンの各ファイル（全ファイルではない）がMacの以下の場所に転送されます。
“Macintosh HD\ユーザ\[User Name]\UE4\Builds\[Windows PC Name]”

例えば Windowsの“D\UnrealProjects\SampleProject”にあるプロジェクトでリモートビルドした場合、Macの
“Macintosh HD\ユーザ\[User Name]\UE4\Builds\[Windows PC Name]\D\UnrealProjects\SampleProject” にプロジェクトの各ファイルが配置されます。

そして、その階層にある “Indermediate\ProfjectFilesIOS” 以下に Xcodeのプロジェクトファイル( .xcodeproj )が配置されています。このプロジェクトファイルを使うことで、上述の「既に起動しているアプリのプロセスにアタッチする方法」が可能です。

しかし、リモートビルドの場合は「Xcodeからアプリを起動する方法」とエンジンコードのデバッグは（おそらく）現状できません…。今後にご期待ください…。

個人的参考まとめ(CPUデバッグ)

qiita.com
tech.drecom.co.jp
blogios.stack3.net
ikesyo.hatenablog.com

GPUデバッグ

いわゆるGPUフレームキャプチャ機能について。
描画に関する負荷・不具合をより細かく調査する必要が出てくる場合があります。例えば「どのような処理が」「どのような順番で」「どのようなアセットを使って」「どのぐらいの処理負荷で」…などといった感じです。
コンソール専用ツールを除けば、UE4開発者内ではRenderDocが有名所かなと思います。
qiita.com

そして、そのGPUフレームキャプチャ機能がXcodeに用意されています。こんな感じ。

GPUフレームキャプチャ機能の使い方

といっても簡単です！

「Xcodeからアプリを起動する方法」の実行すると、XcodeのDebugメニューからGPUフレームキャプチャに関する項目（Capture GPU Frameなど）が使用可能になります。そして、それを選択するだけでGPUフレームキャプチャを実行することができます。超簡単！

…言い換えると、「既に起動しているアプリのプロセスにアタッチする方法」の場合はGPUフレームキャプチャは使えません。さらに言うと、リモートビルドの場合はGPUフレームキャプチャは完全使用不可です。

…Mac Miniはいいぞ！

XcodeのGPUフレームキャプチャ機能は結構いい感じな印象です。例えば、負荷が目立つ処理にはひと目で分かるようにビックリマークがついていたり…

GPUフレームキャプチャに期待する情報をちゃんと出してくれますし…

この辺りはやはりMetalの恩恵が大きいのかなという所です。

個人的参考まとめ(GPUデバッグ)

qiita.com
booth.pm

最後に

ここまでがCPU,GPUデバッグに関してでした。これらの情報を知ってるか知らないかで制作効率が大きく変わってくると思います。ぜひ一度実際に手を動かして試してみましょう！
あと、Xcodeはまだまだ勉強中なので今後もっと情報を出していければと思います…！

次は、みんな大好きプロファイリングについて。プロファイリングツールであるInstrumentsに触れてます。
pafuhana1213.hatenablog.com

はじめに

みんな大好きプロファイリングについての話です。
iOS開発では、Instrumentsというプロファイリング用のツールが用意されています。ここではをUE4で開発をする際にどのようにしてInstrumentsを使うかについて説明します。

…実機上で各statコマンドを活用することもお忘れなく。

Instruments起動前の前準備

Instrumentsの起動

まずはXcodeのメニューからInstrumentsを起動します。なお、起動後にInstrumentsをDockに登録しておくと次回以降の起動がXcodeなしで出来るので楽になります。

Instumentsを起動すると、以下のようなウィンドウが開きます。Instrumentsではプロファイリングする項目を選択できるようになっています。ただその項目の量が結構多いため、それらの項目が用途別にまとめられたテンプレートを選択する形になっています。

developer.apple.com

そして、UE4を使った開発の場合、主に使うテンプレートは以下の3つかと思います。ただ他にも色々項目があるので、軽く見ておくのも良いかと思います。（ただし、iOSでは非サポートの項目もあるのでご注意を）

• Time Profiler
  • Game threadのプロファイル
  • オーバヘッド：小
• Metal System Trace
  • Game, Draw, GPU threadのプロファイル
  • オーバヘッド：中
• Game Performance
  • Game, Draw, GPU thread + Memory管理 のプロファイル
  • オーバヘッド：大

また、表示されたウィンドウの上部にはプロファイリングを行う端末・プロセス名が表示されます。もし意図する対象とは異なる場合はクリックして変更しましょう。

Instrumentsの実行…前の準備

Instrumentsの実行

ようやく準備が整いました。これでInstruments左上の録画ボタンを押すことでプロファイリングが開始し、もう一度押すと終了します。ちなみに、下の画像はGame Performanceテンプレートを使用した際のプロファイリング結果です。

それぞれの項目について細かく解説するといつまで経っても終わらないので、ざっくり説明します。

Time Profiler

今回紹介したテンプレートは全てTime Profilerテンプレートを内包します。で、Time Profilerの結果が見れるのがこの CPU Usageです。指定した範囲における各処理の負荷・呼び出し回数などを確認可能です。GameThreadがボトルネックになっている場合、この情報が役に立つ可能性が高いです。
developer.apple.com

ただ少し注意しないといけないことが幾つかあります。
まずは、UE4以外の処理も抽出されてしまう点です。フィルタを適用しない場合、以下のようによく分からない処理が大量に並びます。

これでは調査に支障が出てしまうため、Instrumentの左下にあるInput Filter機能を活用します。ここにある [ IOSAPPDelegate MainAppThread ]を選択することで、UE4関連の処理だけを表示するようになります。

次に、同じくInstrument左下にあるCall Treeにおける”Hide System Libraries”は必ず有効にしましょう。

有効にしない場合、以下の画像のように項目名が解読不能になってしまいます。

Call Treeには他にも調査する上で便利な項目があるので、一度試してみましょう！

Displayed Surfaces

Metal System Trace, またはGame Performanceテンプレートに含まれます。この項目ではVsyncのタイミングを確認する事が可能です。それだけの項目なので、他の項目と併用することになります。例えば、Time Profilerでだいたい1フレームにおける負荷を見たい場合は、このVsyncタイミング情報は非常に有用です。
developer.apple.com

Graphics Driver Activity

Metal System Trace, またはGame Performanceテンプレートに含まれます。この項目では、描画に関するCPU側のイベントを確認できます。ただGPUフレームキャプチャのように詳細は見れません。どの処理がどの程度負荷があったのかを確認する程度です。
developer.apple.com

GPU Hardware

Metal System Trace, またはGame Performanceテンプレートに含まれます。この項目では、描画に関するGPU側のイベントを確認できます。具体的には、頂点・フラグメントシェーダにおける負荷を確認可能です。ただし、先程と同様に詳細（使用されたテクスチャ、どのようなメッシュが描画されたかなど）は全く見れません。
developer.apple.com

最後に

ここまでがCPU, GPUプロファイリングについてでした。CPUプロファイリングに関してはUE4エディタのCPUプロファイラでもある程度代用可能ですが、オーバヘッドのことを考えるとInstrumentsを使用した方がより高精度なチェックが出来るかと思います。

またGPUプロファイリングに関しては、説明にあったとおりGPUフレームキャプチャのように各処理の詳細は見れません。しかし、どの項目がボトルネックになっているのかを調査するのには非常に適しているかと思います。Instrumentsでボトルネックを確認してから、GPUフレームキャプチャで詳細確認する流れが良いかと思います。

まとめページに戻る
pafuhana1213.hatenablog.com

はじめに

この記事はUnreal Engine 4 その2 Advent Calendar 2018の20日目の記事です。
qiita.com

何を書こうか色々悩んだのですが、今年も物理と仲良くする（意味深）方法について書こうと思います。なお、去年の記事は以下の通り。(え、もうアレから一年経ったの！？)

「UE4.18で生まれ変わった物理アセットエディタ(Physics Asset Editor)について」 と 「物理と少し仲良くなる方法について」
その1：http://pafuhana1213.hatenablog.com/entry/2017/12/13/000000
その2：http://pafuhana1213.hatenablog.com/entry/2017/12/13/000100
その3：http://pafuhana1213.hatenablog.com/entry/2017/12/13/003018

実験に付き合ってもらうのはいつものこの方々。左のOwenくんはクロス担当、右のグレイマンは物理アセット担当です。

なお、今回は物理アセット・クロスの設定を極力変えずに既存の機能で何とかすることを目標とします。何故なら去年の内容と被りますし、作業コスト高いですし、職人芸になりがちですし、、説明が大変だからです！（ﾄﾞﾝ！

物理の荒ぶりに対して、我々はどう立ち向かえばいいのか？

基本方針は以下の3つです！

• 荒ぶりの原因になる挙動を無視させる
• 物理をリセットして荒ぶりを消す
• 荒ぶり前に物理を停止し、その後再開する

これらの対応を入れることで、（色々と許容しないといけない場合あったりしますが）、だいたいの物理の荒ぶりを回避できます。

具体的にどうすればいいのか、これから順に説明します。

荒ぶりの原因になる挙動を無視する方法

物理をリセットして荒ぶりを消す方法

「荒ぶりがユーザに見えないように、物理適用前の状態にリセットしちゃおう！」という方法です。基本的にリセット用の処理を呼び出すだけなので、対応自体は簡単です。しかし、先程のReset After Teleportで説明した通り、場合によっては見た目に違和感が発生する場合があります。とはいえ、物理が荒ぶった際の見た目よりは断然マシなので導入の検討はすべきかと思います。

荒ぶり前に物理を停止し、その後再開する方法

「物理の荒ぶりは回避したいけど、リセットするのは見た目的にいや！ 物理処理は継続的に行いたい！」と思う方は多いかと思います。そんな方向けの方法がこの「物理を停止・再開」する方法です。

結局の所、荒ぶりが起きやすい状態で物理が有効になっているのが今回の問題の原因です。つまり、その状態の間だけ物理を切れば荒ぶりが発生することはなくなります。しかし、単純に物理を切ってしまうとリセット処理が走ってしまいます。それなら、物理を切るだけでなく、対象のメッシュ・アニメーションも一時停止しておいて、その後どちらも再開すれば荒ぶり回避できるし物理処理が継続して見えるじゃん！というのがこの方法です。

その他

最後に、今回の内容と関連するパラメータやTipsについて少し紹介

最後に

長くなりましたが、物理・クロスの荒ぶり対策について色々ご紹介しました。これらの方法を使用・併用することで、様々なパターンにおける荒ぶりを回避することができるかと…思い…ます…

ただ、繰り返しになりますが、あくまで物理なので今回紹介した方法でも抑え込めないケースもあるかと思います。その場合は、まず何が荒ぶりの原因になっているかを確認した後に、物理アセット・クロスの調整をしてみたり、そもそも荒ぶりやすい条件にならないよう仕様・設計を変えるなど検討したり、物理挙動をベイクしたりなどの方法を検討する必要があるかと思います。場合によっては、ある程度の割り切りも必要かもしれません…

ネガティブなことばかり並べましたが、物理・クロスを適用することで見栄えがリッチになるのは間違いありません。昨年と今年の記事が少しでも物理と仲良くする助けになれば幸いです。

明日は 紙パレット ( @kamipallet )さんによる 「ジラフとアンニカ」のジャンプアニメーションの解説 です！ジャンプアニメーション、いつも調整に苦労してるので凄く楽しみです！！！

本題

記事タイトルの通りですが、UE4.21にてGradleを有効にした状態でAndroidパッケージを作成すると、以下のメッセージがログに出力されてパッケージ作成に失敗する場合があります。

 Creating rungradle.bat to work around commandline length limit (using unused drive letter Z:)
 Making .apk with Gradle...
 To honour the JVM settings forthis build a new JVM will be forked. Please consider using the daemon: https://docs.gradle.org/4.1/userguide/gradle_daemon.html.
 Daemon will be stopped at the end of the build stopping after processing
 WARNING: The specified Android SDK Build Tools version (26.0.1) is ignored, as it is below the minimum supported version (26.0.2) for Android Gradle Plugin 3.0.1.
 Android SDK Build Tools 26.0.2 will be used.
 To suppress this warning, remove "buildToolsVersion '26.0.1'" from your build.gradle file, as each version of the Android Gradle Plugin now has a default version of the build tools.
 File C:\Users\awfor\.android\repositories.cfg could not be loaded.
 Checking the license for package Android SDK Build-Tools 26.0.2 in C:\NVPACK\android-sdk-windows\licenses
 Warning: License for package Android SDK Build-Tools 26.0.2not accepted.
 
 FAILURE: Build failed with an exception.

原因は最近Googleがライセンス契約を変更したのですが、UE4.21時点ではその変更に対応できていないからです。 (ライセンス更新は2019/1/16 頃、たぶん)

この問題を解決するには、UE4.22から入る新しいライセンス契約への対応をUE4.21に移植する必要があります。といっても対応は簡単で、UE4.22以降が持つ Engine/Source/ThirdParty/Android/package.xmlを UE4.21のpackage.xmlに上書きした後に、再度Project設定のAndroidカテゴリにある "Accept SDK License"ボタンを押すだけです。

なお、この記事を書いた2019/2/6時点では以下のurlからUE4.22版のpackage.xmlをDL可能です。
https://github.com/EpicGames/UnrealEngine/blob/4.22/Engine/Source/ThirdParty/Android/package.xml

おまけ 1

UE4.21からAndroidのNDKのバージョンが 12b から 14b に上がっています。そのため、UE4.20以前にAndroid開発をしていた場合は、\Engine\Extras\AndroidWorks\Win64\CodeWorksforAndroid-1R7u1-windows.exe を使って開発環境をアップデートする必要があります。アップデート後は、UE4エディタのプロジェクト設定におけるAndroidSDKカテゴリにある各項目を新しいバージョンのものに合わせることをお忘れなく。あと、インストールする前に以前のバージョンをアンインストールした方が安全かと思います。

Android：
Android NDK r14b (新しい CodeWorks for Android 1r7u1 インストーラは、Windowsおよび Mac上の、以前の CodeWorks を置き換えます。Linuxは 1r6u1 と修正版を使用します)
https://www.unrealengine.com/ja/blog/unreal-engine-4-21-released?sessionInvalidated=true

おまけ 2

上述の対応後にAndroidパッケージの作成を行うと、以下のエラーが発生する場合があります。

LogPlayLevel: Error: C:\Users\●●●\.gradle\caches\transforms-1\files-1.1\support-compat-27.1.0.aar\36ca67ef4f432d33200b3e8a5af4a755\res\values\values.xml:20:5-70: AAPT: error: resource android:attr/fontStyle not found.
 LogPlayLevel: Error: C:\Users\●●●\.gradle\caches\transforms-1\files-1.1\support-compat-27.1.0.aar\36ca67ef4f432d33200b3e8a5af4a755\res\values\values.xml:20:5-70: AAPT: error: resource android:attr/font not found.
 LogPlayLevel: Error: C:\Users\●●●\.gradle\caches\transforms-1\files-1.1\support-compat-27.1.0.aar\36ca67ef4f432d33200b3e8a5af4a755\res\values\values.xml:20:5-70: AAPT: error: resource android:attr/fontWeight not found.
 LogPlayLevel: Error: Z:\app\build\intermediates\incremental\mergeDebugResources\merged.dir\values\values.xml:95: error: resource android:attr/fontStyle not found.
 LogPlayLevel: Error: Z:\app\build\intermediates\incremental\mergeDebugResources\merged.dir\values\values.xml:95: error: resource android:attr/font not found.
 LogPlayLevel: Error: Z:\app\build\intermediates\incremental\mergeDebugResources\merged.dir\values\values.xml:95: error: resource android:attr/fontWeight not found.
 LogPlayLevel: Error: error: failed linking references.
 LogPlayLevel: Failed to execute aapt

発生した場合は、AndroidSDKAPI Levelをandroid-21に戻してみてください。これで解決することが多いです。

おまけ 3

プロジェクト設定のAndroidカテゴリにある "Enable Gradle Instead of Ant"を無効にすれば、gradleではなく昔のantを使ってパッケージを作成するようになるため、gradle絡みの問題を回避することが可能です。しかし、antは古いシステムなので推奨されていない上に今後削除される予定なのでご注意ください。

また、ARCoreを使う場合は必ずgradleを使用する必要があります。 antを使ってパッケージを作った場合、起動後に即クラッシュします。クラッシュした際のlogcatは以下の通り。

02-0523:37:22.006: E/AndroidRuntime(17685): java.lang.UnsatisfiedLinkError: dlopen failed: library "libarcore_sdk_c.so"not found
02-0523:37:22.006: E/AndroidRuntime(17685): 	at java.lang.Runtime.loadLibrary0(Runtime.java:977)
02-0523:37:22.006: E/AndroidRuntime(17685): 	at java.lang.System.loadLibrary(System.java:1530)
02-0523:37:22.006: E/AndroidRuntime(17685): 	at com.epicgames.ue4.GameActivity.<clinit>(GameActivity.java:5504)
02-0523:37:22.006: E/AndroidRuntime(17685): 	at java.lang.Class.newInstance(Native Method)
02-0523:37:22.006: E/AndroidRuntime(17685): 	at android.app.Instrumentation.newActivity(Instrumentation.java:1079)
02-0523:37:22.006: E/AndroidRuntime(17685): 	at android.app.ActivityThread.performLaunchActivity(ActivityThread.java:2538)
02-0523:37:22.006: E/AndroidRuntime(17685): 	at android.app.ActivityThread.handleLaunchActivity(ActivityThread.java:2707)
02-0523:37:22.006: E/AndroidRuntime(17685): 	at android.app.ActivityThread.-wrap12(ActivityThread.java)
02-0523:37:22.006: E/AndroidRuntime(17685): 	at android.app.ActivityThread$H.handleMessage(ActivityThread.java:1460)
02-0523:37:22.006: E/AndroidRuntime(17685): 	at android.os.Handler.dispatchMessage(Handler.java:102)
02-0523:37:22.006: E/AndroidRuntime(17685): 	at android.os.Looper.loop(Looper.java:159)
02-0523:37:22.006: E/AndroidRuntime(17685): 	at android.app.ActivityThread.main(ActivityThread.java:6097)
02-0523:37:22.006: E/AndroidRuntime(17685): 	at java.lang.reflect.Method.invoke(Native Method)
02-0523:37:22.006: E/AndroidRuntime(17685): 	at com.android.internal.os.ZygoteInit$MethodAndArgsCaller.run(ZygoteInit.java:865)
02-0523:37:22.006: E/AndroidRuntime(17685): 	at com.android.internal.os.ZygoteInit.main(ZygoteInit.java:755)
02-0523:37:22.008: W/ActivityManager(2739):   Force finishing activity com.YourCompany.ARTemplateBuild/com.epicgames.ue4.GameActivity

どうやらgradleが持っている libarcore_sdk_c.so が必要なので、antだとクラッシュするようです。こちらもご注意くださいまし。

おわり

はじめに

突然ですが、Android開発時のデバッグ・プロファイリング方法についてまとめようと思います。検証したUE4のバージョンは4.21.2です。

今回は実機実行中 のログ確認方法についてです。
UE4エディタ上で確認する方法と、Android Debug Monitorというツールを使う方法の2つを紹介します。

ちなみに、iOS開発版はこちらです。
pafuhana1213.hatenablog.com

Session Frontendを使ってログを確認する方法

UE4エディタ上でAndroid実機上のログを確認するためには、UE4のSession FrontendがそのAndroidを認識するようにする必要があります。認識されたAndroid端末は以下の画像のように「自分のセッション」に表示されます。そして、その項目をクリックするとログを確認できるようになります！　　

これから認識する方法について紹介するのですが、以降の説明は adb devices コマンドの結果に対象のAndroid端末が含まれていることを前提とします。「よく分からん！」「認識されてない！」という方は以下のページを見たり、Google先生に相談してください！
api.unrealengine.com

-messaging オプションについて

Session FrontendがAndroidを認識するためには、-messagingをコマンドライン引数に追加した状態で実機上で起動させる必要があります。
api.unrealengine.com

と言っても、エディタ右上にあるLaunchボタンやProject Launcher経由で実機実行する場合は -messaging が自動的に追加されます。そのため、特に気にしなくてもSession Frontendで実機を認識します。(…昔は明示的に追加しないと駄目だったような)


●Engine\Source\Developer\LauncherServices\Private\Launcher\LauncherWorker.cpp

// game command line
FString CommandLine = FString::Printf(TEXT(" -cmdline=\"%s -Messaging\""),
	*InitialMap);

しかし、作成したパッケージを実機上で実行する場合はこの手は使えません。何故なら、Android OSはコマンドライン引数を実行可能ファイルに渡すことをサポートしていないからです。
そのため、UE4では UE4CommandLine.txtというファイルを経由してコマンドライン引数を渡す方法が用意されています。

UE4CommandLine.txt について

上述の通り、UE4CommandLine.txtを使うことでパッケージの場合でもコマンドライン引数を渡すことができます。更に、このファイルはパッケージインストール後に生成された「 /AndroidのストレージのRoot/UE4Game/Project名/ 」に配置すれば認識されるため、コマンドライン引数を変える度にパッケージ作成をする必要はありません！

この機能のおかげで「起動時に開くレベルの変更」や「一部機能を制限」などのデバッグ・プロファイリングで必要となる操作を手軽に行うことができます。

../../../TestProject/TestProject.uproject /Game/Maps/LevelA -Messaging

%ANDROID_HOME%\platform-tools\adb.exe push UE4CommandLine.txt /mnt/sdcard/UE4Game/UE4Game/UE4CommandLine.txt

Android Debug Monitorを使ってログを確認する方法

Android開発で使用するSDKに含まれる Android Debug Monitorを使うことで実行中のログを確認する方法もあります。この方法のメリット・デメリットは以下の通り。

メリット

• 「-messaging」をつける必要がない
• Session Frontendよりも詳細なログを確認可能
• 起動即クラッシュのように、Session Frontendではログを確認し辛い場合でも有効

デメリット

• ログの内容が詳細過ぎて見づらい
• UE4以外のアプリのログも出力される ( 後述のフィルタ機能で対応可能 )
• Session Frontendではできた「コンソールコマンドの送信」ができない

良し悪しがありますが、サクッとログを見たいときや即クラッシュ調査時には結構便利なのでオススメです。

マーケットプレイス

Comic Book Looks and Particles by SavasCetin in Visual Effects - UE4 Marketplace

illustrious by 4loup in Visual Effects - UE4 Marketplace

All Platform Outline Pack by Jiffycrew in Visual Effects - UE4 Marketplace

Cel Shading and Outline Materials by Piperift in Visual Effects - UE4 Marketplace

Advanced Cel Shader Lite by Skull in Materials - UE4 Marketplace

Cartoon Cel Shading Post Process by Urszula Kustra in Materials - UE4 Marketplace

Cel Shading Outline Post Process w Transparency by Vyrulent Studios in Materials - UE4 Marketplace

Post Processing Based Anime and Manga Stylistic Rendering Pack by X-Universe in Materials - UE4 Marketplace

JIFFYCREW CEL SHADING (DEFERRED) by Jiffycrew in Materials - UE4 Marketplace

Outliner by Void Lantern in Materials - UE4 Marketplace

Anime Toon Shading by Krystian Komisarek in Blueprints - UE4 Marketplace

Advanced Cel Shader Lighting Model by Skull in Visual Effects - UE4 Marketplace

Jiffycrew Post Process Line by Jiffycrew in Materials - UE4 Marketplace

JIFFYCREW HATCHING by Jiffycrew in Materials - UE4 Marketplace

Chameleon Post Process：SumFX：Blueprints - UE4 マーケットプレイス

コミュニティ

GitHub - alwei/PPCelShader

UE4 : 水彩 Post Process Material - ゲームの花園

GitHub - ruyo/VRM4U: Runtime VRM loader for UnrealEngine4

解説記事・資料

セルシェード - UE4 Document@com04
UE4のセルシェード実装方法を纏めたい - Qiita

はじめに

UE4にはスケルトン（ボーン構造）が異なっていてもアニメーションを流用することができる「アニメーションリターゲット」という機能があります（スケルトンが同じ場合でもアニメーションリターゲットといいますが、今回触れるのはスケルトンが異なる場合のアニメーションリターゲットです）。
api.unrealengine.com

しかし、上記のページでも説明されている通り、ベースポーズが異なるとアニメーションが破綻してしまします。

友情出演：千駄ヶ谷渋ちゃん
hub.vroid.com

VRMインポートで使用したライブラリ
github.com

ベースポーズをエディタ上で手動でT-Poseにすることで緩和することができますが…すごく面倒です。そこで、事前に用意したT-Poseのアニメーションをベースポーズにします。

T-Poseのアニメーションファイルはこちら（完全に自由に利用可）。SK_Mannequinのスケルトンをインポート時に指定してください。
drive.google.com

T-Poseのポーズアセットをベースポーズに

ベースポーズにはアニメーションシーケンスアセットを直接指定することはできず、ポーズアセットにする必要があります。そのため、以下のページを参考に、T-Poseのアニメーションシーケンスアセットをポーズアセットにします。
api.unrealengine.com

作成後、SK_Mannequinのスケルトンを開き、Retarget ManagerタブのModify PoseボタンからT-Poseアセットをベースポーズにします。

設定が完了すると、Retarget ManagerタブのView Poseボタンを押すとSK_Mannequinが以下の画像のようにT-Poseになります。

ベースポーズをT-Poseに変更できたので、以下のようにT-Poseがベースポーズのモデルに「いい感じに」リターゲットできるようになります。

もしベースポーズを元々のAポーズ（っぽい）に戻したい場合は、Modify Poseボタンを押したあとにあるResetから可能です。

おわり

はじめに

疑似物理プラグインであるKawaii Physicsを先日リリースしました。髪、スカート、胸などの揺れものを「かんたんに」「かわいく」揺らすことができます。



github.com

エンジン標準のPhysics AssetやAnim Dynamicsは高性能かつ多機能なのですが…慣れるまでは調整大変といった声を聞こえてきたので、自作AnimNodeの勉強も兼ねて作った感じです。趣味プロジェクトです(ここ大事)。

せっかくなので、AnimNodeの自作やKawaii Pyhscisの内部実装に関して単にですがまとめようと思います（未来の自分用メモという意味合いもあります）。
これで皆さん自由に拡張・不具合修正できますね！

なお、本記事ではKawaii Physicsの使い方に関する説明はしません。そちらに関しては、Githubで公開しているサンプルと簡易ドキュメントをご確認くださいまし…。

参考

www.unrealengine.com
qiita.com
qiita.com
あと、エンジンコード

各クラスに関して

まずは全体像を…ということでプラグインに含まれる各クラスについてざっくり説明します。

AnimNode_KawaiiPhysics

//  Component座標系から引数で指定した座標系への変換
FAnimationRuntime::ConvertCSTransformToBoneSpace
// 引数で指定した座標系からComponent座標系への変換
FAnimationRuntime::ConvertBoneSpaceTransformToCS

FAnimationRuntime::ConvertCSTransformToBoneSpace(ComponentTransform, Output.Pose, BoneTransform, CompactPoseIndex, BCS_BoneSpace);
BoneTransform.SetRotation(Capsule.OffsetRotation.Quaternion() * BoneTransform.GetRotation());
BoneTransform.AddToTranslation(Capsule.OffsetLocation);
FAnimationRuntime::ConvertBoneSpaceTransformToCS(ComponentTransform, Output.Pose, BoneTransform, CompactPoseIndex, BCS_BoneSpace);

int32 FReferenceSkeleton::GetDirectChildBones(int32 ParentBoneIndex, TArray<int32> & Children) const
{
	Children.Reset();

	const int32 NumBones = GetNum();
	for (int32 ChildIndex = ParentBoneIndex + 1; ChildIndex < NumBones; ChildIndex++)
	{
		if (ParentBoneIndex == GetParentIndex(ChildIndex))
		{
			Children.Add(ChildIndex);
		}
	}
	return Children.Num();
}

// Damiping
Bone.PhysicsSettings.Damping = PhysicsSettings.Damping;
if (TotalBoneLength > 0&& DampingCurve && DampingCurve->GetCurves().Num() > 0)
{
	Bone.PhysicsSettings.Damping *= DampingCurve->GetFloatValue(LengthRate);
}
Bone.PhysicsSettings.Damping = FMath::Clamp<float>(Bone.PhysicsSettings.Damping, 0.0f, 1.0f);

はじめに

UE4にはDataTableという機能があり、この機能を活用することで大量のデータを効率よく管理することができます。そして、csvや jsonとの連携機能を持っているため、
「みんな大好きExcelで編集」
→ 「UE4エディタが変更を検出して自動インポート( Auto-Import )」
→ 「DataTableに反映」
というフローが一般的になっています。
データ駆動型のゲームプレイエレメント | Unreal Engine ドキュメント
[UE4] CSVデータを扱う方法 DataTable編｜株式会社ヒストリア
【UE4】DataTableの使い方-その① ～基本編～【★～★★】 - キンアジのブログ

ただExcelを毎回開くのが少し面倒です（環境によってはExcelがそもそもインストールされてないことも）。
また、Excelをインポート → DataTableに反映という流れの都合上、パッケージで動作中にExcelを使ったパラメータ編集をするのは難しいです。そのため、Excelを編集するたびにパッケージを作成し…という手間がありました。

なんか良い手はないかなぁと思っていた時に…

「うちはGoogleスプレッドシートからデータ抽出してるよ。そのおかげでパッケージでもデータをガンガン編集できるよ」

という講演をどこかで聞き、おお！これは実装してみよう！…と思ったのが約2年前。やっと実装してみました。

www.youtube.com
Googleスプレッドシートの内容がDataTableに無事反映されています。素晴らしい。

ということで、やってみたことを自分用メモを兼ねて書いていきます。なお、この辺りに関しては完全に初心者なのでもっといい方法があるかもしれません。ご存知の方はこそっと教えて下さい！

Googleスプレッドシートからデータを抽出する方法を調べてみた

まずはWeb上にあるGoogleスプレッドシートから各データを引っ張ってくる処理について検索してみると、特定のURLから取得する方法、又はGoogle Sheets APIを使う方法のどちらかになるようです。

公式ドキュメント
Reading & Writing Cell Values  |  Sheets API  |  Google Developers
Method: spreadsheets.values.get  |  Sheets API  |  Google Developers
参考ブログ記事
Google Sheets API v4を適当に叩いて適当にデータをJSONで取得する - taiki-t's diary
[PHP] Google Sheets API を使ってスプレッドシートに値を書き込む | AgoHack

厳密にするのなら後者の方法が良いみたいですが、今回はサクッと実装したかったので前者の方法を試してみました。

やったことは以下の通り。詳細は上記の参考ブログを見てくださいまし。

1. Google Cloud Platform に登録・プロジェクトを作成し、APIキーを作成 https://console.developers.google.com/apis/credentials
2. Google Sheets APIを ↑ で作成したプロジェクトに登録 https://console.developers.google.com/flows/enableapi?apiid=sheets.googleapis.com
3. 使用するスプレッドシートを公開 ( リンクを知っている全員が閲覧可能 という設定でOK )

これでWebブラウザで以下の形式のURLにアクセスすると、Json形式でデータを取得できるようになります。
https://sheets.googleapis.com/v4/spreadsheets//values/?key=

↓

UE4エディタ上で、HTTP経由でGoogleスプレッドシートからデータを抽出してみた

次は、UE4エディタ上で先程試したことを同じことをします。なお、使用するノードの関係で、Editor Utility Widget上で実装を行います。
[UE4]エディタ上で動作するツール・エディタ拡張をUMGで簡単に作れる Editor Utility Widget について - Qiita

UE4にはFHttpModule というHTTP通信をするための機能が用意されています。
UE4.10 How To Make HTTP GET Request in C++ - Epic Wiki
[UE4] HTTP通信 その１ ～基本編～｜株式会社ヒストリア
UE4 で http 通信を行う - お茶漬けびより
UE4: FHttpModule 系の HTTP リクエスト機構を使い "同期処理" する方法 - C++ ときどき ごはん、わりとてぃーぶれいく☆
UE4/C++: http(s) リクエストに FHttpModule 系を使う場合の OnProcessRequestComplete/FHttpRequestCompleteDelegate の成否フラグの注意どころ - C++ ときどき ごはん、わりとてぃーぶれいく☆

しかし、残念ながらBPでは用意されていません。また、これを試していた時の僕は C++ を書く気分ではありませんでした。

なので、金で解決しました。Money is Powerです

LE Http Request：Low Entry：Code Plugins - UE4 マーケットプレイス

そんなこんなでサクッと実装し…

Get GoogleSparedSheet Data using HTTP > BlueprintUE.com | PasteBin For Unreal Engine 4

サクッと取得できました。大人って汚いですね。

Googleスプレッドシートから抽出したJsonデータから更に必要な箇所だけ抽出してみた

あとは抽出したデータをDataTableに反映するだけなのですが、そのためにはまずJsonデータから必要なデータ（values）だけを抽出する必要があります。

UE4にはJsonデータを扱うための機能が用意されています。
[UE4][C++]FJsonSerializebleマクロを使ってみる｜株式会社ヒストリア
Unreal Engine4 でローカルにあるJsonをパースする。 - LIFULL Creators Blog
Unreal Engine4でJsonデータをパースしてみた | SystemTelescope

しかし、残念ながらBPでは用意されていません。また、これを試していた時の僕は C++ を書く気分ではありませんでした。

なので、金で解決しました。金は力です

LE Json：Low Entry：Code Plugins - UE4 マーケットプレイス

そんなこんなでサクッと実装し…

サクッと取得できました。大人はこういうことを平気でする

抽出したデータ(values)をDataTableに反映する

最後は抽出したデータをDataTableに反映します。軽く調べた所、DataTableにまとまったデータを反映するには UE4.23 時点ですと Fill Data Table from CSV / JSON Stringノードが役に立ちそうです。

今回の場合、Fill Data Table from CSV Stringを使う場合は

---,MaxWalkSpeed,GravityScale,Jump Z Velocity,Air Control
Default,"550.000000","3.000000","800.000000","1.000000"
Boost,"550.000000","3.000000","800.000000","1.000000"

Fill Data Table from JSON Stringを使う場合は

[
	{"Name": "Default",
		"MaxWalkSpeed": 550,
		"GravityScale": 3,
		"Jump Z Velocity": 800,
		"Air Control": 1},
	{"Name": "Boost",
		"MaxWalkSpeed": 550,
		"GravityScale": 3,
		"Jump Z Velocity": 800,
		"Air Control": 1}
]

という感じの形式に整形する必要がありそうです。（DataTableアセットの右クリックメニューからCSV, Jsonを出力すればどういう形式のデータにするべきか確認できます。）

今後の拡張性を考慮するならJson形式に整形すべきかと思うのですが、今回はとにかく楽に実装したかったのでCSV形式にしました。
以下の順番で各文字列が来るので、改行と","を挟むだけなので超ラクです。

---
MaxWalkSpeed
GravityScale
Jump Z Velocity
Air Control
Default
55038002
Boost
55038001

で、実際にはこんな感じのノードになりました。

Pickup Json data f and convert to DataTable > BlueprintUE.com | PasteBin For Unreal Engine 4

最後に

これでGoogleスプレッドシートの内容をDataTableに反映することができました。あとは、反映されたタイミングでその結果を各キャラ・システムなどに反映すればOKです。または一定時間毎にDataTableを見に行くという開発用機能を各キャラ・システムに組み込むのも良いかと思います。

ただし、Fill Data Table from CSV / JSON Stringノードはエディタ専用の機能なので、PIEでは動作しますがパッケージでは動作しません。そのため、パッケージの場合でもGoogleスプレッドシートの内容を反映させたい場合はDataTableを経由せずに直接対象のパラメータを変更する処理にする必要があるかと思います。また試してませんが、DataAssetを活用するといい感じになる予感がギュンギュンします
[UE4][C++] ユーザー定義オブジェクトのアセット化で楽をする｜株式会社ヒストリア
UE4 c++を用いたデータテーブルを使った独自データアセットの作成 - Qiita
【UE4】手軽に独自のデータアセットを作成する 【★★】 - キンアジのブログ

おしまい

はじめに

年末年始で思ってたよりも時間が取れたので、
2019年内にリリースされたUE4の各バージョン（UE4.22, 23, 24）を復習。
全部はしない上にメモ代わりなので雑な文章になると思います。ご了承くださいましまし
docs.unrealengine.com

順次更新

ガチ勢の皆様へ

少し長くなるかもなので先に結論から

• ループマーカー対応の話ではありません。イントロ用・ループ用のサウンドアセットを個別に用意する必要があります
  • ｺﾞﾒﾝﾅｻｲ
• BPMと小節・伯単位による管理が可能になったという話です
• アセット側で再生する小節・拍数などの設定ができますが、BPを使った実装も『少し』必要です
• UE4.24現在でもベータ機能です
• 処理負荷が増えるのでご注意ください
• ○DXか○MODか○wise使えばいいじゃん…という言葉は聞こえません。…聞こえないって言ってるだろ！！！

はじめに

ステージ開始時にBGMのイントロ部分を再生し、その後はループ部分を流す『イントロ付きループ』はゲームでよく見ます（聞きます？）。…が、UE4の標準機能で実装すると様々な工夫・妥協をする必要がありました。

• 【UE4】イントロ付きループBGMを実装する方法 - SAT04 CREATIVE SPACE
• UE4 サウンドキュー作成例 - Qiita
• 【UE4】UE4でイントロ・アウトロ付きBGMループを実装する - 大福未来研究所

詳細は上記の記事を見ていただくとして…問題を簡単にまとめると以下の通りです。

• BP, SoundCueにおけるDelayノードでは精度が足りず、イントロとループは自然にならない・安定しない
  • シームレスな音楽の連続再生を実現するにはサンプリングレートでのタイミング精度が求められる
    • 原理的に48kHzの音声ファイルなら、1秒間に48000フレーム
  • Fade In/Outによるクロスフェードでごまかす手もあるが使えないケースがある上に実装コストが少し高い

UE4初期からこの問題を抱えており、個人的にもずっとモヤモヤしていたのですが…
UE4.22で入ったTimeSynth機能を使うことで
高精度かつ（比較的）簡単にイントロループを実現可能になりました！

www.youtube.com
ということで実装してみました。素人耳ですが…たぶんいい感じかと思います！！！（音飛びは録画の問題
以降は↑の作業手順について自分用メモも兼ねて書いていきます。

TimeSynthについて

TimeSynth (ベータ)
TimeSynth は、サウンドデザイナーへ音声クリップのサンプルベースの正確な開始、停止、連結を提供することに重点を置いた、新しいオーディオ コンポーネントです。TimeSynth で、インタラクティブな音楽アプリケーションに不可欠な、正確で同期的なイベント オーディオとイベント キューが可能になります。
https://www.unrealengine.com/ja/blog/unreal-engine-4-22-released

従来の方法はGame Threadに依存しているため、上図のようなズレが生じたりフェード処理で誤魔化す必要がありました。

TimeSynth機能はこの問題を解決するため、Game Threadには依存しない上により細かい間隔でサウンドを管理します。具体的には 小節・拍単位での管理を可能にします。その結果、イントロ付きループやインタラクティブミュージックなどの従来の仕組みでは難しかった表現を可能にしています。（注：簡単にとは言ってない。特にインタラクティブミュージックに関して）

※ インタラクティブミュージックについて非常に参考になる記事

• 「インタラクティブミュージック」という、ゲームと音楽の関係性。連載開始。｜じーくどらむす｜note

導入手順・詳細に関しては以下の記事をご確認ください。

• [UE4]TimeSynthでBGMに同期した演出を作る｜株式会社ヒストリア
• Time Synth Live Streaming Demo メモ｜床｜note

また、Epic本社のライブストリームが非常に参考になります。動画・スライドに加えて、なんとイントロループデモ付きのサンプルプロジェクトも！

• Unreal Engine Livestream - TimeSynth in Blueprints - April 25 - Live from HQ - Unreal Engine Forums
  • サンプルプロジェクトで見るべきポイント
    • DoriansRun_Intro_Lo
    • DoriansRun_Intro_Hi
    • DoriansRun_MainLoop_Lo
    • DoriansRun_MainLoop_Hi
    • CompletedDoriansRunActor の StartMusic, OnBarEvent

で、上記の情報を見た人間が「やってみよう->できた！」のでその流れを書こうと思ったのが本記事です。なので、以降は少なくともヒストリア様の記事を見た前提で書いていきます。また、私はサウンドに関してもド素人なので、「使用する素材は公開されているものをお借りする」「ソフトはプロ向けではないフリーのものを使用する」というゆるふわな内容になっています。ご理解くださいましまし

今回お借りした素材はこちらです。「ループのみ」と「イントロ+ループ+フェードアウト」の2種類が公開されています。
フリーBGM素材「弾丸」試聴ページ｜フリーBGM DOVA-SYNDROME

使用するBGMのBPM、イントロ・ループの切り替わりタイミングを確認する

まずはTimeSynthClipを設定するために、使用するサウンドのBPM、切り替わりタイミング（小節・拍数）を知る必要があります。

BPMに関しては『BPM Analyzer』というソフトが簡単でした！D&Dで放り込むだけでBPMをすぐ計測してくれます！便利！
【徹底解説】BPM(テンポ)を自動で測定する「BPM Analyzer 」が超オススメ！曲のテンポを調べるには計測ツール（無料ソフト）で便利です！ | のり部屋

小節・拍数に関しては、『Audacity』のリズムトラックという機能を使いました（もっといいやり方がある気がする…
【Audacity】メトロノーム音を追加する方法

こんな感じで小節・拍を可視化してくれるので、イントロ・ループ部分の小節・拍数を手動で数えます（もっといいやり方がある気がする…

TimeSynthClipの設定

『BPM Analyzer』と『Audacity』を使って分かった情報は以下の通り。これらの情報をTimeSynthClipに反映していきます。

• BPM：110
• イントロ部分：8小節
• ループ部分：25小節

今回お借りした素材はキレイに小節で区切られたいたので設定もシンプルです。

再生用BPの実装

BPMの設定、1小節毎のイベント発行、TimeSynth開始、イントロ用TimeSynthClipの再生を行っています。ここで注意すべきことは、PlayClipノードを実行したタイミングでサウンドが再生されるわけではないことです。TimeSynthClipのClipQuantizationで設定した値を元に再生を開始するので、1Barに設定されている場合は最大1小節分待った後に再生されます（で、ですよね…？少し自信ない）。

1小節毎に発行されるイベントの処理です。イントロまたはループ部分の再生が完了したタイミングでループ部分を再生する必要があるため、このような実装になっています。なお、Num Barsの初期値は0です。

これで準備完了です！再生開始すると初めに紹介した動画のようにイントロ付きループが再生されます！やったね！

最後に

今回はTimeSynth機能を使ってイントロ付きループを実装してみました。これまでのDelayやFade処理が頑張ってた頃に比べると大分楽になったかと思います！

TimeSynthはイントロ付きループだけでなくこの他にも様々な表現が可能です。ヒストリア様の記事にあるようにサウンドに合わせた演出を入れてみたり、Epic本社のライブストリームのように異なるサウンドをいい感じに切り替えたり…。是非色々試してみてください！

おしまい

はじめに

SubSystemって何？という方はまず以下のページをご確認ください。
Programming Subsystems | Unreal Engine ドキュメント

UE4.24時点であるSubSystem pic.twitter.com/Q3ZOMALtSC

— おかず (@pafuhana1213) 2019年12月29日

UE4.24でEdiorSubSystem継承のSubSystemが幾つか追加されています。そして、その中のEditor Validator Subsystemはアセット保存時などで走るチェック処理（Validate Assets）を簡単に拡張できるという非常に強力な仕組みです！例えば「対象のStatic MeshアセットがLODを持っていない場合はエラーを出す」というチェック・通知処理をBPでサクッと作ることができます。

このような仕組みを用意することで「不適切な設定なアセットが混じることで余分な負荷・エラーが発生する」ことを防止できます。特に中規模・大規模プロジェクトでは致命的になりがちなので早めの段階で用意しておきましょう！

Editor Validator Subsystemの使い方

「対象のStatic MeshアセットがLODを持っていない場合はエラーを出す」を例にどのようにしてEditor Validator Subsystemを使うのかを説明します。

最後に

簡単ではありましたが、Editor Validator Subsystemを使ってアセットのチェック処理を拡張する方法について紹介しました！実装が簡単な上に、エンジン標準のチェック処理に追加する形になるのでワークフローも組みやすいかとと思います。また、ログ出力と違って最前面にエラー文を出せるというのは大きな強みかと思います！是非試してみてください！

おまけ

具体的にどういう仕組みになっているのか知りたい方は UEditorValidatorSubsystem::ValidateAssets の実装をご確認ください。

おしまい

はじめに

Androidアプリのバージョン情報には、整数のVersionCode と 文字列の VersionNameの2つで管理があります。
VersionCodeはストア上での管理で用いられるものです。そして、過去にストアにアップロードしたVersionCodeとの重複が許されないため、ストアにアップするたびに値を追加する必要があります。
VersionNameはユーザへの表示のみを目的としたもので自由に設定することが可能です（例：1.2.3-beta）

参考：
アプリのバージョニング  |  Android デベロッパー  |  Android Developers
versionCodeとversionNameの 違い | アプリ開発のお勉強！ アプリリ

バージョン情報の設定方法について

一般的なAndroid開発の場合は build.gradle という名前のファイルにVersionCode, VersionNameを記述するのですが、UE4を使ったAndroid開発の場合はプロジェクト設定で記述することになります。

上の赤枠のStore Version が Version Code、下の赤枠のVersion Displayが Version Name にあたります。
（名前合わせたほうが混乱しなかったのでは…）

Store Version Offsetで設定した値は、横にある( )内のCPUをサポートするアプリのStore Version に加算されます。そのため、例えばプロジェクト設定のPlatform - AndroidにあるBuildカテゴリの設定を以下のようにすると、作成したパッケージ( APK )のVersionCodeは10+1=11になります。

ここでカンの良い人は ↑↑図のStore Version Offsetの設定は破綻する可能性があることに気づきます！いったい何が問題なのでしょうか…？

はじめに設定した通り、Version Codeは重複が許されません。そのため、armv7 対応版と arm64対応版をそれぞれストアにアップするプロジェクトの場合、 Store Versionを「11」に設定してアップしようとすると armv7 版は VersionCodeの重複が原因で失敗するはずです。

そのため、実際にStore Version Offsetを運用する際は以下のように重複を回避することを考慮する必要があります。ちなみに、 パッケージが1種類だけプロジェクトの場合は Store Version Offsetを 初期値の0から変更する必要はありません。

バージョン情報の取得方法について

アプリを更新するかしないかの判定など、 アプリ起動中にStoreVersionを知りたいケースが時々あるかと思います。ということで取得方法についてもご紹介。

プロジェクト設定で設定したStoreVersion や VersionNameなどは UAndroidRuntimeSettings で保持されています。そのため、

.h ファイル

#pragma once#include "CoreMinimal.h"#include "Kismet/BlueprintFunctionLibrary.h"#include "AndroidRuntimeSettings.h"#include "MyBlueprintFunctionLibrary.generated.h"/** *  */
UCLASS()
class BUILD0425_API UMyBlueprintFunctionLibrary : public UBlueprintFunctionLibrary
{
	GENERATED_BODY()

	UFUNCTION(BlueprintCallable)
	staticint GetStoreVersion();

};

.cpp ファイル

#include "MyBlueprintFunctionLibrary.h"int UMyBlueprintFunctionLibrary::GetStoreVersion()
{
	return GetAndroidRuntimeSettings()->StoreVersion;
}

.build.cs 以下の内容を追加

PrivateDependencyModuleNames.AddRange(new string[] {"AndroidRuntimeSettings" } );

とすることで、StoreVersionを取得することが可能です。

VersionCode ではなく、StoreVersionであることに注意です！ 繰り返しになりますが、VersionCode は StoreVersion とStore Version Offset を足したものです。そのため、VersionCodeの値が欲しい場合は UAndroidRuntimeSettingsが持つ以下のプロパティの値も取得する必要があります。

// Offset to add to store version for APKs generated for armv7
UPROPERTY(GlobalConfig, EditAnywhere, Category = "APK Packaging", meta = (DisplayName = "Store Version offset (armv7)"))
int32 StoreVersionOffsetArmV7;

// Offset to add to store version for APKs generated for arm64
UPROPERTY(GlobalConfig, EditAnywhere, Category = "APK Packaging", meta = (DisplayName = "Store Version offset (arm64)"))
int32 StoreVersionOffsetArm64;

// Offset to add to store version for APKs generated for x86_64
UPROPERTY(GlobalConfig, EditAnywhere, Category = "APK Packaging", meta = (DisplayName = "Store Version offset (x86_64)"))
int32 StoreVersionOffsetX8664;

おしまい

余談：
In-app updates for games のベータが最近公開されたけども今後はこれが主流になっていくのかしら…？
developers-jp.googleblog.com