콘텐츠 라이브러리

콘텐츠 라이브러리는 댄스XR가 콘텐츠를 찾고 사용자가 만든 설정을 저장하는 폴더입니다.

콘텐츠 라이브러리 찾기

Windows: Windows에서는 시스템 메뉴(왼쪽 하단의 기어 아이콘)의 “콘텐츠 라이브러리” 섹션에서 “탐색기에서 표시” 항목을 클릭하여 콘텐츠 라이브러리를 찾을 수 있습니다.

Android: 2024.3 업데이트 이후, 콘텐츠 폴더는 저장소의 /DanceXR/에 위치합니다. 이전 버전을 사용 중이라면, /Android/data/com.vrstormlab.dancexr/files/에 위치합니다.

iPhone 및 iPad: 파일 앱의 “내 iPhone” 또는 “내 iPad” 섹션에서 콘텐츠 라이브러리를 찾을 수 있습니다. 댄스XR는 기기의 루트 디렉토리에 “DanceXR”이라는 폴더를 생성합니다.

Oculus Quest: 2024.3 이후에는 저장소의 /DanceXR/에 콘텐츠 라이브러리가 위치하며, 이전 버전에서는 /Android/data/com.vrstormlab.dancexr/files/에 위치합니다. Android 버전과 유사합니다.

폴더 구조

댄스XR는 콘텐츠 라이브러리 내에 위치한 서로 다른 하위 폴더에서 다양한 유형의 콘텐츠를 검색합니다.

• actors: 캐릭터 모델
• motion: 모션 및 오디오 파일
• stages: 무대용 3D 모델
• accessory: 캐릭터 신체 부위에 부착할 수 있는 3D 모델입니다.
• props: 가구와 같은 무대 소품으로 사용할 수 있는 3D 모델
• texture
  • cookie: 빛 마스크용 텍스처
  • drawing: 바디 페인트 기능을 위한 저장된 이미지
  • ground: 지면 텍스처 지면 설정
  • mask: 모델에 적용할 수 있는 상세 및 노멀 맵
  • particle: 파티클 효과용 텍스처
  • sky: 파노라마 하늘 맵, HDR 형식 사용 권장
• settings: 모든 저장된 설정입니다. 이 파일들은 사용자가 수정하도록 만들어진 것이 아니지만, 원한다면 백업을 복사하여 보관할 수 있습니다.
• scenes: 저장된 씬 파일.
• bundles: 필요한 모든 에셋과 함께 저장된 씬을 포함한 zip 패키지입니다.
• export: 3D 스냅샷 기능을 사용할 때 내보낸 모델 파일을 여기서 찾을 수 있습니다.
• presets: 저장된 프리셋 파일입니다. 댄스XR의 동일한 버전을 사용하는 한 친구들과 이 파일을 공유할 수 있습니다.
• videos: 프로젝션 및 다이나믹 텍스처 맵에 사용할 수 있는 비디오입니다. MP4 형식만 지원합니다.
• chat: AI 채팅 시스템에 사용되는 파일입니다.
  • characters: 캐릭터 썸네일 및 템플릿. 이들은 자동으로 생성되지만, 수정할 수 있습니다.
  • templates: 프롬프트 템플릿으로, 수정하거나 새로 만들 수 있습니다.
  • history: 저장된 채팅 기록
  • persona: 캐릭터에 적용할 수 있는 성격 설명
  • voices/piper/: TTS 시스템용 사용자 정의 음성 모델

지원되는 형식

• 3D 모델: PMX, XPS, FBX (미리 보기 — 2025.9 이후, 모델 전용), 그리고 OBJ (무대 소품용)
• 오디오: OGG 및 MP3 (모바일 플랫폼 전용)
• 비디오: MP4
• 모션: VMD, BVH
• 텍스처: PNG, JPG, 그리고 HDR (하늘 맵용)

그룹화 및 구성

데이터 파일을 더 쉽게 관리하기 위해, 특히 여러 파일이 함께 작동해야 하는 콘텐츠의 경우, 파일을 구성하기 위해 zip 패키지 사용을 지원합니다. 필요한 모든 파일을 하위 폴더에 보관하는 것도 동일하게 작동합니다.

종속 파일

3D 모델은 일반적으로 여러 파일로 구성됩니다. 하나의 파일은 메쉬를 설명하고, 여러 외부 파일은 텍스처 및 재료를 설명합니다. 모델을 로드할 때 정확하게 검색될 수 있도록 텍스처가 메쉬 파일에 대해 원래 위치를 유지하는지 확인하십시오.

PMX의 경우, 메쉬 파일은 .pmx 파일입니다. XPS의 경우, 메쉬 파일은 .xps, .mesh, 또는 .mesh.ascii일 수 있습니다. FBX (미리 보기, 2025.9 이후)의 경우, 메쉬 파일은 .fbx입니다. 댄스XR는 현재 모델 자체는 로드하지만, 내장된 애니메이션이나 기타 FBX 기능은 로드하지 않습니다. FBX 및 XPS 모델 모두 모션이 올바르게 재생되려면 본 매핑이 필요합니다.

더 작은 파일 크기와 쉬운 관리를 위해 하나의 모델에 대한 모든 파일을 zip 패키지에 보관하는 것이 좋습니다.

