Json

[最終更新日:2020/01/30]

概要

Live2D Cubismでは、ランタイム用データのいくつかをjson形式で扱っています。
Cubism SDK for Unity には、それらのjson形式のファイルをパース、及びインスタンス化を行うクラスが同梱されています。

SDK同梱のアセットインポーターによって、それらがインポートされたときにパース、インスタンス化していますが、ユーザがランタイムで読み込ませることも可能です。

 

 

CubismModel3Json

.model3.jsonのパーサです。

.model3.json内に記述されたモーションや表情など、各種他のjson���パスを取得することができます。

CubismModel3Jsonで.model3.jsonをパースするには、CubismModel3Json.LoadAtPath() を使用します。

 

パースしたデータからは、.model3.jsonに記述された各種ファイルの相対パスを取得することが可能です。

基本的に.model3.jsonの階層と同じ構造でパスを取得することができますが、.model3.jsonに記述された表情用データの参照につきましては独自の構造となっております。
これは、Cubismにおける.model3.jsonの構造の仕様上、UnityのビルトインのJsonパーサであるJsonUtilityでパースできないためです。
Cubism SDK for Unity では、表情データの参照だけ独自のJsonパーサによってパースしております。

 

パースした.model3.jsonからモデルのPrefabを生成するには、CubismModel3Json.ToModel()を使用します。

Cubism SDK for Unity に実装されている処理は、Unityエディタ上からプロジェクト内のアセットを読み込むことを前提としております。
ランタイムでAssetBundleなどから読み込む場合、読み込み処理をユーザ側で実装して頂く必要がございます。

ランタイムでのモデルの読み込み方法については こちら のチュートリアルをご覧ください。

 

CubismMotion3Json

.motion3.jsonのパーサです。

.motion3.json内に記述されたカーブ情報からAnimationClipを生成することができます。

CubismMotion3Jsonで.motion3.jsonをパースするには、CubismMotion3Json.LoadFrom() を使用します。

 

パースした.motion3.jsonからAnimationClipを生成するには、CubismMotion3Json.ToAnimationClip() を使用します。

 

 

CubismUserData3Json

.userdata3.jsonのパーサです。

.userdata3.json内に記述された情報からモデルのアートメッシュにユーザデータを適用することができます。

CubismUserData3Jsonで.userdata3.jsonをパースするには、CubismUserData3Json.LoadFrom()を使用します。

 

パースした.userdata3.jsonからユーザデータを取得するには、CubismUserData3Json.ToBodyArray()を使用します。

 

 

CubismPhysics3Json

.physics3.jsonのパーサです。

.physics3.json内に記述された物理演算設定をUnityで使用できるよう変換することができます。

CubismPhysics3Jsonで.physics3.jsonをパースするには、CubismPhysics3Json.LoadFrom()を使用します。

 

パースした.physics3.jsonからUnityで扱う形式に物理演算設定を変換するには、CubismPhysics3Json.ToRig() を使用します。

 

 

CubismExp3Json

.exp3.jsonのパーサです。

.exp3.json内に記述された表情差分の情報をUnity上で扱う形式に変換することができます。

CubismExp3Jsonで.exp3.jsonをパースするには、CubismExp3Json.LoadFrom()を使用します。

 

 

CubismPose3Json

.pose3.jsonのパーサです。

.pose3.json内に記述された情報から、Unity上でパーツの表示状態を制御する設定を取得できます。
Cubism SDK for Unity においては、Poseは生成されるAnimationClipのカーブを加工するのに使用されます。

Pose機能の詳細につきましては こちら をご覧ください。

CubismPose3Jsonで.pose3.jsonをパースするには、CubismPose3Json.LoadFrom()を使用します。

© 2010 - 2020 Live2D Inc.