패키지

전체 팀이나 여러 프로젝트에 대해 애셋 관리를 최적화하기 위해 단일 애셋 또는 애셋 계층 구조를 패키지로 전환하여 여러 체험에 재사용할 수 있습니다. 패키지를 업데이트할 때 본인 또는 본인의 팀원들은 특정 사본의 업데이트를 가장 최신 버전으로 하거나, 체험 전체의 모든 사본을 업데이트하거나, 특정 사본을 자동 업데이트되도록 설정할 수 있습니다. 또한 패키지에는 패키지 크리에이터와 편집자가 패키지 동작을 사용자 지정하는 옵션을 포함할 수 있는 구성 메커니즘이 포함되어 있습니다.

패키지 만들기

데이터 모델의 모든 단일 노드 또는 하위 트리 루트 노드에서 패키지를 만들 수 있습니다.

1. 탐색기 창에서 원하는 개체/노드를 마우스 오른쪽 버튼으로 클릭하고 콘텍스트 메뉴에서 패키지로 전환을 선택합니다.

   

2. 대화상자 창에서 요청되는 세부 정보를 입력합니다. 특히 그룹에서 작업하는 경우, 소유권을 그룹 체험에 대한 제작/편집 권한이 있는 원하는 그룹으로 설정합니다.

   애셋 시스템에서는 소유권 이전이 지원되지 않으므로 패키지를 만들 때 소유자를 신중하게 생각해야 합니다.

3. 제출 버튼을 클릭합니다.

4. 완료하고 나면 개체의 아이콘 위에 '사슬 모양' 기호가 표시되어 패키지임을 나타냅니다. 또한 새로운 PackageLink 개체가 해당 개체의 부모로 표시됩니다.

패키지 삽입

현재 플레이스에 이미 존재하지 않는 패키지를 삽입하려면 아래 지침에 따라 도구 상자에서 처음으로 삽입해야 합니다.

• 인벤토리에서 → 내 패키지의 경우 본인이 게시했거나 크리에이터 마켓플레이스에서 획득한 패키지를 삽입하는 방법입니다.
• 작품에서 → 그룹 패키지의 경우 본인 그룹의 회원들이(본인 포함) 게시한 패키지를 삽입하는 방법입니다.

플레이스의 데이터 모델에 패키지를 삽입하고 나면 애셋 관리자의 패키지 폴더에 표시되며 나중에 이 패키지의 모든 사본을 삭제해도 여기에 계속 남아 있습니다. 하지만 이 플레이스를 게시하면 폴더가 업데이트되어 플레이스 내에서 사용되는 패키지만 보여줍니다.

패키지 수정

패키지와 해당 자식은 다른 개체와 마찬가지로 편집할 수 있습니다. 패키지 인스턴스를 처음 편집할 때는 경고 대화상자가 나타나 수정된 패키지는 어떤 방법으로도 업데이트할 수 없으며 일련의 편집 내용을 실행 취소하려면 되돌리기를 하셔야 한다는 내용을 미리 알려줍니다.

다음과 같은 변경 사항은 패키지 수정으로 간주되지 않지만 대부분의 편집은 수정된 것으로 패키지에 플래그가 지정됩니다.

수정하고 나면 게시되지 않은 변경 사항이 있는 패키지는 탐색기 계층 구조에서 노란색 점이 표시됩니다.

구성 추가 또는 업데이트

패키지 루트에서 인스턴스 속성을 포함하여 동작(예: 패키지 차량의 최대 속도 또는 패키지 버튼의 디바운스 시간)을 사용자 지정할 수 있습니다.

패키지를 게시하면 현재의 속성/값 세트가 패키지의 기본 구성이 됩니다. 주어진 모든 패키지 사본에서 구성은 굵은 기울임꼴로 표시되며 해당 속성 값은 인스턴스별로 변경할 수 있습니다. 패키지 사본이 업데이트되면 수정된 구성 값이 유지되는 반면 다른 속성은 최신 기본값으로 업데이트됩니다.

중첩 패키지

복잡한 계층을 유지하면서 공동 작업할 수 있도록 패키지를 다른 패키지 안의 하위 계층에 포함할 수 있습니다. 예를 들어, 일련의 차량 구성 요소는 차량의 부모 패키지와 별도로 수정할 수 있어요.

패키지 스크립트

수정되지 않은 패키지 안의 각 스크립트는 읽기 전용이며 상단에 이 스크립트를 잠금 해제할 수 있는 하이퍼링크가 포함된 알림이 표시됩니다.

하이퍼링크를 클릭할 경우

• 스크립트를 편집하셨는지 여부에 상관없이 패키지가 수정된 것으로 플래그 표시됩니다.
• 패키지 내의 다른 스크립트에서 이 알림/하이퍼링크가 제거됩니다.

