Version: Unity 6.0 (6000.0)
언어 : 한국어
타겟 플랫폼용 빌드 경로 요구 사항
빌드 파일 크기 축소

스트리밍 에셋

Unity는 프로젝트를 빌드할 때 생성된 플레이어 내에서 씬과 에셋을 바이너리 파일로 결합합니다. 그러나 파일을 타겟 컴퓨터의 일반 파일 시스템에 배치하여 경로명을 통해 사용하도록 만들 수 있습니다. 예를 들어, iOS 기기에서 동영상 파일을 배포하려면 PlayMovie 함수를 사용하여 파일 시스템의 한 위치에서 원본 동영상 파일을 재생할 수 있어야 합니다. 이 폴더에는 요청 시 다운로드하지 않고 플레이어 설치로 직접 배포할 AssetBundles도 포함될 수 있습니다.

Unity는 Unity 프로젝트의 StreamingAssets(대소문자 구분) 폴더에 있는 모든 파일을 타겟 컴퓨터의 특정 폴더로 복사합니다. 폴더를 검색하려면 Application.streamingAssetsPath 프로퍼티를 사용하십시오. 애플리케이션이 실행 중인 플랫폼의 올바른 위치를 가리키기 때문에 항상 Application.streamingAssetsPath를 사용하여 StreamingAssets 폴더의 위치를 가져오는 것이 좋습니다.

Application.streamingAssetsPath가 반환하는 위치는 플랫폼에 따라 다릅니다.

  • 대부분의 플랫폼(Unity 에디터, Windows, Linux 플레이어)은 Application.dataPath + "/StreamingAssets"를 사용합니다.
  • macOS 플레이어는 Application.dataPath + "/Resources/Data/StreamingAssets"를 사용합니다.
  • iOS는 Application.dataPath + "/Raw"를 사용합니다.
  • Android는 압축된__ APK__Unity에서 출력한 Android 패키지 포맷입니다. File > Build & Run을 선택하면 APK가 기기에 자동으로 배포됩니다. 자세한 정보
    See in Glossary
    /JAR 파일의 안에 있는 파일인 "jar:file://" + Application.dataPath + "!/assets"를 사용합니다.
  • 웹에서 Application.streamingAssetsPath는 웹 서버의 StreamingAssets/ 경로를 가리키는 HTTP URL을 반환합니다. 예를 들어 애플리케이션이 로컬 개발 서버에서 실행 중일 때 http://localhost:8000/unity_webgl_build/StreamingAssets/가 반환됩니다.

스트리밍 에셋에 액세스

Android 및 웹 플랫폼에서는 이러한 플랫폼이 URL을 반환하기 때문에 파일 시스템 API 및 streamingAssets 경로를 통해 스트리밍 에셋 파일에 직접 액세스할 수 없습니다. 대신 UnityWebRequest 클래스를 사용하여 콘텐츠에 액세스합니다.

참고:

  • streamingAssets 경로는 읽기 전용입니다. 런타임 시점에 새 파일을 수정하거나 streamingAssets 디렉토리에 작성하지 마십시오.
  • StreamingAssets 폴더에 있는 .dll 및 스크립트 파일은 스크립트 컴파일 중에 포함되지 않습니다.
  • 에셋 번들어드레서블은 일반적인 게임 빌드 데이터에 포함되지 않고 Streaming Assets 폴더보다 선호하는 콘텐츠에 액세스하는 대체 방법입니다.
타겟 플랫폼용 빌드 경로 요구 사항
빌드 파일 크기 축소