버전
menu_open

Migrating your projects

새로운 Wwise 버전으로 업그레이드할 준비가 되었다면 이전 버전에서 이후 버전으로 원활하게 마이그레이션할 수 있도록 마련된 프로토콜을 반드시 따라야 합니다. 여기서 목표는 게임의 모든 방면이 위험에 처하지 않도록 하는 것이기 때문에, 새로운 버전에서 변경 사항을 검토하여 게임 코드를 선택적이고 체계적으로 수정해야 합니다.

업그레이드와 마이그레이션 프로토콜은 다음 조건에 따라 다를 수 있습니다.

  • 소스 컨트롤을 사용하는 프로젝트: 주요 시점에서 프로젝트를 체크 인해야 합니다.

  • 여러 사용자: 여러 사용자가 작업 환경에서 Wwise를 업그레이드하기 전에 먼저 Wwise 업그레이드, 프로젝트 마이그레이션, SDK 업데이트, 게임 코드가 로컬 시스템에서 완료되어야 합니다.

  • 통합된 게임 프로젝트: 마이그레이션 노트 안에 지정된대로 게임 코드가 변경되어야 합니다.

마이그레이션 팀(1~2명으로 구성)이 로컬 시스템에서 먼저 다음 작업을 수행해야 합니다.

마이그레이션 팀이 이러한 작업을 수행한 후 다음을 수행할 수 있습니다.

소스 컨트롤을 사용하는 프로젝트의 업그레이드와 마이그레이션 작업 과정의 개요는 다음 차트를 참고해 주세요:

Preparing your projects for migration

특히 Wwise 프로젝트가 게임으로 통합되었을 경우, 새로운 Wwise 버전으로 업그레이드하기 전에 먼저 업그레이드를 위해 프로젝트를 준비해야 합니다. 마이그레이션하려는 모든 프로젝트에서 다음 섹션에 있는 절차를 반복해 주세요.

마이그레이션 팀은 다음 작업을 실행하여 최신 버전으로 마이그레이션할 수 있도록 프로젝트를 준비해야 합니다.

  1. 모든 프로젝트를 커밋(commit)합니다:

    1. 프로젝트가 소스 컨트롤을 사용할 경우 모든 팀 구성원이 변경 사항을 커밋해야 합니다.

      이렇게 하면 추후 병합 문제를 방지할 수 있습니다.

  2. 마이그레이션할 모든 프로젝트의 최신 버전을 받습니다:

    1. 소스 컨트롤을 사용하는 프로젝트의 경우 모든 프로젝트를 로컬 시스템으로 가져옵니다.

    2. 모든 프로젝트 파일에 읽기 및 작성 권한이 있는지 확인합니다.

      소스 컨트롤을 사용하는 프로젝트의 경우 다양한 하위 폴더로부터 프로젝트 파일(WPROJ)과 모든 Work Unit 파일(WWU)을 체크 아웃해야 할 수 있습니다.

  3. 마이그레이션할 프로젝트를 검토합니다:

    1. 현재 Wwise 버전에서 마이그레이션하려는 각 프로젝트를 열고 저장합니다.

    2. Project Load Log 대화창에 메시지와 수정 제안 사항이 뜰 경우 모두 수락하고 변경 사항을 저장한 다음 프로젝트를 닫습니다. 메시지가 없어질 때까지 이 과정을 반복합니다. 프로젝트 오류를 제거해서 업그레이드를 간단하게 만들어주는 것이 목표입니다.

  4. 마이그레이션할 프로젝트를 태그합니다:

    1. 소스 컨트롤을 사용하는 프로젝트의 경우 업그레이드 전에 먼저 이 프로젝트를 커밋하고 업그레이드하기 전의 마지막 버전으로 태그하거나 라벨을 붙입니다.

      이 시점에서 프로젝트를 커밋하면 마이그레이션 과정 직전의 모든 변경 사항이 기록됩니다. 이제 소스 컨트롤 내역에 표시될 나머지 모든 변경 사항은 마이그레이션과 직접 연관된 작업입니다.

