🏃‍♂️Save / Load

0. 해당 글의 내용

• 세팅 된 아바타에 대한 정보를 저장합니다.

  • 어떤 Race인지

    • 남, 여, 엘프 남, 엘프 여 등등

    • 오크 또는 애니컨셉의 사람 등 제작하여 Race로 사용가능 합니다.

  • 몸 상태 값 DNA

  • 장착한 의상 (Wardrobe Recipe)

  • Slot Color

• 저장 형태는 text, asset 등이 있습니다.

  • 저장된 리소스(text, asset)만 가지고 아바타를 표현은 불가능 합니다

  • 기본적으로 프로젝트에 준비된 race / wardrobe / slot 등의 리소스가 있어야 합니다.

• 저장 결과물은 3종류가 있으며 각 최적화된 정도가 다릅니다.

1. Dynamic Character Avater Inspector

• DCA 의 Inspector 창 내에서 save load 해보는 예

• 런타임중 가능하다.

준비 할 Recipe -> 예제에서 가져옴.

일단 입혀본다.

Inspector 에서 Dynamic Character Avatar Load/Save Options

• Load File On Start 체크를 해제 한다.

Load File On Start 체크를 해제 했어야 했다.

Load/Save Options

Editor Play

​

• 아직 저장 한 것이 없기 때문에 취소

• 시작 하자마자 Load saved Avatar 파일 불러오기 탐색기 창이 트리거 된다.

Perform Save

• 에디터 play 를 하면 inspector 내에 버튼이 생성된다.

• Perform Save를 눌러 저장한다.

• 저장 위치를 선택할 탐색기 창이 나오는데 일단 위치 지정해주고 진행.(Save Path는 왜 입력하는지..)

• 파일이 생성 되었다. (확장자는 .txt)

Editor 종료 후 Load/Save Options -> Load File On Start 체크

다시 Editor Play

• Load 되는지 확인 하기 위해, 기본 옷만 입혀놓고 Load 해 보았다.

• 외부 파일로 인식해서 그런지, Editor 시작하자마자 파일 선택하는 탐색기가 트리거 된다.

• 결과적으로는 옷이 잘 Load 되어 입혀진다.

플레이 도중에 옷을 load 해서 입혀보기.

• 이전과 같이 Load File On Start 를 체크 해제 해야 한다.

• Editor Play 후 Inspector / 생성된 Perform Load 버튼 클릭.

• 리소스를 선택하기 위한 탐색기창이 트리거 된다.

• 이전과 같이 리소스 파일을 선택 하면 옷이 입혀진다.

PathType 에 따른 저장 위치

• Resource

  • Assets 내부 위치 Resources static 클래스 폴더 위치가 root

    • Assets/Resources/...

    • Save Path에 아무것도 입력 안하면 root 에 파일이 위치함.

• Persistent Data Path

  • 앱데이터 경

  • Save Path (inspector input path) 내가 입력한 경로.

    • Assets/_UMA-study/SaveLoadRecipe/_PersistentDataPathRecipe

  • 실제 저장 위치

    • C:/Users/yangy/AppData/LocalLow/DefaultCompany/study-normal\Assets/_UMA-study/SaveLoadRecipe/_PersistentDataPathRecipe\savedRecipe.txt

    • C:/Users/yangy/AppData/LocalLow/DefaultCompany/[프로젝트 이름]\

      • 여기까지가 root 위치이다.

• File System

  • 절대적인 경로.

  • 위치 선택하는 탐색기창 나옴.

2. 1번 방식의 코드 예제.

using System.Collections;
using System.Collections.Generic;
using UnityEngine;
using UnityEngine.UI;
using UMA.CharacterSystem;

public class SaveLoadController : MonoBehaviour
{
    public Button saveBtn;
    public Button loadBtn;
    public Button clearBtn;

