Inventory(GS2 UIKit for Unity) 샘플

GS2 UIKit for Unity를 사용한 GS2-Inventory 기능 구현 샘플 소개

인벤토리 기능을 구현합니다.

리포지토리

https://github.com/gs2io/gs2-uikit-for-unity-sample/tree/main/Inventory

GS2-Deploy 템플릿

https://github.com/gs2io/gs2-uikit-for-unity-sample/blob/main/Inventory/initialize_inventory_template.yaml

프로젝트 내용

프로젝트를 열면 위와 같은 화면이 됩니다.

실행하면 오른쪽 위에 인벤토리 용량 사용 현황이 표시되고, 하단에 인벤토리 조작 버튼이 표시됩니다.

“Acquire Potion"을 클릭합니다.

그러면 포션을 10개 입수할 수 있으며, 화면 상단에 포션이 표시됩니다. 마찬가지로, 다음은 에테르를 입수하기 위해 “Acquire Ether"를 클릭합니다.

포션 옆에 에테르가 추가됩니다. 참고로, 오른쪽 위의 인벤토리 사용량도 2/10 이 되어 있습니다.

다음으로, 포션의 최대 스택 수는 99개 로 설정되어 있으므로 “Acquire Potion"을 9번 더 클릭하여 100개를 가지고 있는 상태로 만들어 봅니다.

이처럼 포션이 2개의 스택으로 나뉘고, 인벤토리 사용량도 3/10 이 되었습니다.

포션이나 에테르의 아이콘을 클릭하면 아이템을 소비할 수 있습니다. 99개 스택되어 있는 포션을 클릭해 봅시다.

아이템은 스택을 명시적으로 지정하여 소비할 수 있으며, 이 경우 채워 넣는 처리는 이루어지지 않으므로 98개 스택된 포션과 1개 스택된 포션이 됩니다.

다음은 1개 스택되어 있는 포션을 클릭해 봅니다.

이처럼 스택의 총 수가 2개가 되고, 인벤토리 소비량도 2/10 이 되었습니다.

프로젝트 해설

씬의 계층 구조에 주목해 주세요.

Canvas/InventoryWindow

Gs2InventoryOwnInventoryContext

이 GameObject 이하의 노드에서 다루는 GS2-Inventory 의 인벤토리(스탠다드)를 지정하고 있습니다.

이번에는 GS2-Inventory 의 inventory-0001 이라는 네임스페이스의 Bag 이라는 인벤토리를 지정하고 있습니다.

Canvas/InventoryWindow/Capacity

Gs2InventoryInventoryEnabler

Gs2InventoryOwnInventoryContext 에서 지정한 인벤토리의 로드가 끝나면 InventoryCapacityText GameObject 가 활성화됩니다.

Canvas/InventoryWindow/Capacity/InventoryCapacityText

Gs2InventoryInventoryLabel

현재 인벤토리 사용량/현재 인벤토리 최대량 을 Format 에 지정하고 있습니다. 정형된 텍스트는 OnUpdate(String) 로 콜백되어, 거기서부터 Text 컴포넌트에 값을 반영합니다.

Canvas/InventoryWindow/Inventory/…/Content

Gs2InventoryOwnItemSetListFetcher

Gs2InventoryOwnInventoryContext 에서 지정된 네임스페이스의 아이템 목록을 가져옵니다.

Gs2InventoryOwnItemSetList

Gs2InventoryOwnItemSetListFetcher 로 가져온 아이템을 지정된 프리팹에 할당하여 생성합니다. Maximum Items 에는 프리팹을 생성할 최대 수를 지정합니다.

이번에는 자식 노드에 있는 Item 을 프리팹으로 지정하고 있습니다. 프리팹으로 지정된 GameObject 가 씬 안에 있는 경우, 해당 GameObject 는 비활성화되고, 그 외에 Maximum Items 로 지정된 수만큼 GameObject 가 생성됩니다.

Canvas/InventoryWindow/Inventory/…/Content/Item

Gs2InventoryOwnItemSetContext

이 GameObject 이하의 노드에서 다루는 아이템을 지정하고 있습니다. 컨텍스트의 내용은 Gs2InventoryOwnItemSetList 에 의해 할당됩니다.

Gs2InventoryItemModelFetcher

Gs2InventoryOwnItemSetContext 에서 지정된 아이템 모델을 가져옵니다.

Gs2InventoryOwnItemSetFetcher

Gs2InventoryOwnItemSetContext 에서 지정된 아이템을 가져옵니다.

Canvas/InventoryWindow/Inventory/…/Content/Item/Icon

Gs2InventoryItemModelNameEnabler

할당된 아이템 모델의 이름에 따라 활성화할 GameObject 를 전환합니다. Potion 인 경우에는 PotionImage 를 활성화하고, Ether 인 경우에는 EnterImage 를 활성화합니다. 그 결과, 목록에 표시되는 아이템의 종류에 따라 아이템 아이콘이 바뀝니다.