패키지가 게시되고 수정되지 않은 상태로 이동하면 이 패키지 아래의 스크립트는 읽기 전용이 되고 수정을 위한 하이퍼링크가 제공됩니다.

패키지 변경 사항 게시

수정된 패키지를(노란색 점이 표시됨) 게시하여 모든 체험과 플레이스 전체에서 패키지의 다른 사본에도 이러한 수정 사항을 제공할 수 있습니다. 플레이스를 게시하기 전에 수정된 패키지를 반드시 게시해야 하는 것은 아닙니다(수정된 버전은 나중에 반복할 수 있도록 플레이스와 함께 저장됩니다).

변경 사항을 패키지에 게시하려면 다음과 같이 해보세요.

1. 탐색기 창에서 수정된 사본을(노란색 점이 표시됨) 마우스 오른쪽 버튼으로 클릭하고 패키지에 게시를 선택합니다.

   

2. 자동으로 업데이트하도록 설정된 패키지 사본의 경우, Studio가 즉시 업데이트된 버전을 가져옵니다. 다른 사본의 경우 이름 옆에 초록색 동기화 아이콘이 표시되며 필요에 따라 개별적으로 업데이트하거나 전체 업데이트를 할 수 있습니다.

   

오래된 사본 업데이트

오래된 패키지 사본은 가장 최신 버전으로 업데이트할 수 있고, 계속해서 기존 버전으로 사용하실 수도 있습니다.

한 개 이상의 패키지 사본을 최신 버전으로 업데이트하려면 다음과 같이 해보세요.

1. 탐색기 창에서 이름 옆의 초록색 동기화 아이콘으로 오래된 사본을 찾습니다.

   

2. 한 개의 오래된 사본을 마우스 오른쪽 버튼으로 클릭하고 컨텍스트 메뉴에서 최신 패키지 가져오기를 선택하거나, 여러 사본을(이 중 한 개 이상은 수정됨) 선택하고 마우스 오른쪽 버튼으로 클릭한 다음 선택된 패키지의 최신 버전 가져오기를 선택합니다.

전체 업데이트

패키지가 방대하게 사용되면 체험의 여러 플레이스에 많은 패키지 사본이 생깁니다. 개별적 동기화와 자동 업데이트 이외에도 전체 업데이트를 통해 패키지의 모든 사본을 업데이트할 수 있습니다.

1. (권장 사항) 체험의 플레이스가 하나라도 열려 있는 다른 Studio 인스턴스는 닫는 것이 좋습니다. 이렇게 하면 플레이스의 저장되지 않은 다른 인스턴스가 본인의 업데이트를 덮어쓸 위험을 방지할 수 있습니다.

2. 탐색기 창에서 원하는 패키지를 마우스 오른쪽 버튼으로 클릭하고 컨텍스트 메뉴에서 모두 업데이트를 선택합니다.

   

3. 버전/날짜 세부 정보 아래의 팝업 창에서 전체 업데이트를 체험의 모든 플레이스에 적용하려면 모두에, 특정 플레이스에만 적용하려면 해당 플레이스에 선택 표시합니다.

   

4. 업데이트 버튼을 클릭합니다.

자동 업데이트

보다 간편한 동기화를 위해 새로운 버전이 게시될 때마다 열려 있는 Studio 세션에 이 버전이 존재하는 경우 패키지 사본이 자동으로 업데이트되도록 설정하실 수 있습니다.

1. 탐색기 창에서 패키지의 계층 트리를 확장하고 PackageLink 개체를 선택합니다.

   

2. 속성 창에서 AutoUpdate 속성을 활성화합니다. 이 속성은 하위 계층에 포함한 패키지의 계층 구조에서 최상위 레벨의 부모 패키지에만 적용됩니다. 즉, 부모 패키지가 업데이트될 때만 자동 업데이트가 실행되는 것입니다.

   

공유 및 액세스 수준

원하는 경우, 친구들과 패키지를 공유하거나 그룹 내 특정 사용자 역할에 액세스 권한을 부여할 수 있습니다.

1. 탐색기, 도구 상자 또는 애셋 관리자에서 원하는 패키지를 마우스 오른쪽 버튼으로 클릭하고 컨텍스트 메뉴에서 패키지 세부 정보를 선택합니다.