    public DynamicCharacterAvatar avatar;
    [Space(20)]
    public DynamicCharacterAvatar.savePathTypes savePathType;
    public string savePath;
    public string saveFilename;
    [Space(20)]
    public DynamicCharacterAvatar.loadPathTypes loadPathType;
    public string loadPath;
    public string loadFilename;
    private void OnEnable()
    {
        saveBtn.onClick.AddListener(() =>
        {    
            // saveFilename에 확장자를 넣지 않는다. 자동으로 .txt 부
            avatar.savePathType = savePathType;
            avatar.savePath = savePath;
            avatar.saveFilename = saveFilename;
            avatar.DoSave();
        });

        loadBtn.onClick.AddListener(() =>
        {    
            // loadPathType이 Resource 인 경우에는
            // loadFilename에 확장자를 넣을 경우 매치가 되지 않았다.
            if(loadPathType == DynamicCharacterAvatar.loadPathTypes.persistentDataPath)
            {
                loadFilename += ".txt";
            }

            avatar.SetLoadFilename(loadFilename, loadPathType);
            avatar.loadPath = loadPath;
            avatar.DoLoad();
        });
    }

}

Resource Data 를 적용시키는 부분

// DynamicCharacterAvatar

public void SetLoadString(string recipeString)
{
    if (_isFirstSettingsBuild)
    {
        loadString = recipeString;
        loadPathType = loadPathTypes.String;
        loadFileOnStart = true;
    }
    else
    {
        LoadFromRecipeString(recipeString);
    }
}

3. Avatar Definition

UMA Example: How to Load and Save a DCA to a string

• 이전 예제에서는 LoadFromRecipeString() 를 통한 recipeString 적용 방법 이었다.

• 아래는 AvatarDefinition string으로 save/load 하는 방식의 예제.

using System.Collections;
using System.Collections.Generic;
using UMA.CharacterSystem;
using UMA;
using UnityEngine;
using UnityEngine.UI;
using System.Runtime.Serialization.Formatters.Binary;

public class SaveAndLoadSample : MonoBehaviour
{
    public DynamicCharacterAvatar Avatar;
    public UMARandomAvatar Randomizer;
    public Button LoadButton;
    public bool useAvatarDefinition;
    public bool useCompressedString;

    public string saveString;
    public string avatarString;
    public string compressedString;
    public int saveStringSize;
    public int avatarStringSize;
    public int compressedStringSize;
    public int asciiStringSize;
    public int binarySize;
    
    public void GenerateANewUMA()
    {
        Randomizer.Randomize(Avatar);
        Avatar.BuildCharacter(false);
    }

    public void SaveUMA()
    {
        avatarString = Avatar.GetAvatarDefinitionString(true);
        saveString = Avatar.GetCurrentRecipe();
        compressedString = Avatar.GetAvatarDefinition(true).ToCompressedString("|");
        asciiStringSize = Avatar.GetAvatarDefinition(true).ToASCIIString().Length;

        binarySize = BinaryDefinition.ToBinary(new BinaryFormatter(), Avatar.GetAvatarDefinition(true)).Length;
        saveStringSize = saveString.Length * 2;
        avatarStringSize = avatarString.Length * 2;
        compressedStringSize = compressedString.Length * 2; // utf-16

        LoadButton.interactable = true;
    }

    public void LoadUMA()
    {
        if (string.IsNullOrEmpty(saveString))
            return; 
        if (useCompressedString)
        {
            AvatarDefinition adf = AvatarDefinition.FromCompressedString(compressedString, '|');
            Avatar.LoadAvatarDefinition(adf);
            Avatar.BuildCharacter(false); // don't restore old DNA...
        }
        else if (useAvatarDefinition)
        {
            Avatar.LoadAvatarDefinition(avatarString);
            Avatar.BuildCharacter(false); // We must not restore the old DNA
        }
        else
        {
            Avatar.LoadFromRecipeString(saveString);
        }
    }
}

Save String

• 아바타의 모든 정보 포함.

• 모든 DNA 속성 포함.

• 타 savedString 들 보다 사이즈가 큼.

Save String