일부 XPS 모델에는 대체 텍스처가 있습니다. 댄스XR는 모델에 사용된 텍스처와 유사한 텍스처 파일을 찾기 위해 폴더나 zip 패키지를 검색하고 자동으로 메뉴에 포함하여 선택할 수 있도록 합니다. 이 기능을 사용하려면 대체 텍스처가 주 텍스처와 동일한 파일 이름을 가져야 합니다. 예를 들어, 베이스 맵이 base.png로 이름이 지정된 경우, 댄스XR가 다른 하위 폴더에서 base.png를 찾으면 자동으로 대체 텍스처로 추가합니다. 모델이 zip 패키지에 있는 경우, 댄스XR는 대체 텍스처를 위해 전체 zip 패키지를 검색합니다. 모델이 하위 폴더에 있는 경우, 메쉬 파일이 위치한 모든 하위 폴더를 검색합니다. 이 점을 유념하십시오. 대체 텍스처를 메쉬 파일 폴더 외부에 배치하면 인식되지 않을 수 있습니다.

모션 파일

일반적으로 모션 데이터에는 오디오 파일, 캐릭터 모션, 카메라 모션이 포함됩니다. 댄스XR에서는 오디오, 캐릭터 모션, 카메라 모션의 묶음을 “댄스 세트”라고 부릅니다.

댄스XR가 댄스 세트를 감지하도록 하려면, 이 모든 파일을 하위 폴더 또는 zip 패키지 내에 보관하기만 하면 됩니다. 하지만 그 안에는 오디오 파일이 오직 하나만 있어야 합니다.

모션/오디오 쌍만 있는 간단한 콘텐츠의 경우, 하나의 폴더에 여러 개를 가질 수 있지만, 오디오 파일과 모션 파일은 동일한 이름을 가져야 합니다. 예를 들어, “dance.vmd”와 “dance.ogg”와 같습니다. 이렇게 하면 댄스XR가 그것들이 쌍임을 알고 댄스 세트를 만들 수 있습니다.

또한 동일한 폴더에 관련 없는 여러 모션 또는 오디오 파일을 가질 수도 있습니다. 이들은 다른 파일과 관련이 없는 개별 모션 또는 오디오 파일로 인식됩니다.

즐겨찾기, 최근 항목 및 태그 시스템

모델과 모션의 경우, 즐겨찾기 표시를 하고 태그를 추가할 수 있습니다.

즐겨찾기 항목은 즐겨찾기 목록에 나타나며, 태그를 사용하여 필터 결과에서 검색 범위를 좁힐 수 있습니다.

최근 항목 목록은 빠른 액세스를 위해 최근에 사용된 항목을 추적합니다.

이 기능들을 사용하면 필요한 항목을 쉽게 찾을 수 있습니다. 모델의 경우 액터 메뉴의 도구 섹션에서, 모션의 경우 오디오/모션 메뉴에서 액세스할 수 있습니다.

콘텐츠 라이브러리 도구

콘텐츠 라이브러리 파일을 수정한 후, 댄스XR은 실행 시 변경 사항을 자동으로 감지하고 콘텐츠를 다시 스캔해야 합니다.

하지만 그렇게 되지 않거나 실행 중 파일을 이동했을 경우, 시스템 메뉴의 콘텐츠 라이브러리 도구를 사용하여 수동으로 새로 고칠 수 있습니다.

“라이브러리 변경” 옵션을 사용하여 다른 위치를 지정할 수도 있습니다.

Google 드라이브 통합

댄스XR에서 Google 드라이브에서 파일을 다운로드할 수 있습니다. 드라이브 폴더가 제한 없이 공유된 경우에 한합니다. 공유 폴더의 URL을 입력하면 댄스XR가 드라이브 폴더를 스캔하고 로컬에 존재하지 않는 파일을 다운로드할 수 있습니다.

Android 및 Oculus Quest용 콘텐츠 준비

Android 시스템은 엄격한 파일 액세스 규칙을 가지고 있습니다. 일반적으로 앱은 저장소 내의 폴더에 액세스할 수 없습니다. 따라서 기본적으로 Android 및 Quest 버전의 콘텐츠 라이브러리는 앱 저장 공간 내에 위치하며, 파일을 복사하려면 PC가 필요합니다.

2024.3 버전부터는 파일 관리를 조금 더 쉽게 하기 위해 저장소 권한을 사용하고 있습니다. 이를 위해 댄스XR에 저장소 액세스 권한을 부여해야 하며, 그 후 시스템 파일 앱을 사용하여 파일을 이동하고 복사할 수 있습니다.

이전 버전이나 앱 내부 저장 공간을 사용하려는 경우, 콘텐츠 라이브러리는 여기에 위치합니다: /Android/data/com.vrstormlab.dancexr/files/.

데모 비디오

PC에서:

Android에서 콘텐츠 관리자 사용하기

Quest에서 콘텐츠 로드하기

관련 페이지

• 액터 사용하기 — 라이브러리에 모델이 들어간 후 해야 할 일
• 모션 시스템 — 댄스 세트 및 모션 구성 방법
• 개념 및 용어집 — 프리셋, 씬, 씬 번들, 댄스 세트의 정의
• Google 드라이브 통합
• Android 및 Quest의 콘텐츠 라이브러리