SDK v4 Unity¶

Unity 엔진 프로젝트에 적용할 수 있는 SDK 최신 버전과 적용 가이드, 그리고 SDK 배포 버전별 주요 변경 사항을 안내합니다.

SDK 최신 버전¶

Unity 엔진 프로젝트의 각 타겟 OS 환경에 맞는 SDK 최신 버전을 다운로드하세요.

※ 타겟 OS별 SDK 배포 파일을 설치 시, 반드시 Unity Interface도 함께 설치해야 합니다.

버전별 제약 사항 및 종속성¶

• Hive SDK v4 Unity 25.0.0 이상에서 보안 키 발급 필수
  • 인증 보안 프로토콜 변경으로 인해, Hive SDK v4 Unity 25.0.0 이상 사용 시, 반드시 Hive 콘솔 > 보안 키 설정에서 보안 키를 발급 받아야 합니다. 보안 키를 발급받지 않으면, 앱에서 로그인할 수 없습니다.
• Hive SDK v4 Unity 25.1.3 이상에서 PG 결제 구현 변경 필요
  • Android&iOS 25.1.3 이상 혹은 Windows 25.1.0 이상에서 PG 결제를 구현하려면 PG 결제 동작 과정을 참고하여 PG 결제 구현 코드를 변경해야 합니다.
• Hive SDK v4 Unity 25.4.0 이상에서 SDK 매니저 사용 시, SDK Manager v 2.0.0 이상으로 업데이트 하세요.

SDK 배포 패키지 적용 가이드¶

SDK v4 Unity 25.5.1 부터는 SDK 배포 패키지를 Interface 패키지와 Platform OS 패키지로 분리하여 아래와 같이 총 4개 파일로 제공합니다.

• Hive SDK v4 Unity Interface 25.5.x
• Hive SDK v4 Unity Android 25.5.x
• Hive SDK v4 Unity iOS 25.5.x
• Hive SDK v4 Unity Windows 25.5.x

분리된 SDK 배포 파일은 버전이 각기 다르더라도 패키지 적용 규칙에 따라 호환하여 적용할 수 있습니다. 따라서 호환 가능한 버전이라면 SDK 배포 패키지를 부분적으로 업데이트할 수 있어 SDK 적용부터 게임 앱 배포까지의 시간을 단축할 수 있습니다.

SDK 배포 패키지를 적용하는 순서는 아래와 같습니다.

1) 패키지 적용 규칙을 참고하여 다운로드하려는 Hive SDK v4 Unity Interface 25.5.x 파일과 타겟 OS SDK 배포 파일(예: Hive SDK v4 Unity Windows 25.5.x) 간의 호환 여부를 확인합니다.
2) 적용하려는 Hive SDK v4 Unity Interface 25.5.x 파일을 다운로드 후 프로젝트에 임포트합니다. Unity 엔진 개발 환경에서는 타겟 OS 종류와 상관없이 Hive SDK v4 Unity Interface 25.5.x 파일을 반드시 적용해야 합니다.
3) 다운로드한 Hive SDK v4 Unity Interface 25.5.x 파일과 호환되는 타겟 OS SDK 배포 파일을 다운로드 후 프로젝트에 임포트합니다.

SDK 매니저를 사용하면 위 1) ~ 3) 과정을 보다 빠르고 간편하게 진행할 수 있습니다. SDK 매니저로 SDK 업그레이드를 참고하여 SDK 최신 버전으로 업데이트하세요.

핫픽스 버전 업데이트¶

SDK 배포 패키지 중 일부 파일만 v4.25.5.x 와 같은 핫픽스 버전으로 업데이트되는 경우, SDK 최신 버전에서는 업데이트된 핫픽스 버전의 배포 파일(예: Hive SDK v4 Unity iOS 25.5.2)과 업데이트되지 않은 기존 버전의 배포 파일을 함께 제공합니다.

이 때 SDK 매니저가 아닌 수동 설치 방법으로 최신 핫픽스 버전을 적용하는 경우, SDK Unity 업데이트 가이드를 참고하여 적용하려는 핫픽스 버전 이전에 설치된 파일은 삭제 후, 최신 핫픽스 버전의 배포 파일을 설치하세요. 업데이트되지 않은 기존 설치된 배포 파일은 삭제하지 않고 유지해야 합니다.

SDK 매니저를 사용할 경우, 해당되는 배포 파일만 최신 핫픽스 버전으로 자동 업데이트됩니다.

주요 변경 사항¶

SDK 최신 버전부터 각 배포 버전 별 주요 변경 사항을 안내합니다.

• Unity Android & iOS
• Unity Windows