콘솔 창에는 오류, 경고, 에디터가 생성하는 기타 메시지가 표시됩니다. 이러한 오류와 경고는 스크립트 컴파일 오류와 같은 프로젝트의 문제를 찾는 데 도움이 됩니다. 또한 누락된 메타 파일을 교체하는 것과 같이 에디터가 자동으로 수행한 행동에 대해 경고합니다. 이러한 행동은 프로젝트의 다른 곳에서 문제를 일으킬 수도 있습니다.
프로젝트를 디버그하는 데 도움이 되는 디버그 클래스를 사용하여 콘솔에 고유한 메시지를 출력할 수 있습니다. 예를 들어 스크립트의 특정 지점에서 변수 값을 출력하여 변수가 어떻게 변경되는지 확인할 수 있습니다.
이 페이지에서는 콘솔 창으로 작업할 때 사용할 수 있는 옵션과 특정 키워드를 검색하여 메시지를 필터링하는 방법에 대해 설명합니다.
콘솔 창을 열려면 Unity 메인 메뉴에서 Window > General > Console로 이동합니다.
A. 콘솔 툴바에는 메시지를 표시하는 방법을 제어하기 위한 옵션과 메시지를 검색 및 필터링하기 위한 옵션이 있습니다.
B. 콘솔 창 메뉴에는 로그 파일을 열고, 리스트에 표시되는 각 메시지의 양을 제어하고, 스택 추적 옵션을 설정하기 위한 옵션이 있습니다.
C. 콘솔 리스트는 기록된 각 메시지에 대한 항목을 표시합니다. 상세 영역에 전체 텍스트를 표시할 메시지를 선택하십시오. 여기에서 표시할 각 메시지의 줄 수를 선택할 수 있습니다. 아래의 줄 수 조절을 참조하십시오.
D. 상세 영역에는 선택한 메시지의 전체 텍스트가 표시됩니다. 스택 추적이 활성화된 경우에는 상세 영역에 코드 파일의 특정 라인에 대한 레퍼런스가 클릭 가능한 링크로 표시됩니다.
콘솔 창의 툴바에는 메시지를 표시하는 방법을 제어하기 위한 옵션과 메시지를 검색 및 필터링하기 위한 옵션이 있습니다.
옵션 | 기능 | |
---|---|---|
Clear | 컴파일러 오류를 제외하고 코드가 생성한 모든 메시지를 지웁니다.br/> 지우기 옵션이 있는 드롭다운 메뉴를 엽니다. |
|
Clear On Play | 플레이 모드를 실행할 때 콘솔 창의 내용을 자동으로 지웁니다. | |
Clear on Build | 프로젝트를 빌드할 때 콘솔의 내용을 지웁니다. | |
Clear on Recompile | 프로젝트를 다시 컴파일할 때 콘솔의 내용을 지웁니다. | |
Collapse | 반복해서 발생하는 오류 메시지를 모두 표시하는 대신 첫 번째 인스턴스만 Display. 각 프레임 업데이트마다 발생하는 null 레퍼런스와 같은 런타임 오류를 간결하게 보고 싶을 때 매우 유용합니다. |
|
Error Pause |
Debug.LogError 를 스크립트에서 호출할 때마다 재생을 일시 정지합니다.실행 중인 특정 시점에서 재생을 멈추고 씬을 검사하고 싶을 때 사용합니다. 스크립트에서 Debug.Log 를 호출할 때는 재생을 일시 정지하지 않습니다. |
|
[Attach-to-Player] | 원격 기기에서 실행 중인 개발 빌드에 연결하고 해당 플레이어 로그를 콘솔에 표시하기 위한 옵션이 들어 있는 드롭다운 메뉴를 엽니다. 이 옵션에는 타겟 개발 빌드(콘솔 창에 표시되는 로그의 빌드)의 이름이 레이블로 지정되어 있습니다. 콘솔이 원격 빌드에 연결되지 않으면 Editor라는 레이블이 지정됩니다. 이는 로컬 Unity 에디터의 콘솔 창에 표시된 로그라는 의미입니다. |
|
Player Logging | 콘솔이 원격 개발 빌드에 연결되면 해당 빌드에 대한 플레이어 로깅이 활성화됩니다. 이 옵션을 비활성화하면 로깅이 일시 중단되지만, 콘솔은 타겟 빌드에 계속 연결된 상태를 유지합니다. 또한 이 옵션을 비활성화하면 이 드롭다운 메뉴의 나머지 옵션을 숨깁니다. Player Logging 아래에 나열된 빌드를 선택하여 해당 로그를 콘솔 창에 표시합니다. |
|
에디터 | 콘솔이 원격 ** 개발 빌드에 연결되면 이 옵션을 선택하여 원격 빌드의 로그 대신 로컬 Unity 플레이어의 로그를 표시합니다. |
| | <Enter IP> | Enter Player IP** 다이얼로그를 엽니다. 여기에서 원격 기기의 개발 빌드에 대한 IP 주소를 지정할 수 있습니다.빌드에 연결하려면 다이얼로그에서 Connect를 선택하고 드롭다운 메뉴의 하단에 있는 개발 빌드 리스트에 추가합니다. |
|
[DEVELOPMENT BUILDS] | 이용 가능한 개발 빌드를 나열합니다. 여기에는 자동으로 감지된 빌드와 Enter IP 옵션을 통해 추가하는 빌드가 포함됩니다. |
콘솔 검색창에서 특정 키워드에 대한 콘솔 메시지를 검색할 수 있습니다. 검색어를 입력하면 콘솔이 메시지를 필터링하여 일치하는 텍스트가 포함된 결과만 표시합니다. 콘솔은 메시지 텍스트의 첫 번째 매치가 메시지의 가시 범위 내에 있을 때만 이를 강조하여 표시합니다(아래의 줄 수 조절 참조).
숫자, 특수 문자 등을 비롯하여 콘솔 메시지에 표시되는 모든 것을 검색할 수 있습니다. 예를 들어 콘솔이 메시지를 기록한 시간을 검색할 수 있습니다.
검색은 검색창에 입력된 검색어와 정확히 일치하는 매치를 찾습니다. 한 번에 두 개의 다른 검색어를 검색하거나 일반 검색 엔진 연산자를 사용할 수 없습니다.
또한 타입별로 콘솔 메시지를 필터링할 수도 있습니다. 검색창 옆에 있는 버튼을 클릭하여 토글할 수 있습니다.
버튼 | 기능 |
---|---|
![]() Messages switch |
콘솔의 메시지 수를 표시합니다. 클릭하면 메시지를 표시하거나 숨깁니다. |
![]() Warnings switch |
콘솔의 경고 수를 표시합니다. 클릭하면 경고를 표시하거나 숨깁니다. |
![]() Errors switch |
콘솔의 오류 수를 표시합니다. 클릭하면 오류를 표시하거나 숨깁니다. |
각 콘솔 항목의 최대 줄 수는 10줄입니다.
리스트에 표시되는 각 항목의 줄 수를 제어하려면 Console 메뉴 버튼을 클릭한 후 Log Entry > [X] Lines를 선택하십시오. 여기서 [X]는 각 항목에 대해 표시할 줄 수입니다.
줄 수가 많으면 각 항목당 더 많은 텍스트를 표시하지만, 한 번에 표시되는 항목 수가 줄어듭니다. 줄 수는 콘솔 검색 기능에는 영향을 주지 않습니다. 콘솔 검색 기능은 항상 전체 메시지 텍스트를 검색합니다. 일치하는 텍스트가 숨겨진 줄에 있으면 해당 메시지를 결과로 반환하지만 일치하는 텍스트를 노출하거나 강조 표시하기 위해 확장하지는 않습니다. 전체 메시지 텍스트는 상세 영역에서 볼 수 있으며, 일치하는 텍스트는 상세 영역에서 강조 표시되지 않습니다.
Unity 콘솔 메시지와 로그 파일에는 상세한 스택 추적 정보를 포함할 수 있습니다. 스택 추적 로깅 설정을 통해 스택 추적 정보의 양을 제어할 수 있습니다.
콘솔 창에 기록하는 모든 Unity 또는 코드는 로그 파일에도 기록됩니다. 콘솔 창 메뉴에서 로그 파일을 열 수 있습니다. Open Player Log 또는 Open Editor Log를 선택합니다.
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 서비스 사업자가 설정할 수 있습니다. 쿠키를 허용하지 않으면 일부 기능이 정상 작동하지 않을 수 있습니다.
이 쿠키는 방문자 수, 데이터 트래픽 정보를 확인해 회사 사이트의 성능을 측정하고 개선할 수 있도록 합니다. 또한 가장 인기가 많거나 인기가 적은 페이지를 확인하며 방문자가 사이트를 이동하는 방법을 확인할 수 있도록 합니다. 쿠키가 수집하는 모든 정보는 누적되며 익명 처리됩니다. 쿠키를 허용하지 않으면 귀하가 회사 사이트에 방문한 시기를 알 수 없습니다.
이 쿠키는 회사의 광고 협력사가 회사 사이트에 설정한 것입니다. 해당 협력사는 귀하의 관심사에 대한 프로파일을 만들고 다른 사이트에서도 관련 광고를 표시하기 위해 이 쿠키를 사용합니다. 이 쿠키는 귀하의 브라우저와 기기를 식별함으로써 동작합니다. 이 쿠키를 허용하지 않으면 다른 웹사이트에서 회사가 제공하는 맞춤형 광고를 경험할 수 없습니다.
이 쿠키는 웹사이트의 기능을 위해 필수적이며, 회사 시스템 내에서 종료할 수 없습니다. 이 쿠키는 개인정보 선호도, 로그인 또는 양식 작성과 같은 서비스 요청에 해당하는 귀하의 행위에 따라서만 주로 설정됩니다. 귀하의 브라우저에서 이 쿠키를 차단하거나 쿠키에 대해 알림 설정을 할 수 있지만, 이 경우 해당 사이트의 일부 기능이 동작하지 않을 수 있습니다.