Network Collection - cheona-thousand-man/Unity-myBasics-Wiki GitHub Wiki

// 기본 네트워크 컬렉션 선언
[Networked, Capacity(4)]
NetworkArray<int> NetArray => default;

[Networked]
[Capacity(4)] // 컬렉션의 고정 용량 설정
NetworkArray<int> NetArray { get; }
  // 선택적 초기화
  = MakeInitializer(new int[] { 0, 1, 2, 3 });

[Networked, Capacity(4)]
NetworkLinkedList<int> NetLList { get; }
  // 선택적 초기화
  = MakeInitializer(new int[] { 0, 1, 2, 3 });

[Networked, Capacity(2)]
NetworkDictionary<int, int> NetDict { get; }
  // 선택적 초기화
  = MakeInitializer(new Dictionary<int, int> { { 0, 0 }, { 1, 1 } });

public class CollectionTestsArray : NetworkBehaviour
{
  [Networked]
  [Capacity(4)] // 컬렉션의 고정 용량 설정
  NetworkArray<NetworkString<_32>> NetArray { get; } =
    MakeInitializer(new NetworkString<_32>[] { "#0", "#1", "#2", "#3" });

  public override void FixedUpdateNetwork()
  {
    NetArray.Set(0, "Zero");
    NetArray.Set(1, "One");
    NetArray.Set(2, "Two");

    // NetworkDictionary 속성에서는 유효하지 않으므로 Set()을 사용해야 합니다.
    // NetArray[3] = "Three";

    NetArray.Set(0, NetArray[0].ToUpper());
    NetArray.Set(1, NetArray.Get(1).ToLower());
    NetArray.Set(2, default);

    for (int i = 0; i < NetArray.Length; ++i)
    {
      Debug.Log($"{i}: '{NetArray[i]}''");
    }
  }
}

public class NetworkDictionaryExample : NetworkBehaviour
{
  [Networked]
  [Capacity(4)] // 컬렉션의 고정 용량 설정
  [UnitySerializeField] // 인스펙터에 이 private 속성을 표시합니다.
  private NetworkDictionary<int, NetworkString<_32>> NetDict => default;

  public override void FixedUpdateNetwork()
  {
    NetDict.Clear();
    NetDict.Add(0, "Zero");
    NetDict.Add(2, "Two");
    NetDict.Add(5, "Five");

    // 인덱서로 값을 설정하는 것은 유효하지 않습니다.
    // 이것이 struct 기반 NetworkDictionary와 C# Dictionary 사용법의 차이점 중 하나입니다.
    // NetDict[0] = "Foo"; // 이는 유효하지 않습니다.

    if (NetDict.ContainsKey(0))
    {
      NetDict.Set(0, NetDict[0].ToUpper());
    }

    if (NetDict.TryGet(5, out var value))
    {
      NetDict.Set(5, value.ToLower());
    }

    NetDict.Remove(2);

    foreach(var kvp in NetDict)
    {
      Debug.Log($"{NetDict.Count}/{NetDict.Capacity} Key:{kvp.Key} Value:{kvp.Value}");
    }
  }
}

public class NetworkLinkedListExample : NetworkBehaviour
{
  [Networked]
  [Capacity(4)] // 컬렉션의 고정 용량 설정
  [UnitySerializeField] // 인스펙터에 이 private 속성을 표시합니다.
  private NetworkLinkedList<NetworkString<_32>> NetList { get; }
    = MakeInitializer(new NetworkString<_32>[] { "Zero", "One", "Two", "Four"});

  public override void Spawned()
  {
    // 두 번째 항목을 제거하여 하나의 빈 용량을 남깁니다.
    NetList.Remove("One");

    // 값으로 항목 찾기
    NetList.Set(NetList.IndexOf("Two"), "TWO");

    // 새 항목 추가. 메모리에서는 이제 열린 메모리 위치를 채웁니다.
    NetList.Add("Five");

    // 인덱스 순서는 그대로 유지되므로,
    // 변경된 메모리 위치만 더티 상태가 되어 네트워크로 전송됩니다.
    Debug.Log($"List {NetList.Count}/{NetList.Capacity}" +
      $"0:'{NetList[0]}' 1:'{NetList[1]}' 2:'{NetList[2]} 3:'{NetList[3]}'");
  }
}

## NetworkString<Size>
- NetworkString은 문자열 데이터를 위한 고정 크기 컬렉션
  - 크기는 미리 정의된 IFixedStorage 타입 중 하나일 수 있으며, _X로 명명
  - _32는 uint[32]로 지원되며 최대 32자의 문자열 저장
```C#
public class NetworkStringExample : NetworkBehaviour
{
  [Networked]
  public NetworkString<_16> NetString { get; set; }

  public override void FixedUpdateNetwork()
  {
    if (Runner.IsServer) {
      NetString = System.IO.Path.GetRandomFileName();
    }
  }
}

public class NetworkDictionaryTest : NetworkBehaviour
{
  [System.Serializable]
  struct NetworkStruct : INetworkStruct
  {
    [Networked, Capacity(16)]
    public NetworkDictionary<int, int> NestedDict => default;

    // NetworkString은 일반 구조체이므로 Fusion 속성이 필요 없습니다.
    public NetworkString<_16> NestedString;

    // 필요한 경우 기본 초기화를 속성으로 정의합니다.
    public static NetworkStruct Defaults
    {
      get
      {
        var result = new NetworkStruct();
        result.NestedDict.Add(0, 0);
        result.NestedString = "Initialized";
        return result;
      }
    }
  }

  // 값 타입으로 정상적으로 선언된 속성
  [Networked]
  [UnitySerializeField]
  private NetworkStruct NestedStruct { get; set; } = NetworkStruct.Defaults;

  public void ModifyValues()
  {
    // NestedStruct는 값 타입이므로 수정은 복사본에서 수행하고,
    // 수정된 결과를 속성에 다시 적용해야 합니다.
    var copy = NestedStruct;
    copy.NestedDict.Add(copy.NestedDict.Count, default);
    copy.NestedString = System.IO.Path.GetRandomFileName();
    NestedStruct = copy;
  }
}

public class NetworkDictionaryTest : NetworkBehaviour
{
  [System.Serializable]
  struct NetworkStruct : INetworkStruct
  {
    [Networked, Capacity(16)]
    public NetworkDictionary<int, int> NestedDict => default;

    // NetworkString은 일반 구조체이므로 Fusion 속성이 필요 없습니다.
    public NetworkString<_16> NestedString;

    public static NetworkStruct Defaults
    {
      get
      {
        var result = new NetworkStruct();
        result.NestedDict.Add(0, 0);
        result.NestedString = "Initialized";
        return result;
      }
    }
  }

  // 참조 타입으로 선언된 속성, 값의 직접 수정 가능
  [Networked]
  [UnitySerializeField]
  private ref NetworkStruct NestedStruct => ref MakeRef(NetworkStruct.Defaults);

  public void ModifyValues()
  {
    // NestedStruct는 위에서 참조로 선언되었으므로,
    // 복사본 없이 참조를 직접 수정할 수 있습니다.
    NestedStruct.NestedDict.Add(NestedStruct.NestedDict.Count, default);
    NestedStruct.NestedString = System.IO.Path.GetRandomFileName();
  }
}