레벨플레이 연동 관련 문제 해결#

Unity 에디터와 레벨플레이를 연동할 때 몇 가지 문제가 생길 수도 있습니다. 이 가이드를 참고로 해결할 수 있는 문제 유형은 다음과 같습니다.

• 중복된 클래스 오류 메시지
• 아이언소스 SDK에서 스크립팅 기호 제거 불가
• 종속성 클래스 누락 오류 메시지

중복된 클래스 오류 메시지#

프로젝트를 만들거나 테스트할 때 중복된 클래스 오류 메시지(CSO433)가 나타납니다. 이 오류 메시지로 중복된 클래스와 해당 클래스가 나타나는 어셈블리를 식별할 수 있습니다. 다음은 중복된 클래스 오류 메시지 예제입니다.

• The type IronSourceMediationSettings exists in both Assembly-CSharp, Version=0.0.0.0, Culture=neutral, PublicKeyToken=null and 'Unity.LevelPlay, Version=0.0.0.0, Culture=neutral, PublicKeyToken=null

다음과 같은 이유로 중복된 클래스 오류가 표시됩니다.

• Unity 플러그인을 제거하지 않고 Ads Mediation 패키지 업데이트
• Ads Mediation 패키지를 제거하지 않고 Unity 플러그인 업데이트
• 중요한 Ads Mediation 패키지 업데이트

다음 섹션을 참고하여 이러한 문제의 설명과 해결 방법에 대해 알아보십시오.

Unity 플러그인을 제거하지 않고 Ads Mediation 패키지 업데이트#

.unitypackage 파일(Unity 플러그인)이 이미 인스톨된 상태에서 Ads Mediation 패키지를 통해 최신 버전의 Unity 레벨플레이가 업데이트되었습니다.

해결 방법#

.unitypackage 파일(Unity 플러그인)을 제거한 다음 Ads Mediation 패키지를 인스톨하거나 업데이트합니다. 플러그인을 제거하려면 다음 단계를 완료합니다.

1. Unity 에디터에서 프로젝트를 열어서 Assets로 이동합니다.
2. Assets에서 취해야 하는 조치는 다음과 같이 사용하는 아이언소스 SDK 버전에 따라 다릅니다.
   • SDK v7.8.0 포함 이전인 경우: IronSource를 오른쪽 클릭하여 Delete를 선택합니다.
   • SDK v8.0.0인 경우: LevelPlay를 오른쪽 클릭하여 Delete를 선택합니다.

Ads Mediation 패키지를 제거하지 않고 Unity 플러그인 업데이트#

Ads Mediation이 이미 인스톨된 상태에서 .unitypackage 파일을 통해 최신 버전의 Unity 레벨플레이가 업데이트되었습니다.

해결 방법#

Ads Mediation 패키지를 제거한 다음 Unity 플러그인을 인스톨하거나 업데이트합니다. 다음 단계에 따라 Unity 에디터에서 Ads Mediation 패키지를 제거합니다.

1. Unity 에디터에서 프로젝트를 열고 Window > Package Manager로 이동합니다.
2. Package Manager에서 Packages > In Project를 선택합니다.
3. Ads Mediation > Remove를 선택합니다.
4. Unity 에디터에서 프로젝트를 열어서 Assets로 이동합니다.
5. Assets에서 취해야 하는 조치는 다음과 같이 사용하는 아이언소스 SDK 버전에 따라 다릅니다.
   • SDK v7.8.0 포함 이전인 경우: IronSource를 오른쪽 클릭하여 Delete를 선택합니다.
   • SDK v8.0.0인 경우: LevelPlay를 오른쪽 클릭하여 Delete를 선택합니다.
6. 인스톨된 경우 Mobile Dependency Resolver를 오른쪽 클릭하여 Delete를 선택합니다.

중요한 Ads Mediation 패키지 업데이트#

Ads Mediation 패키지가 초기 버전에서 가장 최신 버전으로 업데이트되었습니다.

해결 방법#

Ads Mediation 패키지에 중요한 업데이트가 필요하면 원활한 업그레이드 경로를 확보하기 위해 추가 단계가 필요할 수 있습니다.