{
  "packedRecipeType": "DynamicCharacterAvatar",
  "name": "UMADynamicCharacterAvatar",
  "race": "HumanFemale",
  "dna": [
    {
      "dnaType": "DynamicUMADna",
      "dnaTypeHash": 1932961400,
      "packedDna": "{\"bDnaAsset\":{\"instanceID\":33790},\"bDnaAssetName\":\"HumanFemaleDNA 1\",\"bDnaSettings\":[{\"name\":\"height\",\"value\":117},{\"name\":\"headSize\",\"value\":128},{\"name\":\"headWidth\",\"value\":139},{\"name\":\"neckThickness\",\"value\":128},{\"name\":\"armLength\",\"value\":128},{\"name\":\"forearmLength\",\"value\":128},{\"name\":\"armWidth\",\"value\":128},{\"name\":\"forearmWidth\",\"value\":128},{\"name\":\"handsSize\",\"value\":128},{\"name\":\"feetSize\",\"value\":128},{\"name\":\"legSeparation\",\"value\":128},{\"name\":\"upperMuscle\",\"value\":128},{\"name\":\"lowerMuscle\",\"value\":128},{\"name\":\"upperWeight\",\"value\":167},{\"name\":\"lowerWeight\",\"value\":160},{\"name\":\"legsSize\",\"value\":129},{\"name\":\"belly\",\"value\":146},{\"name\":\"waist\",\"value\":128},{\"name\":\"gluteusSize\",\"value\":128},{\"name\":\"earsSize\",\"value\":128},{\"name\":\"earsPosition\",\"value\":128},{\"name\":\"earsRotation\",\"value\":128},{\"name\":\"noseSize\",\"value\":141},{\"name\":\"noseCurve\",\"value\":206},{\"name\":\"noseWidth\",\"value\":128},{\"name\":\"noseInclination\",\"value\":166},{\"name\":\"nosePosition\",\"value\":129},{\"name\":\"nosePronounced\",\"value\":160},{\"name\":\"noseFlatten\",\"value\":106},{\"name\":\"chinSize\",\"value\":122},{\"name\":\"chinPronounced\",\"value\":161},{\"name\":\"chinPosition\",\"value\":169},{\"name\":\"mandibleSize\",\"value\":184},{\"name\":\"jawsSize\",\"value\":128},{\"name\":\"jawsPosition\",\"value\":128},{\"name\":\"cheekSize\",\"value\":101},{\"name\":\"cheekPosition\",\"value\":128},{\"name\":\"lowCheekPronounced\",\"value\":99},{\"name\":\"lowCheekPosition\",\"value\":128},{\"name\":\"foreheadSize\",\"value\":128},{\"name\":\"foreheadPosition\",\"value\":128},{\"name\":\"lipsSize\",\"value\":77},{\"name\":\"mouthSize\",\"value\":156},{\"name\":\"eyeRotation\",\"value\":77},{\"name\":\"eyeSize\",\"value\":165},{\"name\":\"breastSize\",\"value\":90},{\"name\":\"breastCleavage\",\"value\":128},{\"name\":\"eyeSpacing\",\"value\":78}]}"
    }
  ],
  "characterColors": [
    {
      "name": "Skin",
      "colors": [
        204, 201, 193, 255, 0, 0, 0, 0, 255, 255, 255, 255, 0, 0, 0, 0, 255,
        255, 255, 255, 16, 0, 0, 62
      ],
      "ShaderParms": [],
      "alwaysUpdate": false
    },
    {
      "name": "Hair",
      "colors": [
        53, 25, 0, 255, 0, 0, 0, 0, 255, 255, 255, 255, 0, 0, 0, 0, 255, 255,
        255, 255, 0, 0, 0, 0
      ],
      "ShaderParms": [],
      "alwaysUpdate": false
    },
    {
      "name": "Eyes",
      "colors": [
        213, 78, 221, 255, 0, 0, 0, 0, 255, 255, 255, 255, 0, 0, 0, 0, 255, 255,
        255, 255, 34, 31, 31, 154
      ],
      "ShaderParms": [],
      "alwaysUpdate": false
    },
    {
      "name": "Lipstick",
      "colors": [
        35, 0, 0, 255, 0, 0, 0, 0, 255, 255, 255, 255, 0, 0, 0, 0, 255, 255,
        255, 255, 0, 0, 0, 0
      ],
      "ShaderParms": [],
      "alwaysUpdate": false
    },
    {
      "name": "Shirt",
      "colors": [
        94, 172, 74, 255, 0, 0, 0, 0, 255, 255, 255, 255, 0, 0, 0, 0, 255, 255,
        255, 255, 0, 0, 0, 0
      ],
      "ShaderParms": [],
      "alwaysUpdate": false
    },
    {
      "name": "Pants",
      "colors": [
        255, 255, 255, 255, 0, 0, 0, 0, 255, 255, 255, 255, 0, 0, 0, 0, 255,
        255, 255, 255, 29, 29, 29, 93
      ],
      "ShaderParms": [],
      "alwaysUpdate": false
    },
    {
      "name": "Pants Accent",
      "colors": [
        236, 211, 109, 255, 0, 0, 0, 0, 255, 255, 255, 255, 0, 0, 0, 0, 255,
        255, 255, 255, 34, 31, 31, 154
      ],
      "ShaderParms": [],
      "alwaysUpdate": false
    }
  ],
  "wardrobeSet": [
    { "slot": "Chest", "recipe": "FemaleTankTop_Recipe" },
    { "slot": "Feet", "recipe": "FemaleTallShoes_White" },
    { "slot": "Hair", "recipe": "FemaleLongHair_Recipe" },
    { "slot": "Legs", "recipe": "FemalePants2" },
    { "slot": "Underwear", "recipe": "FemaleUndies" }
  ],
  "raceAnimatorController": "Locomotion"
}