2. 팝업 창에서 왼쪽 열의 권한을 선택하여 그룹 보유 또는 사용자 보유 패키지에 대한 공유/이용 옵션을 표시합니다.

   • 그룹 보유 패키지의 경우, 그룹 아이콘 옆의 › 기호를 클릭하여 역할 트리를 확장한 다음 각 역할에 대한 권한 수준을 선택합니다. 선택 상자가 흐리거나 비활성화된 것은 해당 역할에 대해 권한이 이미 구성되어 있고 이 창에서 변경할 수 없음을 의미합니다.

     

     권한	설명
     편집	해당 역할의 회원들이 변경 사항을 게시하는 권한을 포함하여 현재 및 이전 버전의 패키지를 사용하고, 보고, 편집할 권한이 있습니다. 이 창에서 역할에 편집 권한을 부여하는 것은 특정 패키지에 대한 권한만 부여하는 것입니다.
     권한 없음	역할의 회원들이 현재 및 이전 버전에 대한 권한은 유지하지만 패키지의 새 버전에는 액세스할 권한이 없습니다.

   • 사용자 보유 패키지의 경우, 검색 필드를 통해 친구를 검색하고 친구의 아바타/사용자 이름을 클릭한 다음 권한 수준을 선택합니다.

     

     권한	설명
     사용 및 보기	사용자가 현재 및 이전 버전의 패키지를 사용하고 볼 수 있습니다(편집할 수는 없음). 사용자에게 이 권한을 제공하고 나면 사용자가 이미 자신의 체험에 삽입한 사본에 대해 액세스를 취소할 수 없습니다. 액세스를 취소할 경우 재삽입이나 패키지 업데이트가 차단되지만, 이들의 데이터 모델에 있는 패키지 사본은 그대로 유지됩니다.
     편집	사용자가 변경 사항을 게시하는 것을 포함하여 현재 및 이전 버전의 패키지를 사용하고, 보고, 편집할 수 있습니다.

패키지 변경 사항 되돌리기

일련의 전체 패키지 변경 사항을 하나씩 실행 취소하는 대신 한 번의 작업으로 게시되지 않은 변경 사항을 되돌리거나 패키지를 이전 버전으로 복원하거나 변경 사항을 특정 구성으로 되돌릴 수 있습니다.

미개시된 변경 되돌리기

일련의 게시되지 않은 변경 사항을 실행 취소하려면,

1. 탐색기 창에서 이름 옆의 노란색 점으로 수정된 사본을 찾습니다

   

2. 한 개의 수정된 사본을 마우스 오른쪽 버튼으로 클릭하고 컨텍스트 메뉴에서 패키지 변경 실행 취소를 선택하거나, 여러 사본을(이 중 한 개 이상은 수정됨) 마우스 오른쪽 버튼으로 클릭한 다음 선택된 패키지의 변경 실행 취소를 선택합니다.

   

버전 복구

패키지를 이전에 게시한 버전으로 복구하려면 다음과 같이 해보세요.

1. 탐색기, 도구 상자 또는 애셋 관리자에서 원하는 패키지를 마우스 오른쪽 버튼으로 클릭하고 컨텍스트 메뉴에서 패키지 세부 정보를 선택합니다.

2. 팝업 창에서 왼쪽 열의 버전을 선택합니다. 현재 게시된 버전과 이전에 게시된 여러 버전이 게시 날짜/시간과 함께 나타납니다(V1, V2, …).

3. 복구하려는 버전 옆의 선택 표시를 클릭하고 제출을 클릭합니다.

   

구성 되돌리기

구성 속성을 기본값으로 되돌리려면 속성 창의 특성 섹션에 있는 기어 메뉴에서 재설정 옵션을 선택합니다.

스크립트 변경 사항 비교

패키지 개체에 스크립트가 포함되어 있거나 스크립트 자체가 패키지인 경우, 내장된 Diff 도구를 사용하여 행별로 차이를 비교할 수 있습니다. 이렇게 비교하면 업데이트할지 결정하는 데는 물론이고 최신 버전으로 업데이트하기 위해 체험에서 또 어떤 것이 필요한지 탐색하는 데 도움이 됩니다.

스크립트 변경 사항을 비교하려면 다음과 같이 해보세요.

1. 탐색기 창에서 수정된 또는 오래된 패키지를 마우스 오른쪽 버튼으로 클릭합니다. 이때 패키지는 스크립트이거나 스크립트를 포함해야 한다는 사실을 꼭 기억하세요.

2. 콘텍스트 메뉴에서 스크립트 변경 사항 보기를 선택합니다.

   

3. Diff 결과 탭이 열리면 현재 패키지 사본과 가장 최근에 게시된 버전이나 로컬 버전 간에 모든 변경 사항을 비교합니다. 이는 소스 제어 애플리케이션과 비슷합니다.

   

   이 비교 예시에서는 1행의 print() 명령이 수정되었습니다. 빨간색으로 강조 표시된 행은 1행이 오래된 스크립트 사본으로 존재함을 보여주고, 그 바로 밑의 초록색 행은 1행이 게시된 스크립트 패키지에 존재함을 보여줍니다. 또한 게시된 스크립트 패키지에 두 개 행이 새로 추가되었습니다. 2행에는 빈 브레이크, 3행에는 새로운 print() 명령이 추가되었습니다.