예를 들어 v1.0.0에서 v8.0.0으로 업데이트를 진행하면 업데이트 시 추가 단계를 거쳐야 합니다. 자세히 알아보려면 Unity 패키지 관리자의 Ads Mediation 패키지 설명을 참고하십시오.

아이언소스 SDK에서 스크립팅 기호 제거 불가#

아이언소스 SDK에서 LEVELPLAY_DEPENDENCIES_INSTALLED 스크립팅 기호를 제거했지만 SDK에 자동으로 다시 나타납니다.

원인#

SDK에서 LEVELPLAY_DEPENDENCIES_INSTALLED 스크립팅 기호를 제거하면 SDK는 항상 기호를 자동으로 다시 추가합니다. 버전 8.0.0인 아이언소스 SDK Unity 패키지부터 이 스크립팅 기호가 필요합니다.

해결 방법#

스크립팅 기호가 아이언소스 SDK 버전 8.0.0부터 필요하기 때문에 이 문제의 경우 알려진 해결 방법이 없습니다. 이 기호는 삭제하면 항상 자동으로 다시 추가됩니다.

종속성 클래스 누락 오류 메시지#

Ads Mediation 패키지를 인스톨한 후 종속성 클래스 오류 메시지가 나타납니다. 다음은 종속성 클래스 누락 경고 메시지 예제입니다.

• The type or namespace name Core does not exist in the namespace Unity.Services.
• The type or namespace name Newtonsoft could not be found.
• The type or namespace name EditorGameServiceFlagEnabler could not be found.

원인#

아이언소스 SDK Unity 패키지에서 com.unity.services.core 종속성이 제거되거나 인스톨이 완료되지 않으면 발생할 수 있습니다. 이 종속성이 누락되면 콘솔에는 어떤 종속성 클래스를 찾을 수 없는지 식별하는 오류 메시지가 표시됩니다.

해결 방법#

누락된 com.unity.services.core 종속성 문제를 해결하는 방법은 두 가지입니다. 이름별로 Services Core 패키지를 수동으로 인스톨하거나 LEVELPLAY_DEPENDENCIES_INSTALLED 스크립팅 기호를 제거하는 것입니다.

패키지 관리자에서 Services Core 패키지 인스톨#

다음 내용에 따라 누락된 종속성 문제를 해결하기 위해 Unity 패키지 관리자에서 Services Core 패키지를 인스톨합니다.

1. Unity 에디터에서 프로젝트를 열고 Window > Package Manager로 이동합니다.
2. Package Manager 창에서 + 아이콘을 선택하여 드롭다운 메뉴를 열고 **Install package by name...**을 선택하여 패키지 이름을 수동으로 입력합니다.
3. Name 필드에 com.unity.services.core를 입력하고 Install을 선택합니다.

LEVELPLAY_DEPENDENCIES_INSTALLED 스크립팅 기호 제거#

LEVELPLAY_DEPENDENCIES_INSTALLED 스크립팅 기호를 사용하여 Services Core 패키지를 복원할 수도 있습니다. 제거가 완료되면 스크립팅 기호가 자동으로 다시 추가됩니다. 재인스톨 프로세스를 진행하면 com.unity.services.core 패키지 역시 자동으로 다시 인스톨됩니다. 에디터에 Services Core 패키지가 표시되지 않으면 이 방법을 사용합니다.

누락된 종속성 문제를 해결하기 위해 다음과 같이 아이언소스 SDK Unity 패키지에서 LEVELPLAY_DEPENDENCIES_INSTALLED 스크립트 기호를 삭제합니다.

1. Unity 에디터에서 프로젝트를 열고 Edit > Project Settings > Player로 이동합니다.
2. Other Settings 창에서 Script Compilation이 나오도록 아래로 스크롤합니다.
3. 마이너스 기호(−)를 선택하여 기호를 제거하고 LEVELPLAY_DEPENDENCIES_INSTALLED를 선택합니다.
4. Apply를 선택하여 변경 사항을 저장합니다.