Upgrading Wwise and migrating your project

프로젝트 마이그레이션 과정은 기능이 현저히 달라졌다고 해도 마이그레이션한 프로젝트가 이전 버전 프로젝트에서의 사운드와 최대한 비슷하도록 설계되었습니다. 이러한 기능 변화에 대한 더 많은 정보는 현재 버전의 Wwise 릴리즈 노트와 그 안에 링크로 제공되는 중요한 마이그레이션 노트를 참고해 주세요.

마이그레이션 팀은 먼저 로컬 시스템에서 Wwise 프로젝트를 새로운 Wwise 버전으로 업데이트해야 합니다. 다른 모든 사용자는 마이그레이션 팀이 마이그레이션된 프로젝트를 검토하고 커밋하기 전까지 프로젝트를 변경해서는 안됩니다.

[참고]Wwise 버전 관리

다음 Wwise 버전에서 어떤 기능이 바뀌었는지에 따라 새로운 버전으로 업그레이드할 때 마이그레이션이 필요하지 않을 수도 있습니다.

  • Major Release: 버전의 연도 숫자 혹은 연도 후 첫 번째 소수점이 바뀌었다면 이 버전은 몇 가지 주요 변화가 있는 메이저 출시입니다. 예를 들어 2019.1과 2019.2는 모두 메이저 릴리즈입니다. 이전 Wwise 버전으로 저장한 프로젝트를 그 후의 버전으로 열 경우 Wwise가 프로젝트를 마이그레이션하라는 메시지를 띄웁니다. 수락할 경우 해당 프로젝트는 다시 2019.1 버전으로 열 수 없습니다.

  • Minor Release: 버전의 연도 숫자 혹은 연도 이후 첫 번째 소수점이 같지만 추가 소수점이 서로 다르다면 이 버전은 마이너 출시입니다. 예를 들어 2019.1.3과 2019.1.4는 모두 몇 가지만 변경된 마이너 출시입니다. 이 경우 이전 Wwise 버전으로 저장된 프로젝트를 이후 버전으로 열어도 마이그레이션이 필요하지 않습니다.

  1. Wwise를 업그레이드합니다:

    1. Wwise와 구성 요소 패키지 설치하기에 설명한 대로 로컬 시스템의 Wwise를 업그레이드합니다.

  2. 프로젝트를 새로운 버전으로 마이그레이션합니다:

    1. 현재 Wwise 프로젝트의 모든 파일에 읽기와 쓰기 권한이 있는지 확인합니다.

    2. 백업 프로젝트를 만들어서 시스템이나 네트워크에 있는 다른 폴더에 저장합니다. Wwise가 프로젝트를 자동으로 백업할 것이지만 직접 백업하는 습관을 들이시면 더 좋습니다.

    3. 새로운 Wwise 버전을 엽니다. Project Launcher 대화창이 열리면 마이그레이션하려는 프로젝트를 선택합니다.

      Project Migration 대화창이 열려서 새로운 Wwise 버전으로 프로젝트를 마이그레이션해야 함을 알려줍니다.

      [참고]참고

      Migration 대화 상자는 두 버전을 비교했을 때 프로젝트 파일에 큰 변경 사항이 있을 경우에만 표시됩니다. 프로젝트에 마이그레이션이 필요 없을 경우 Wwise는 다음 마이그레이션 단계로 건너뜁니다.

    4. Migrate를 클릭합니다.

      Wwise가 프로젝트를 마이그레이션합니다. 프로젝트가 마이그레이션되고 나면 Wwise는 기존의 프로젝트 cache 폴더가 현재 Wwise 버전과 호환되는지 확인합니다. 호환되지 않을 경우 Wwise가 프로젝트 cache 폴더를 삭제합니다. 프로젝트 캐시가 삭제되면 다음 메시지가 뜹니다.

    5. OK를 클릭합니다.

    6. Wwise 메뉴 바에서 Views > Utilities > Logs를 클릭합니다. Logs 뷰가 열립니다.

    7. Logs 뷰에서 Project Load 탭을 선택합니다. Project Load 로그가 마이그레이션과 관련된 메시지를 표시하며 새로운 Wwise 버전을 위해 새로운 파일이 생성되었는지를 표시해줍니다.

      [참고]참고

      이 정보는 프로젝트 폴더의 projectname.wproj_migration.log라는 파일 안에 저장됩니다. 필요한 경우 Copy to clipboard(클립보드에 복사하기)를 클릭하여 정보를 저장하면 나중에 참고할 수 있습니다.

    8. 소스 컨트롤을 사용할 경우 마이그레이션 과정 도중 생성된 모든 파일을 시스템에 추가합니다.

    9. Logs 뷰를 닫습니다.

  3. SoundBank를 생성합니다:

    1. 마이그레이션된 프로젝트의 SoundBank를 시험용으로 생성합니다.