Avatar String

• Race, Wardrobe, SlotColor, DNA

• 세팅 된 DNA 정보만 포함.

• 기본값 세팅 포함 x

Avatar String

{
  "RaceName": "HumanFemale",
  "Wardrobe": [
    "FemaleTankTop_Recipe",
    "FemaleTallShoes_White",
    "FemaleLongHair_Recipe",
    "FemalePants2",
    "FemaleUndies"
  ],
  "Colors": [
    {
      "name": "Hair",
      "count": 3,
      "channels": [{ "chan": 0, "mCol": 4281669888, "aCol": 0 }]
    },
    {
      "name": "Eyes",
      "count": 3,
      "channels": [
        { "chan": 0, "mCol": 4292169437, "aCol": 0 },
        { "chan": 2, "mCol": 4294967295, "aCol": 2585927455 }
      ]
    },
    {
      "name": "Skin",
      "count": 3,
      "channels": [
        { "chan": 0, "mCol": 4291611330, "aCol": 0 },
        { "chan": 2, "mCol": 4294967295, "aCol": 1041235968 }
      ]
    },
    {
      "name": "Pants1",
      "count": 3,
      "channels": [{ "chan": 0, "mCol": 4281867784, "aCol": 0 }]
    },
    {
      "name": "Pants",
      "count": 3,
      "channels": [{ "chan": 2, "mCol": 4294967295, "aCol": 1562254878 }]
    },
    {
      "name": "Lipstick",
      "count": 3,
      "channels": [{ "chan": 0, "mCol": 4280549376, "aCol": 0 }]
    },
    {
      "name": "Shirt",
      "count": 1,
      "channels": [{ "chan": 0, "mCol": 4284394571, "aCol": 0 }]
    },
    {
      "name": "Pants Accent",
      "count": 3,
      "channels": [
        { "chan": 0, "mCol": 4293710957, "aCol": 0 },
        { "chan": 2, "mCol": 4294967295, "aCol": 2585927455 }
      ]
    },
    {
      "name": "Undies",
      "count": 3,
      "channels": [{ "chan": 0, "mCol": 4293535821, "aCol": 0 }]
    }
  ],
  "Dna": [
    { "Name": "height", "val": 4602 },
    { "Name": "headWidth", "val": 5465 },
    { "Name": "upperWeight", "val": 6568 },
    { "Name": "lowerWeight", "val": 6263 },
    { "Name": "legsSize", "val": 5073 },
    { "Name": "belly", "val": 5734 },
    { "Name": "noseSize", "val": 5541 },
    { "Name": "noseCurve", "val": 8068 },
    { "Name": "noseInclination", "val": 6513 },
    { "Name": "nosePosition", "val": 5055 },
    { "Name": "nosePronounced", "val": 6269 },
    { "Name": "noseFlatten", "val": 4160 },
    { "Name": "chinSize", "val": 4779 },
    { "Name": "chinPronounced", "val": 6299 },
    { "Name": "chinPosition", "val": 6644 },
    { "Name": "mandibleSize", "val": 7208 },
    { "Name": "cheekSize", "val": 3958 },
    { "Name": "lowCheekPronounced", "val": 3888 },
    { "Name": "lipsSize", "val": 3033 },
    { "Name": "mouthSize", "val": 6109 },
    { "Name": "eyeRotation", "val": 3012 },
    { "Name": "eyeSize", "val": 6465 },
    { "Name": "breastSize", "val": 3523 },
    { "Name": "eyeSpacing", "val": 3041 }
  ]
}

