EasyJsonParser V1

ドット記法を使って JSON データに直感的にアクセスできるプラグイン。

概要

EasyJsonParser は Unreal Engine での JSON 処理を簡素化するプラグインです。エレガントなドット記法アクセスシステムを特徴とし、複雑なデータ構造を直感的で簡単に扱えます。

プログラミング経験が限られた開発者でも、このプラグインを使用して JSON データを簡単に解析し、活用することができます。

主要な機能

• ドット記法を使用した JSON データへのシンプルなアクセス
• 複雑なネストした JSON 構造のサポート
• 配列要素への簡単なアクセス
• C++ と Blueprint の両方に完全対応
• 高速で効率的な解析

使用方法

JSON 文字列または JSON ファイルを読み込んだ後、アクセス文字列を指定して値を取得できます。

アクセス文字列の指定

キーをドットで繋ぐことで、目的の値へのパスを指定します。

シンプルなケース

以下のシンプルな JSON から “prop” の値を取得するアクセス文字列は prop です。

{
  "prop": "abc"
}

階層構造のオブジェクトの場合

以下のような階層構造の場合、キーをドットで繋いでアクセス文字列を作成します。以下の例では、obj オブジェクトの prop プロパティを取得するために、アクセス文字列は obj.prop となります。

{
  "obj": {
    "prop": "abc"
  }
}

配列が含まれる場合

以下の例のような配列の場合、どの配列要素を使用するかをインデックスで指定します。例えば、2番目の要素のプロパティを取得するには obj[1].prop を使用します。1番目の要素のプロパティを取得するには obj[0].prop を使用します。

{
  "obj": [
    {
      "prop": "abc"
    },
    {
      "prop": "def"
    }
  ]
}

型別の値取得

JSON オブジェクトから値を取得するために、以下の4つの関数が提供されています。

• ReadInt(int)
• ReadFloat(float)
• ReadString(string)
• ReadBool(bool)

“AccessString” にアクセス文字列を、“DefaultValue” にデフォルト値を入力します。

JSON に指定した値が存在しない場合、デフォルト値が返されます。

オブジェクトの取得

値の代わりにオブジェクトを取得できる “ReadObject” と “ReadObjects” メソッドもあります。これらのメソッドは、オブジェクト型のプロパティでのみ使用できます。

• ReadObject は単一のノードオブジェクトを取得します。
• ReadObjects は複数のオブジェクトの配列を取得します。

以下の図のように、これらのメソッドを使用して階層の途中にあるオブジェクトを取得し、そのプロパティにアクセスできます。

FAQ

よくある質問はこちらで確認できます。