トラブルシューティング
Unreal Engine Plugin利用時によくあるトラブルを説明しています。Unreal Engine Pluginが正しく動作しない場合は、下記を参考に対処してください。
よくあるトラブル
- ［Contents Browser］タブ／ウィンドウにMocopiLiveLinkフォルダが表示されない
- シーン上に配置したUnrealマネキンが表示されない
- アクターが動かない（モーションデータが受信できない）
- UDP通信でモーションデータを受信できない（送信元サブジェクト名の記載がない）
- モーションデータを受信できない（黄色のインジケーターが表示されている、またはソースインスタンスが記載されていない）
- モーションデータを受信できているがmocopiマネキンが動かない（緑色のインジケーターが表示されている）
- モーションデータを受信できているがUnrealマネキンが動かない（緑色のインジケーターが表示されている）
- モーションデータを受信できているがUnrealメタヒューマンが動かない（緑色のインジケーターが表示されている）
- アクターが配置した場所から大きく移動してしまった
- アクターのトランスフォームと回転のデータはトラッキングされたが、それ以外のアニメーションデータが受信されない
- ［Take Recorder］タブ／ウィンドウで記録しても空データが出力される
- Mocopi LiveLinkソースが作成できない（ライブラリが見つからないというエラーが出る）
- macでパッケージ化に失敗する
- macでパッケージ化は成功しても、ゲームが実行できない
- 「Metahuman」または「Unreal Mannquin」が見つかりません。とエラーが表示され、パッケージ化に失敗する
- 同じアイテム(MocopiLiveLink)がすでに追加されてますと表示される
［Contents Browser］タブ／ウィンドウにMocopiLiveLinkフォルダが表示されない
- ［Contents Browser］タブ／ウィンドウ右上の［Settings］をクリックし、［Show Plugin Content］が選択されていることを確認してください。
シーン上に配置したUnrealマネキンが表示されない
- Unrealマネキンに必要なアセットがあることを確認してください。プラグインは、「Third Person Game Project」テンプレートに含まれるUEマネキンアセット（Manny）を使用します。
アクターが動かない（モーションデータが受信できない）
モーションデータが受信できていないときは、Live LinkウィンドウのサブジェクトパネルにMocopi LiveLinkソースのサブジェクト名が表示されません。以下を確認してください。
- 開発環境を満たしていることを確認してください。
- Wi-Fiを使用して接続する場合は、mocopiアプリがインストールされているスマートフォンがWi-Fi接続を有効にしていて、パソコンと同じアクセスポイントに接続していることを確認してください。
- mocopiアプリが「モーション」＞「送信」モードに設定されている（「保存」モードに設定されていない）こと、「ストリーミング」が開始されたことを確認してください。
- mocopiアプリの接続先IPアドレスが、Unreal Engineを起動しているパソコンのIPアドレスになっていることを確認してください。
- UDP送受信のポート番号が一致していることを確認してください。
- mocopiアプリの送信フォーマットが「mocopi (UDP)」になっていることを確認してください。
- 上記に問題がない場合は、次のUDP通信でモーションデータを受信できない（送信元サブジェクト名の記載がない）を参照してください。
UDP通信でモーションデータを受信できない（送信元サブジェクト名の記載がない）
開発環境OSのファイアウォールの設定で、mocopiアプリからUDP受信するポート番号の通信が許可されていることを確認してください。ブロックされている場合は、許可する設定を行ってください。
また、Wi-Fiを使用する場合は、ルーターの設定を確認し、UDPプロトコルとポートが許可されていることを確認してください。
以下に、Windowsの設定例を示します。
- Windowsの「セキュリティが強化されたWindows Defenderファイアウォール」を開きます。
- ［受信の規則］をクリックし一覧を表示します。
- 「Unreal Editor」を右クリックし、プロパティを開きます。
- ［詳細設定］タブの「プロファイル」で、開発環境に当てはまるネットワークにチェックを付けます。
- 「プロトコルおよびポート」タブの「プロトコルの種類」欄が、「任意」または「UDP」になっていることを確認します。
モーションデータを受信できない（黄色のインジケーターが表示されている、またはソースインスタンスが記載されていない）
一時的にデータを受信し、その後何らかの理由でストリーミングが中断された状況です。
- 開発環境を満たしていることを確認してください。
- mocopiアプリのデータストリーミングが停止していないことを確認してください。
- Wi-Fiを使用している場合は、スマートフォンのWi-Fi設定が別のネットワークに切り替わっていないことを確認してください。
- スマートフォンで有線LANアダプタを使用している場合は、ケーブルやアダプタに緩みがないことを確認してください。
- mocopiアプリの送信フォーマットが「mocopi (UDP)」になっていることを確認してください。
- Unreal Engineがインストールされているパソコンが複数のネットワーク（Wi-Fiや有線LAN）に接続されていないこと、また取得済みIPアドレスがスマートフォンと同じネットワーク上にあることを確認してください。
モーションデータを受信できているがmocopiマネキンが動かない（緑色のインジケーターが表示されている）
プラグインはmocopiアプリと通信してモーションデータを受信していますが、アクターにモーションデータが反映されていない状況です。
- アクターを動かすためのMocopi LiveLinkソースが存在し（削除されていない）、有効になっている（チェックが付いている）ことを確認してください。
- 「ABP_mocopi」ブループリントで選択したMocopi LiveLinkソース名が、プロジェクト内のMocopi LiveLinkソースのサブジェクト名と一致していることを確認してください。
- 複数のアクターが同じカスタム名を共有している場合、正しいアクターのカスタム名のチェックボックスが有効になっていること（同じ名前を共有している複数のアクターのうち、常に1つだけ有効になっていること）を確認してください。
モーションデータを受信できているがUnrealマネキンが動かない（緑色のインジケーターが表示されている）
プラグインはmocopiアプリと通信してモーションデータを受信していますが、アクターにモーションが反映されていない状況です。
- モーションデータを受信できているがmocopiマネキンが動かない（緑色のインジケーターが表示されている）を参照してください。
- リアルタイム リターゲティングを参照し、「MannequinActor」ブループリントの［Source_SkeletalMesh］コンポーネントの［Details］タブで、「Animation」クラスが［ABP_Mocopi］、「Skeletal Mesh」が［MocopiMannequin］であることを確認してください。ファイルを再選択することで、適切なファイルのリンクが確立できます。
- リアルタイム リターゲティングを参照し、「MannequinActor」ブループリントの ［Target_SketletalMesh］コンポーネントの［Details］タブで、「Animation」クラスが［ABP_Mannequin］、「Skeletal Mesh Asset」が［SKM_Manny］またはUE5.x対応のUnrealマネキンであることを確認してください。ファイルを再選択することで、適切なファイルのリンクが確立できます。
- 複数のアクターが同じカスタム名を共有している場合、正しいアクターのカスタム名のチェックボックスが有効になっていること（同じ名前を共有している複数のアクターのうち、常に1つだけ有効になっていること）を確認してください。
モーションデータを受信できているがUnrealメタヒューマンが動かない（緑色のインジケーターが表示されている）
プラグインはmocopiアプリと通信してモーションデータを受信していますが、アクターにモーションが反映されていない状況です。
- モーションデータは受信しているがmocopiマネキンが動かない（緑色のインジケーターが表示されている）を参照してください。
- メタヒューマンを使ってみようを参照し、メタヒューマンをアニメーションさせるために必要なプラグインと、必要な設定がすべてプロジェクトで有効になっていることを確認してください。
- メタヒューマンを使ってみようを参照し、使用するメタヒューマンのブループリントの［Source_SKM］コンポーネントの［Details］タブで、「Animation」クラスが［ABP_Mocopi］、「Skeletal Mesh」が［MocopiMannequin］であることを確認してください。ファイルを再選択することで、適切なファイルのリンクが確立できます。
- メタヒューマンを使ってみようを参照し、使用するメタヒューマンのブループリントの［Body］コンポーネントの［Details］タブで、「Animation」クラスが［ABP_Metahuman］、であることを確認してください。ファイルを再選択することで、適切なファイルのリンクが確立できます。
- 複数のアクターが同じカスタム名を共有している場合、正しいアクターのカスタム名のチェックボックスが有効になっていること（同じ名前を共有している複数のアクターのうち、常に1つだけ有効になっていること）を確認してください。
アクターが配置した場所から大きく移動してしまった
- 最高の品質のアニメーションを確保するため、記録する直前を含め、定期的に再キャリブレーションすることをお勧めします。
- リセットポジションすると、アクターが配置された場所にリセットされ、モーションの記録中に蓄積された移動を修正することができます。
アクターのトランスフォームと回転のデータはトラッキングされたが、それ以外のアニメーションデータが受信されない
これは、Unreal Engineがモーションデータをどこに配置するか判定できない場合に起こります。以下の方法で対処してください：
- アクター（メタヒューマンのブループリント）の［My Blueprint］タブの［Live Link］＞［LiveLinkBodySubj］の「Live Link Body Subj」で、「MocopiSkeleton」が選択されていることを確認してください。
- ［Live Link］＞［UseLiveLinkBody］の「Use Live Link Body」が未チェックであることを確認してください。
- ［My Blueprint］タブの［Live Retarget］＞［UseLiveRetargetMode］の「Use Live Retarget Mode」が未チェックであることを確認してください。
［Take Recorder］タブ／ウィンドウで記録しても空データが出力される
記録が成功しても、記録された内容やキーフレームが空になっている場合は、MocopiLiveLinkソースの「Use Source Timecode」を有効にし、mocopiアプリ［1.2.0以降］もしくはBVHSender［1.0.4以降］を使用してください。
Mocopi LiveLinkソースが作成できない（ライブラリが見つからないというエラーが出る）
新規でMocopi LiveLinkソースを作成しようとしたとき、エラーが発生した場合に表示されます。
- プラグインを再インストールして、プラグインに含まれるすべてのファイルが揃っていることを確認してください。
macでパッケージ化出来ない
mac環境でパッケージ化を実行した時にエラーが出た場合、下記の設定を行ってください。
- ブループリントプロジェクトの場合、C++クラスを新規作成して、C++プロジェクトに変換してください。
- C++プロジェクトの「Target.cs」ファイルに次のコードを追加してください。
if (Platform == UnrealTargetPlatform.Mac)
{
bOverrideBuildEnvironment = true; AdditionalCompilerArguments = "-Wno-deprecated-anon-enum-enum-conversion";
}
macでパッケージ化は成功しても、ゲームが実行できない
ブループリントプロジェクトで、プロジェクトにUnreal Engine Pluginをセットアップしている場合に発生します。
- ブループリントプロジェクトの場合、C++クラスを新規作成して、C++プロジェクトに変換してください。
- C++プロジェクトの「Target.cs」ファイルに次のコードを追加してください。
if (Platform == UnrealTargetPlatform.Mac)
{
bOverrideBuildEnvironment = true; AdditionalCompilerArguments = "-Wno-deprecated-anon-enum-enum-conversion";
}
「Metahuman」または「Unreal Mannquin」が見つかりません。とエラーが表示され、パッケージ化に失敗する
「Metahuman」または「Unreal Mannquin」アセットをインストールしていない場合に発生します。
- 以下のファイルを削除してください。
[Plugins/MocopiLiveLink/Content/Metahuman/ABP_Metahuman]
[Plugins/MocopiLiveLink/Content/UnrealMannequin/ABP_Mannequin]
同じアイテム(MocopiLiveLink)がすでに追加されてますと表示される
プロジェクトとUnreal Engine本体両方に「MocopiLiveLinkプラグイン」をインストールしている場合に、ブループリントプロジェクトをパッケージ化する際に発生します。
- プロジェクトもしくはUnreal Engine本体の片方にのみ「MocopiLiveLinkプラグイン」をインストールします。
- ブループリントプロジェクトの場合、C++クラスを新規作成して、C++プロジェクトに変換してください。