Compressed String

• Avatar String보다 압축적

• split 가능한 string 형식. json 이 아님.

  • compressedString으로 제작 시 split 하기위한 기호 세팅해줘야 함.(기본 " \ ")

• 컬러표시 16진수.

• 사이즈가 가장 작음.

Compressed String

AA*|R:HumanFemale|W:FemaleTankTop_Recipe,FemaleTallShoes_White,FemaleLongHair_Recipe,FemalePants2,FemaleUndies,|C:Hair,3=0,FF351900;|C:Eyes,3=0,FFD54EDD;2,FFFFFFFF,9A221F1F;|C:Skin,3=0,FFCCCAC2;2,FFFFFFFF,3E100000;|C:Pants1,3=0,FF381E08;|C:Pants,3=2,FFFFFFFF,5D1E1E1E;|C:Lipstick,3=0,FF240000;|C:Shirt,1=0,FF5EAC4B;|C:Pants Accent,3=0,FFECD46D;2,FFFFFFFF,9A221F1F;|C:Undies,3=0,FFEA284D;|D:height=11FA;headWidth=1559;upperWeight=19A8;lowerWeight=1877;legsSize=13D1;belly=1666;noseSize=15A5;noseCurve=1F84;noseInclination=1971;nosePosition=13BF;nosePronounced=187D;noseFlatten=1040;chinSize=12AB;chinPronounced=189B;chinPosition=19F4;mandibleSize=1C28;cheekSize=F76;lowCheekPronounced=F30;lipsSize=BD9;mouthSize=17DD;eyeRotation=BC4;eyeSize=1941;breastSize=DC3;eyeSpacing=BE1;|

AA*
R:HumanFemale
W:FemaleShirt3,FemaleTallShoes_White,FemaleHair2,FemaleSportPants_Recipe,FemaleUndies,
C:Hair,3=0,FF2D1010;
C:Eyes,3=0,FF46FF1D;2,FFFFFFFF,9A221F1F;
C:Skin,3=0,FFFFE5E6;
C:Pants1,3=0,FF376AB9;
C:Undies,3=2,FFFFFFFF,80BFBFBF;
C:Shirt,3=0,FFFBFBFB;2,FFFFFFFF,85FFFFFF;
C:Pants,3=0,FF1C1A18;
C:Pants Accent,3=0,FFD39E65;2,FFFFFFFF,9A221F1F;
C:Lipstick,3=0,FFFF0000;2,FFFFFFFF,92880000;
C:Shirt1,3=0,FFE43737;
D:height=1726;headWidth=176A;upperWeight=1335;lowerWeight=1651;legsSize=137A;belly=1B5B;noseSize=154C;noseCurve=1D4C;noseInclination=ED8;nosePosition=158B;nosePronounced=FDC;noseFlatten=1111;chinSize=1414;chinPronounced=1D16;chinPosition=160E;mandibleSize=11F8;cheekSize=19A4;lowCheekPronounced=97F;lipsSize=E64;mouthSize=1C5D;eyeRotation=228D;eyeSize=1D8D;breastSize=578;breastCleavage=1E64;eyeSpacing=1B07;

4. Unity Editor 에서 Save / Load

• 런타임 시 적용이 된다.