Upgrading the Wwise SDK and updating game code

Wwise 저작 애플리케이션 업그레이드뿐만 아니라 다음 작업을 수행하여 Wwise SDK와 게임 코드를 업데이트해야 합니다.

  1. Wwise SDK 업그레이드하기:

    1. 시스템이 Wwise SDK 플랫폼 요구 사항을 준수하는지 확인하세요.

    2. 원하시면 이전 버전의 Wwise SDK를 삭제해도 됩니다.

      또한 샘플 C++ 프로젝트에서 생성한 모든 임시 파일을 직접 제거하는 것이 좋습니다.

    3. 새로운 버전의 Wwise SDK를 설치합니다. 런처를 통해 Wwise 설치하기를 참조하여 Packages 아래에서 SDK (C++)를 선택합니다.

    4. WWISESDK 환경 변수가 새로운 버전의 설치 폴더를 가리키는지 검토합니다. (환경 변수 설정에 대한 더 많은 정보는 여러 버전의 Wwise SDK 사용하기를 참고해 주세요.)

  2. 게임 코드를 최신 버전의 Wwise SDK의로 업데이트합니다.

    1. Wwise SDK 문서에 있는 마이그레이션 노트를 참고해서 어떤 내용을 변경할 것인지 고민해 보세요.

    2. 게임 코드를 마이그레이션하려면 C++ 프로젝트에 있는 기존 기능을 이전 버전에서 새로운 버전의 Wwise SD로 이식해야 합니다. 이 작업 도중 다른 모듈에 있는 코드를 수정하거나 리펙터링해야할 수 있습니다. 게임 코드를 업데이트하기 위해서는 다음 모듈을 변경해야 할 수 있습니다.

      • Sound Engine

      • Memory Manager

      • Stream Manager

      • Communications Module

      [참고]참고

      업데이트한 버전의 새로운 기능의 일부가 게임에 악영향을 끼치지 않도록 하려면 게임에 필요한 컴포넌트를 먼저 업데이트하는 것이 좋습니다. 게임이 안정적으로 실행되는 것을 확인하고 난 후에 필요할 경우 새로운 기능을 통합할 수 있습니다.

    3. 필요한대로 코드를 변경합니다.

      [작은 정보]작은 정보

      코드를 변경할 때 C++ 프로젝트를 자주 다시 빌드하는 것이 좋습니다.

  3. 게임을 빌드합니다.

시험하기

업그레이드를 완료하기 전에 마이그레이션된 게임을 시험해봐야 합니다. 이미 작업 공간에서 사용 중일 수 있는 테스트 프로토콜을 보강하기 위해서 다음 절차를 제공하고 있습니다. 다음 시험은 마이그레이션 팀이 Wwise 저작 애플리케이션과 게임 모두에서 시험해봐야 합니다.

마이그레이션된 게임 프로젝트를 테스트 후 커밋합니다:

  1. 게임에서 사운드와 오디오 작동 방식을 확인합니다. 다음 사항을 확인해주세요:

    • 기본 오디오 재생.

    • 변경한 코드에 의해 영향을 받은 작동 방식.

    • 플랫폼 작동 방식.

    • Wwise 저작 애플리케이션과의 통신.

  2. 마이그레이션된 Wwise 프로젝트와 코드 변경 사항을 소스 컨트롤에 커밋합니다.

