JSON Serialization
JsonUtility 클래스를 사용하여 Unity 객체를 JSON 포맷으로 전환하고 전환합니다.
읽는 시간 3분최근 업데이트: 9일 전
JsonUtility 클래스를 사용하여 Unity 객체를 JSON 포맷으로 전환합니다. 예를 들어 JSON Serialization 사용하여 웹 서비스와 상호 작용하거나 텍스트 기반 포맷으로 데이터를 쉽게 패킹 및 언패킹할 수 있습니다.
JSON Serialization "구조화된" JSON의 개념을 사용합니다. JSON 데이터에 저장할 변수를 설명하는 클래스나 구조를 생성합니다. 예제는 아래와 같습니다.
[직렬화 가능]public class MyClass{ public int level; public float timeElapsed; public string playerName;}
이것은 세 가지 변수(level, timeElapsed, playerName)를 포함하는 일반 C# 클래스를 정의하고 JSON 시리얼라이저와 함께 작동하기 위해 속성으로 표시합니다. 클래스의 인스턴스를 생성하려면 다음을 사용할 수 있습니다.
SerializableMyClass myObject = new MyClass();myObject.level = 1;myObject.timeElapsed = 47.5f;myObject.playerName = "Dr Charles Francis";
그런 다음 JsonUtility.ToJson 메서드를 사용하여 JSON 포맷으로 직렬화(전환)합니다.
string json = JsonUtility.ToJson(myObject);// json now contains: '{"level":1,"timeElapsed":47.5,"playerName":"Dr Charles Francis"}'
JSON을 오브젝트로 다시 변환하려면 다음과 같이 JsonUtility.FromJson을 사용하십시오.
myObject = JsonUtility.FromJson<MyClass>(json);
그러면 새 인스턴스가 생성되고 JSON 데이터를 사용하여 값이 설정됩니다. JSON 데이터에 의 필드에 매핑되지 않는 값이 포함된 경우, 시리얼라이저는 해당 값을 무시합니다. JSON 데이터에 에 있는 필드에 대한 값이 누락된 경우, 직렬화기는 반환된 객체에 해당 필드에 대한 구성된 값을 남깁니다.
MyClassMyClassMyClassJSON으로 오브젝트 덮어쓰기
기존 오브젝트 위에 JSON 데이터를 역직렬화하여 기존 데이터를 덮어쓸 수도 있습니다.
JsonUtility.FromJsonOverwrite(json, myObject);
JSON 데이터에 필드에 대한 값이 없는 경우, 시리얼라이저는 해당 필드의 값을 변경하지 않습니다. 이 메서드를 사용하면 이전에 생성한 오브젝트를 재사용하여 할당을 최소화할 수 있습니다. 또한 약간의 필드 하위 집합만 포함하는 JSON으로 의도적으로 오브젝트를 덮어쓰는 방식으로 오브젝트를 "패치"할 수도 있습니다.
지원되는 유형
JSON Serializer API는 속성을 가진 모든 서브 클래스, 서브 클래스 또는 일반 클래스 또는 구조체를 지원합니다. 프로세싱을 위해 표준 Unity 시리얼라이저에 오브젝트를 전달하면 인스펙터에서와 동일한 규칙과 제한이 적용됩니다. Unity는 필드만 직렬화하며, 같은 타입은 지원되지 않습니다.
[Serializable]MonoBehaviourScriptableObjectDictionary<>Unity 기본 타입이나 배열과 같은 다른 타입을 API 직접 전달하는 기능을 지원하지 않습니다. 이들을 변환해야 하는 경우, 어떤 종류의 또는 로 래핑하십시오.
classstruct에디터에서만 UnityEngine.Object에서 파생된 모든 오브젝트를 JSON과 JSON으로 직렬화할 수 있는 병렬 API인 EditorJsonUtility가 있습니다. 그러면 오브젝트의 YAML 표현과 동일한 데이터가 포함된 JSON이 생성됩니다.
JsonUtility 및 EditorJsonUtility는 Unity Serialization 규칙을 사용하여 JSON 문자열 포맷으로부터 오브젝트를 직렬화하는 유틸리티 클래스입니다. 코드를 통해 JSON 데이터를 조작하거나 Unity Serialization 지원하지 않는 데이터 구조를 직렬화해야 하는 경우 일반 용도 .NET JSON 라이브러리를 JsonUtility API 동반자로 사용할 수 있습니다.
Performance
벤치마크 테스트는 일반적인 .NET JSON 솔루션보다 JsonUtility가 훨씬 빠르다는 것을 보여주지만, 이 클래스는 경우에 따라 더 적은 기능을 제공합니다.
가비지 컬렉션(GC)의 메모리 사용량은 최소:
- ToJson은 반환된 문자열에 대해서만 GC 메모리를 할당합니다.
- FromJson은 반환된 오브젝트와 필요한 서브 오브젝트에 대해서만 GC 메모리를 할당합니다. 예를 들어 배열이 포함된 오브젝트를 역직렬화하면 Unity가 배열에 GC 메모리를 할당합니다.
- FromJsonOverwrite는 쓰여진 필드(예: 문자열 및 배열)에 필요한 경우에만 GC 메모리를 할당합니다. 즉, JSON이 덮어쓰는 모든 필드가 값 유형인 경우 Unity GC 메모리를 전혀 할당하지 않습니다.
백그라운드 스레드에서 JsonUtility API 사용할 수 있습니다. 하지만 멀티스레드 코드와 마찬가지로 다른 스레드가 오브젝트를 직렬화하거나 역직렬화하는 동안 한 스레드의 오브젝트에 액세스하거나 변경하지 마십시오.
ToJson()의 출력 제어
ToJson 메서드는 JSON 출력을 깔끔하게 출력합니다. 기본적으로 꺼져 있지만 를 두 번째 파라미터로 전달하여 켜면 됩니다.
true[NonSerialized]알 수 없는 타입과 함께 FromJson() 사용
오브젝트의 타입을 미리 알지 못하는 경우 JSON을 "공통" 필드가 포함된 클래스나 구조체로 역직렬화한 다음 해당 필드의 값을 사용하여 원하는 실제 타입을 결정합니다. 그런 다음 이 타입으로 다시 역직렬화합니다