배칭을 사용하면 코드에서 에셋을 변경할 때 들어가는 시간과 처리 작업을 줄일 수 있습니다.
코드에서 여러 개의 에셋을 변경하는 경우(예: 에셋 파일 복사 또는 이동) 에셋 데이터베이스의 기본 동작은 각 변경 사항을 차례대로 처리하고, 해당 에셋에 대해 완전한 새로고침 프로세스를 수행한 후 다음 코드 줄로 이동하는 것입니다.
아래 예제에서는 세 개의 에셋이 변경되었습니다. Asset1은 복사되고, Asset2는 이동하고, Asset3은 삭제되었습니다.
AssetDatabase.CopyAsset("Assets/Asset1.txt", "Assets/Text/Asset1.txt");
AssetDatabase.MoveAsset("Assets/Asset2.txt", "Assets/Text/Asset2.txt");
AssetDatabase.DeleteAsset("Assets/Asset3.txt");
배칭을 사용하지 않으면 Unity는 각 변경 사항을 처리한 후 다음 코드 줄로 이동합니다. 이러한 방식은 불필요하게 많은 시간을 소비할 뿐만 아니라, 배칭을 사용할 경우 피할 수 있는 많은 콜백을 트리거합니다.
대신, 에셋 데이터베이스가 한 번에 작업 그룹을 처리하도록 지정할 수 있습니다. 이렇게 하려면 변경 작업을 수행하기 전에 에셋 데이터베이스에 정상적인 동작을 일시 정지하고 변경이 완료된 후 다시 시작하도록 지시해야 합니다.
특히 다음 작업 중 하나 이상을 수행하는 경우 배칭을 사용해야 합니다.
에셋 데이터베이스가 작업 그룹을 한 번에 처리하도록 지정하기 위해 AssetDatabase.StartAssetEditing 및 AssetDatabase.StopAssetEditing 메서드를 사용할 수 있습니다.
AssetDatabase.StartAssetEditing
이 메서드를 사용하면 에셋 편집을 시작한다고 에셋 데이터베이스에 알립니다. 그러면 에셋 데이터베이스는 일시 정지 상태가 되고, StopAssetEditing 메서드를 호출하여 완료되었음을 알리기 전까지 에셋에 대한 추가 변경 사항을 처리하지 않습니다.
AssetDatabase.StopAssetEditing
모든 에셋 변경을 수행한 후에는 이 메서드를 호출하여 에셋 데이터베이스에 변경 사항을 처리하고 정상적인 동작(변경 사항을 자동으로 즉시 처리)을 재개하도록 지시하십시오. 그러면 에셋 데이터베이스는 StartAssetEditing
및 StopAssetEditing
사이에 이루어진 모든 변경 사항을 일괄적으로 처리합니다. 이는 하나씩 처리할 때보다 속도가 훨씬 빠릅니다.
StartAssetEditing
을 두 번 이상 호출할 경우 해당 횟수만큼 StopAssetEditing
을 호출하여 에셋 데이터베이스가 변경 사항 처리를 자동으로 처리하는 정상적인 동작을 수행하도록 만들어야 합니다.
이는 이러한 함수가 단순한 켜기/끄기 스위치 역할을 하는 것이 아니라 카운터를 증분 및 감소시키기 때문입니다. ’StartAssetEditing’을 호출하면 카운터가 증가하고 ’StopAssetEditing’을 호출하면 카운터가 감소합니다. 카운터가 0에 도달하면 에셋 데이터베이스가 정상적인 동작을 재개합니다.
Unity가 단순한 켜기/끄기 부울이 아니라 카운터를 사용하는 이유는 코드가 여러 개의 중첩된 “시작” 및 “중지” 페어를 실행하는 경우 내부 페어가 의도치 않게 에셋 데이터베이스의 정상적인 동작을 너무 일찍 다시 활성화하는 것을 방지하기 위해서입니다. 대신, 각 페어는 카운터를 1씩 증분 및 감소시키고, 코드가 올바르게 중첩된 경우 ’StopAssetEditing’에 대한 마지막 외부 호출이 카운터를 0으로 설정합니다.
참고: 코드는 카운터가 0 밑으로 내려가지 않도록 해야 합니다. 그러면 오류가 발생합니다.
다음 예제는 이러한 메서드를 사용하는 권장 방법을 보여줍니다.
using UnityEditor;
public class StartStopAssetEditingExample : MonoBehaviour
{
[MenuItem("APIExamples/StartStopAssetEditing")]
static void CallAssetDatabaseAPIsBetweenStartStopAssetEditing()
{
try
{
//Place the Asset Database in a state where
//importing is suspended for most APIs
AssetDatabase.StartAssetEditing();
AssetDatabase.CopyAsset("Assets/Asset1.txt", "Assets/Text/Asset1.txt");
AssetDatabase.MoveAsset("Assets/Asset2.txt", "Assets/Text/Asset2.txt");
AssetDatabase.DeleteAsset("Assets/Asset3.txt");
}
finally
{
//Adding a call to StopAssetEditing inside
//a "finally" block ensures that the AssetDatabase
//state will be reset when leaving this function
AssetDatabase.StopAssetEditing();
}
}
}
AssetDatabase.StartAssetEditing
을 호출하면 Unity는 전체 에디터의 AssetDatabase를 일시 정지 상태로 전환합니다. 따라서 AssetDatabase.StopAssetEditing
을 호출하지 않으면 에디터는 모든 에셋 관련 작업(임포트, 새로고침 등)에 대해 응답하지 않는 것처럼 보이며, 정상적인 동작으로 복원하려면 에디터를 다시 시작해야 합니다.
try
… finally
블록을 사용하지 않은 상태에서 에셋을 수정하는 코드가 오류를 일으키면 StopAssetEditing
이 호출되지 않을 수 있습니다. 이러한 상황을 피하려면 호출을 try
…finally
블록 내부에 래핑해야 합니다. 즉 StartAssetEditing
호출과 에셋 수정 코드를 try
블록 내부에 배치하고 StopAssetEditing
호출을 finally
블록에 배치하십시오. 이렇게 하면 try
블록에서 변경 작업을 수행하는 동안 예외가 발생해도 AssetDatabase.StopAssetEditing
호출이 보장됩니다.
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 서비스 사업자가 설정할 수 있습니다. 쿠키를 허용하지 않으면 일부 기능이 정상 작동하지 않을 수 있습니다.
이 쿠키는 방문자 수, 데이터 트래픽 정보를 확인해 회사 사이트의 성능을 측정하고 개선할 수 있도록 합니다. 또한 가장 인기가 많거나 인기가 적은 페이지를 확인하며 방문자가 사이트를 이동하는 방법을 확인할 수 있도록 합니다. 쿠키가 수집하는 모든 정보는 누적되며 익명 처리됩니다. 쿠키를 허용하지 않으면 귀하가 회사 사이트에 방문한 시기를 알 수 없습니다.
이 쿠키는 회사의 광고 협력사가 회사 사이트에 설정한 것입니다. 해당 협력사는 귀하의 관심사에 대한 프로파일을 만들고 다른 사이트에서도 관련 광고를 표시하기 위해 이 쿠키를 사용합니다. 이 쿠키는 귀하의 브라우저와 기기를 식별함으로써 동작합니다. 이 쿠키를 허용하지 않으면 다른 웹사이트에서 회사가 제공하는 맞춤형 광고를 경험할 수 없습니다.
이 쿠키는 웹사이트의 기능을 위해 필수적이며, 회사 시스템 내에서 종료할 수 없습니다. 이 쿠키는 개인정보 선호도, 로그인 또는 양식 작성과 같은 서비스 요청에 해당하는 귀하의 행위에 따라서만 주로 설정됩니다. 귀하의 브라우저에서 이 쿠키를 차단하거나 쿠키에 대해 알림 설정을 할 수 있지만, 이 경우 해당 사이트의 일부 기능이 동작하지 않을 수 있습니다.