시험이 완료되고 결과가 만족스럽다면 다른 사용자들이 최신 Wwise 버전으로 업그레이드하도록 가르쳐줄 준비가 되었습니다.

Upgrading Wwise on all workstations

Wwise 업그레이드, 프로젝트 마이그레이션, SDK 업그레이드, 게임 코드 변경, 로컬 시스템에서의 시험을 성공적으로 끝낸 후 다른 사용자가 각자 작업 환경에서 Wwise를 업그레이드할 수 있습니다.

이 업그레이드는 다음과 같이 Wwise를 사용하는 모든 작업 환경에서 실행되어야 합니다:

  • 빌드 기기

  • 사운드 디자이너의 작업 환경

  • 개발자의 작업 환경

  • 기타 Wwise 사용자 작업 환경

Wwise를 사용하는 모든 작업 환경을 알아내어 업그레이드할 수 있도록 준비하세요.

모든 작업 환경에서 Wwise를 업그레이드합니다:

  1. 원하시면 다음을 포함한 모든 Wwise 구성 요소를 삭제하셔도 됩니다: 여기에는 다음이 포함될 수 있습니다.

    • Wwise 저작 애플리케이션

    • Wwise SDK

    삭제에 대한 더 많은 정보는 Wwise 삭제하기를 참고하세요.

    [참고]참고

    Wwise를 꼭 삭제할 필요는 없습니다. 필요에 따라 동일한 작업 환경에 여러 빌드와 Wwise 버전을 설치해둘 수 있습니다.

  2. 새로운 버전의 Wwise를 설치합니다. 여기에는 다음이 포함될 수 있습니다.

    • Wwise 저작 애플리케이션

    • Wwise SDK

    • Wwise Game Simulator

    설치에 관한 더 많은 정보는 Wwise와 컴포넌트 패키지 설치하기를 참고하세요.

모든 작업 환경에서 마이그레이션한 Wwise 프로젝트에 접근합니다.

  1. 새로운 Wwise 버전을 설치한 후에 마이그레이션된 Wwise 프로젝트를 가져옵니다.

  2. Wwise를 엽니다.

    End-User License Agreement(최종 사용자 라이선스 동의서)가 뜹니다.

  3. 이를 읽고 동의할 경우 Accept(수락)를 클릭합니다.

    Project Launcher 창이 열립니다.

  4. 마이그레이션된 프로젝트를 엽니다.

    [참고]참고

    만약 일부 사용자의 Wwise 프로젝트에 소스 컨트롤에는 없고 로컬에만 저장된 Work Unit이 있을 경우 프로젝트를 새로운 Wwise 버전으로 열 때 이 Work Unit을 마이그레이션할 것인지 묻는 메시지가 뜹니다.

    프로젝트가 로드되기 전에 Wwise는 프로젝트 cache 폴더가 현재 버전과 호환 가능한지 확인합니다. 호환되지 않을 경우 Wwise가 프로젝트 cache 폴더를 삭제합니다. 프로젝트 캐시가 삭제되면 다음 메시지 상자가 뜹니다.

  5. OK를 클릭합니다.

    캐시가 삭제되고 나면 프로젝트가 Wwise에 로드됩니다.


이 페이지가 도움이 되었나요?

지원이 필요하신가요?

질문이 있으신가요? 문제를 겪고 계신가요? 더 많은 정보가 필요하신가요? 저희에게 문의해주시면 도와드리겠습니다!

지원 페이지를 방문해 주세요

작업하는 프로젝트에 대해 알려주세요. 언제든지 도와드릴 준비가 되어 있습니다.

프로젝트를 등록하세요. 아무런 조건이나 의무 사항 없이 빠른 시작을 도와드리겠습니다.

Wwise를 시작해 보세요