glTFast

glTFast를 사용하여 런타임 또는 Editor에서 glTF™ 3D 파일을 효율적으로 임포트하고 익스포트하세요.

설치 (Installing)

Unity glTFast는 Package이며, Unity®의 Package Manager 창에서 com.unity.cloud.gltfast라는 이름으로 설치할 수 있습니다. 자세한 지침은 설치(installation)를 참고하세요.

참고: 이 패키지는 원래 식별자(identifier)가 com.atteneder.gltfast였습니다. Unity 버전(com.unity.cloud.gltfast)으로 전환하는 방법이나 원래 패키지 설치 방법에 대한 내용은 업그레이드 가이드를 참고하세요.

기능 (Features)

Unity glTFast의 초점은 속도, 메모리 효율성, 그리고 작은 빌드 크기입니다.

glTF 2.0 사양과 방대하고 증가하는 수의 glTF 확장(glTF extensions)을 지원합니다.

Universal, High Definition, Built-In Render Pipeline 등 모든 플랫폼에서 지원됩니다.

고급 사용자는 glTFast를 다양한 방식으로 커스터마이징하거나 확장할 수 있습니다.

지원되는 기능 및 확장의 종합 목록은 여기를 참고하세요.

워크플로우 (Workflows)

Unity에서 glTF를 사용하는 네 가지 사용 사례가 있습니다.

• 임포트 (Import)
  • 게임/애플리케이션에서의 런타임 임포트/로딩
  • Editor 임포트 (즉, 디자인 타임에 에셋을 임포트)
• 익스포트 (Export)
  • 런타임 익스포트 (동적이고 사용자 생성 3D 콘텐츠 저장 및 공유)
  • Editor 익스포트 (Unity를 glTF 제작 도구로 사용)

워크플로우에 대한 자세한 내용은 문서(documentation)를 읽어보세요.

사용법 (Usage)

URL 또는 파일 경로에서 glTF 에셋을 로드할 수 있습니다.

컴포넌트를 통한 런타임 로딩 (Runtime Loading via Component)

GameObject에 GltfAsset 컴포넌트를 추가하세요.

스크립트를 통한 런타임 로딩 (Runtime Loading via Script)

var gltf = gameObject.AddComponent<GLTFast.GltfAsset>();
gltf.url = "https://raw.githubusercontent.com/KhronosGroup/glTF-Sample-Assets/main/Models/Duck/glTF/Duck.gltf";

문서의 스크립트를 통한 런타임 로딩(Runtime Loading via Script)에서 더 자세한 내용과 스크립트를 통해 로딩 동작을 사용자 정의하는 방법에 대한 지침을 확인하세요.

에디터 임포트(Editor Import)

glTF 파일을 다른 3D 형식과 유사하게 프로젝트의 Assets 폴더로 이동하거나 복사하세요:

Unity glTFast는 이를 네이티브 Unity 프리팹으로 임포트하고 에셋 데이터베이스에 추가합니다.

자세한 내용은 문서의 에디터 임포트(Editor Import)를 참조하세요.

에디터 익스포트(Editor Export)

메인 메뉴에는 File > Export 아래에 몇 가지 glTF 익스포트 항목이 있으며, glTF는 또한 스크립트를 통해 생성할 수 있습니다.

프로젝트 설정(Project Setup)

머티리얼 및 셰이더 변형(Materials and Shader Variants)

❗ 중요(IMPORTANT)❗

Unity glTFast는 머티리얼을 작동시키기 위해 빌드에 반드시 포함해야 하는 사용자 정의 셰이더 그래프를 사용합니다. Unity 에디터에서는 머티리얼이 정상적이지만 빌드에서 문제가 발생한다면, 일부 셰이더(또는 변형)가 누락되었을 가능성이 높습니다.

자세한 내용은 문서의 머티리얼 및 셰이더 변형(Materials and Shader Variants) 섹션을 읽어보세요.

기여(Contribution)

CONTRIBUTING.md를 참조하세요.

라이선스(License)

Copyright 2023 Unity Technologies and the Unity glTFast authors

Apache License, Version 2.0(

적용 가능한 법률에 의해 요구되거나 서면으로 합의되지 않는 한, 본 라이선스 하에서 배포되는 소프트웨어는 명시적이든 묵시적이든 어떠한 종류의 보증이나 조건 없이 "있는 그대로(AS IS)" 기준으로 배포됩니다. 라이선스 하의 권한 및 제한에 대한 구체적인 언어는 라이선스를 참조하십시오.

상표권 (Trademarks)

*Unity®*는 Unity Technologies의 등록 상표입니다.

*Khronos®*는 등록 상표이며, glTF™는 The Khronos Group Inc의 상표입니다.