AsyncReadManagerMetrics 클래스를 사용하여 런타임 에셋 로드 및 파일 읽기 성능을 모니터링할 수 있습니다. 이 클래스는 AsyncReadManager에서 관리하는 모든 파일 읽기 작업에 대한 데이터를 기록합니다.
Unity 엔진은 AsyncReadManager를 사용하여 런타임 시 대부분의 파일을 읽습니다. AsyncReadManager로 로드된 파일에는 에셋 번들, 어드레서블 및 리소스가 포함됩니다. 또한 AsyncReadManager.Read를 사용하여 스크립트에서 파일을 로드할 수 있습니다.
AsyncReadManagerMetrics 클래스를 사용하면 지표 수집을 활성화하고 기록된 지표 데이터를 검색해서 가져올 수 있습니다. 분석에 도움이 되도록 기록된 데이터를 필터링하고 요약할 수도 있습니다. 이 지표 정보는 에셋 로드와 관련된 문제 영역을 식별하고 변경 사항이 에셋 로드 성능에 미치는 영향을 측정하는 데 도움이 됩니다.
AsyncReadManagerMetrics 클래스는 오직 개발 빌드에서만 사용할 수 있습니다. ENABLE_PROFILER
심볼을 사용하여 #if preprocessor 지시문 내에서 AsyncReadManagerMetrics API에 대한 모든 호출을 보호해야 합니다. ENABLE_PROFILER
심볼은 개발 빌드에 대해서만 정의되어 있으므로 지표를 사용할 수 없는 빌드에서 스크립트를 컴파일할 수 있습니다. 이전 버전과의 호환성을 위해 UNITY_2020_2_OR_NEWER
심볼을 사용하여 이전 버전의 Unity에서 지표 코드를 제거할 수도 있습니다. 다음 예를 참조하십시오.
# if ENABLE_PROFILER && UNITY_2020_2_OR_NEWER
AsyncReadManagerMetrics.StartCollectingMetrics();
# endif
데이터를 기록하려면 지표 컬렉션을 활성화해야 합니다. 다음 방법 중 하나로 지표 컬렉션을 활성화하십시오.
참고: Unity 에디터 애플리케이션을 실행할 때 -enable-file-read-metrics 를 전달하여 플레이 모드 진입 시 컬렉션을 활성화할 수 있습니다. 하지만 에디터는 텍스처와 같은 일부 카테고리의 에셋 자체만 로드하고 플레이 모드 진입 시에는 다시 로드하지 않습니다. 파일 IO 지표를 완전히 파악하려면 애플리케이션의 개발 빌드에서 데이터를 수집해야 합니다.
GetMetrics를 호출하여 AsyncReadManagerMetrics 클래스에서 수집한 지표를 검색해서 가져옵니다. 검색해서 가져온 후 지표를 지울지 여부를 지정하도록 AsyncReadManagerMetrics.Flags를 GetMetrics에 전달합니다. 저장된 지표에서 읽기를 완료한(취소 및 실패 포함) 모든 항목을 제거하려면 지표를 지우십시오. 지우는 작업은 대기 중이거나 진행 중인 작업에 영향을 주지 않으며, 완료 후 GetMetrics를 다시 호출하여 완료되지 않은 작업에 대한 지표에 액세스할 수 있습니다. 지표를 정기적으로 삭제하면 동일한 데이터를 다시 읽지 않고 시스템의 데이터 오버헤드를 줄일 수 있습니다.
# if ENABLE_PROFILER && UNITY_2020_2_OR_NEWER
AsyncReadManagerRequestMetric[] metrics
= AsyncReadManagerMetrics.GetMetrics(AsyncReadManagerMetrics.Flags.ClearOnRead);
# endif
가능하다면 지표 데이터는 읽기 작업에 관한 컨텍스트 정보를 포함합니다. 이 정보는 읽기를 요청한 AssetLoadingSubsystem, AssetName, AssetTypeID를 포함합니다. AsyncReadManager가 이 정보에 액세스할 수 없는 경우 이러한 지표 필드값은 각각 Other, empty, 0입니다.
참고: 현재 지원되는 것으로 알려진 에셋 타입 ID는 아래 표에 나와 있습니다. 나타날 수 있는 다른 타입 ID는 YAML 클래스 ID 레퍼런스를 참조하십시오.
타입 ID | 타입 이름 |
---|---|
28 | Texture2D |
117 | Texture3D |
89 | 큐브맵 |
43 | Mesh |
다음 메서드를 사용하여 AsyncReadManager 지표 요약을 가져올 수 있습니다.
예제:
# if ENABLE_PROFILER && UNITY_2020_2_OR_NEWER
AsyncReadManagerSummaryMetrics summaryOfMetrics
= AsyncReadManagerMetrics.GetCurrentSummaryMetrics(AsyncReadManagerMetrics.Flags.ClearOnRead);
# endif
또는
# if ENABLE_PROFILER && UNITY_2020_2_OR_NEWER
AsyncReadManagerRequestMetric[] metrics
= AsyncReadManagerMetrics.GetMetrics(AsyncReadManagerMetrics.Flags.ClearOnRead);
AsyncReadManagerSummaryMetrics summaryOfMetrics
= AsyncReadManagerMetrics.GetSummaryOfMetrics(metrics);
# endif
지표에 대한 요약 데이터에는 다음의 통계가 포함됩니다.
(전체 리스트는 AsyncReadManagerSummaryMetrics를 참조하십시오.)
기본적으로 요약된 통계에는 대기 열에 있거나 진행 중인 작업을 비롯하여 모든 읽기 작업이 포함됩니다. 필터를 사용하여 특별히 관심 있는 작업으로만 요약을 제한할 수 있습니다. 예를 들어 필터를 사용하여 요약된 통계를 텍스처 에셋에 대한 완료된 읽기 작업으로만 제한할 수 있습니다.
참고: 요약 통계를 계산하는 데는 처리 리소스가 필요합니다. 이러한 계산으로 인해 기록 중인 측정이 변경되지 않도록 하려면 먼저 지표를 수집하고, 분석 중인 작업이 완료된 후 요약을 가져오시기 바랍니다.
이러한 방법 중 하나로 AsyncReadManagerMetricsFilters를 사용하여 요약할 데이터 타입을 지정합니다. 필터와 일치하지 않는 지표는 요약에서 제외됩니다. 다음 카테고리로 필터링할 수 있습니다.
동일한 필터에 대해 여러 카테고리를 설정할 수 있습니다. 읽기 작업은 해당 작업의 지표가 요약에 포함되도록 모든 카테고리와 일치해야 합니다. 예를 들어 필터의 ProcessingState 및 Subsystem 모두에 대한 값을 지정하여 지정된 하위 시스템에서 시작된 지정된 처리 상태의 작업만 요약할 수 있습니다.
카테고리에 여러 값을 지정할 수도 있습니다. 이 경우 읽기 작업은 요약에 포함할 지표의 카테고리에 지정된 모든 값과 일치할 수 있습니다. 예를 들어 하위 시스템 카테고리에 대해 메시 및 텍스처를 모두 지정하여 메시 에셋과 텍스처 에셋의 작업만 요약할 수 있습니다.
Did you find this page useful? Please give it a rating:
Thanks for rating this page!
What kind of problem would you like to report?
Thanks for letting us know! This page has been marked for review based on your feedback.
If you have time, you can provide more information to help us fix the problem faster.
Provide more information
You've told us this page needs code samples. If you'd like to help us further, you could provide a code sample, or tell us about what kind of code sample you'd like to see:
You've told us there are code samples on this page which don't work. If you know how to fix it, or have something better we could use instead, please let us know:
You've told us there is information missing from this page. Please tell us more about what's missing:
You've told us there is incorrect information on this page. If you know what we should change to make it correct, please tell us:
You've told us this page has unclear or confusing information. Please tell us more about what you found unclear or confusing, or let us know how we could make it clearer:
You've told us there is a spelling or grammar error on this page. Please tell us what's wrong:
You've told us this page has a problem. Please tell us more about what's wrong:
Thank you for helping to make the Unity documentation better!
Your feedback has been submitted as a ticket for our documentation team to review.
We are not able to reply to every ticket submitted.
방문하는 모든 웹사이트의 정보가 브라우저에서 쿠키 형태로 저장되거나 수집될 수 있습니다. 본 정보는 귀하와 귀하의 선호도, 기기에 대한 것이며, 귀하의 선호도에 따라 사이트가 동작하도록 하는 데 사용됩니다. 본 정보는 귀하를 직접적으로 식별하지 않으나 보다 개인화된 웹 경험을 제공하기 위해 사용됩니다. 그러나 일부 쿠키를 거부할 수 있습니다. 더 자세한 정보를 확인하고 기본 설정을 변경하려면 해당 카테고리의 제목을 클릭하세요. 그러나 일부 쿠키를 차단하면 귀하의 사이트 경험과 회사에서 제공하는 서비스에 영향을 미칠 수 있습니다.
추가 정보
본 쿠키는 동영상 및 실시간 채팅과 같은 고급 기능과 개인화를 허용합니다. 쿠키는 회사 또는 회사 페이지에 추가된 제3 서비스 사업자가 설정할 수 있습니다. 쿠키를 허용하지 않으면 일부 기능이 정상 작동하지 않을 수 있습니다.
이 쿠키는 방문자 수, 데이터 트래픽 정보를 확인해 회사 사이트의 성능을 측정하고 개선할 수 있도록 합니다. 또한 가장 인기가 많거나 인기가 적은 페이지를 확인하며 방문자가 사이트를 이동하는 방법을 확인할 수 있도록 합니다. 쿠키가 수집하는 모든 정보는 누적되며 익명 처리됩니다. 쿠키를 허용하지 않으면 귀하가 회사 사이트에 방문한 시기를 알 수 없습니다.
이 쿠키는 회사의 광고 협력사가 회사 사이트에 설정한 것입니다. 해당 협력사는 귀하의 관심사에 대한 프로파일을 만들고 다른 사이트에서도 관련 광고를 표시하기 위해 이 쿠키를 사용합니다. 이 쿠키는 귀하의 브라우저와 기기를 식별함으로써 동작합니다. 이 쿠키를 허용하지 않으면 다른 웹사이트에서 회사가 제공하는 맞춤형 광고를 경험할 수 없습니다.
이 쿠키는 웹사이트의 기능을 위해 필수적이며, 회사 시스템 내에서 종료할 수 없습니다. 이 쿠키는 개인정보 선호도, 로그인 또는 양식 작성과 같은 서비스 요청에 해당하는 귀하의 행위에 따라서만 주로 설정됩니다. 귀하의 브라우저에서 이 쿠키를 차단하거나 쿠키에 대해 알림 설정을 할 수 있지만, 이 경우 해당 사이트의 일부 기능이 동작하지 않을 수 있습니다.