Awesome
VMagicMirror_MotionExporter
About
UnityのHumanoid Animationをエディターからシリアライズし、ランタイムでデシリアライズする処理を実装したプロジェクトです。
- AssetBundleを使うほどではない場面での使用を想定しています。
- UnityのAnimation Clipに依存し、それ以外のデータ規格には依存しません。
初期実装の時点ではUnity 2019.4のアニメーションデータに沿った情報をエクスポートするようになっています。
A project to serialize Unity Humanoid Motion on editor, and deserialize at runtime.
- Can be thought to be a ligher version of AssetBundle.
- Dependency is Unity Animation Clip data, and independent to other motion file format (like fbx).
In the first implementation data format is based on Unity 2019.4.14f1.
Install
Import .unitypackage
on Releases page.
How to Use for VMagicMirror
How to Use for General Purpose
JP
バージョン: Unity 2019.4.x (推奨バージョン: 2019.4.14f)
- エクスポート: エディタ上で適当なGameObjectに
MotionExporter
コンポーネントをアタッチし、エクスポートしたいクリップを指定してExport
ボタンをクリックすることで、StreamingAssets
以下にファイルがエクスポートされます。 - インポート: エクスポートされたデータを
MotionImporter
で読み込んでDeserializedMotion
を生成します。 - 実行:
DeserializedMotion
がAnimationClip
の代替となり、HumanoidAnimationSetter
がAnimator
の代替となります。
実際にアニメーションをインポート、実行する例としてMotionTestPlay
スクリプトが入っています。このスクリプトの動作を次のようにして確認できます。
- エクスポート作業を行い、
StreamingAssets
以下にファイルを出力する Assets/Baku/VMagicMirror_MotionExporter/Scenes/MotionExporter
を開く- 適当なヒューマノイドモデルをシーン上に配置する
MotionTestPlay
コンポーネントを次のように設定するFileName
: エクスポートしたファイルの名称Target
: シーン上に配置したヒューマノイドOnlyUpperBody
: 上半身のモーションだけ再生したい場合はtrue
- エディタ上で実行する。または、シーンをビルドして実行する
EN
Version: Unity 2019.4.x (recommended2019.4.14f)
- Export: Add
MotionExporter
component to some GameObject on the scene, and set AnimationClip to export, then clickExport
on the component to save the data inStreamingAssets
folder. - Import:
MotionImporter
class translate serialized json toDeserializedMotion
. - Run:
DeseiralizedMotion
works likeAnimationClip
andHumanoidAnimationSetter
is an alternative ofAnimator
.
MotionTestPlay
scripts is an example, and you can test it by following steps.
- Follow Export step to get output file in
StreamingAssets
folder. - Open
Assets/Baku/VMagicMirror_MotionExporter/Scenes/MotionExporter
- Put a humanoid model on the scene
- Setup
MotionTestPlay
FileName
: Exported file nameTarget
: Humanoid object in the sceneOnlyUpperBody
: Turn on if you want to play only upper body motion
- Run in editor, or build to play.
OSS License
NOTE: If you are using just .unitypackage
in Releases you can ignore the license note of UniVRM. The original project (before exported) contains UPM definition to import UniVRM, so if you clone the project itself you will use UniVRM.
MIT License
Copyright (c) 2020 VRM Consortium Copyright (c) 2018 Masataka SUMI for MToon
Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.