[Python/Unreal] 3. Unreal Python API 문서 (콘텐츠 브라우저 접근, list_assets 메서드)

개요

list_assets 메서드를 활용하여,

콘텐츠 브라우저에 접근해 저장된 에셋 목록을 print한다.

 

영상

https://dev.epicgames.com/community/learning/courses/Y97/unreal-engine-python/or06/unreal-engine-python-api

Python을 활용하여 언리얼 엔진에서 에디터 스크립팅하기 | Course

 

내용

 API 문서 보는 법 (버전 확인 필수)

4.27 버전용이 있고 5 버전용이 있다.

가급적 최신 버전 확인하는게 좋다.

https://dev.epicgames.com/documentation/en-us/unreal-engine/python-api/?application_version=5.0

 

유용한 페이지 소개

Introduction에 들어가보면 짧지만 유용한 링크가 있다.

 

- 소개

https://dev.epicgames.com/documentation/en-us/unreal-engine/python-api/introduction?application_version=5.0

 

- 유용한 링크

파이썬 스크립팅 처음 사용시 유용한 설명들이다.

https://docs.unrealengine.com/en-us/ProductionPipelines/ScriptingAndAutomation/Python/index.html

 

팁 : 원하는 기능 찾는 법 (구글 검색)

문서에 나열된 항목이 너무 많다. 이를 필터링하는 노하우가 필요하다.

 

콘텐츠 브라우저 관련 함수 기능에 액세스하는 법을 예로 들어보자.

그냥 검색하면 아래 그림처럼 너무 많이 나와서 찾기가 힘들다.

 

 

따라서 그냥 구글에서 unreal python 뒤에 키워드를 붙이는 것을 추천한다.

 

클래스, 메서드 살펴보기

콘텐츠 브라우저에 대한 함수 기능을 제공하는 클래스라고 적혀있다.

 

list_assets 메서드를 살펴보자.

파라미터 중 1개는 필수, 나머지 2개는 옵션임(기본값이 들어가있음)을 확인할 수 있다. 

 

list_assets 메서드를 사용해보기

 

언리얼 디렉토리 확인

표기되는 것과 마우스를 올려놓았을 때 경로 이름이 다르다.

마우스 올려놓은것 기준으로 작업한다.

 

루트는 반드시 /Game이 되어야한다.

/All로 하면 루트로 설정하라는 경고가 뜬다.

 

올바르게 루트 경로가 수정된 코드

 

언리얼에서 호출하는 법 (Output Log 창 이용)

reload(TS)
TS.listAssetsPaths()

 

언리얼 네이밍 규칙 소개

항상 클래스는 소문자로 된 unreal로 시작한다.

각 단어의 첫 글자는 대문자가 된다.

각 메서드는 소문자로 적고 언더스코어로 연결한다.

프로퍼티도 마찬가지다.

 

실행결과