버전

menu_open

Migrating your projects

When you are ready to upgrade to a new major version of Wwise, you must follow a coordinated protocol to ensure that your projects created in an earlier version are migrated smoothly to the later version. The goal is to avoid putting any aspect of your game at risk, so you must examine the changes in the new version and selectively and systematically implement any modifications to your game code.

The protocol for upgrade and migration can vary depending on the following conditions:

  • Projects under source control: The project must be checked in at key points.

  • Multiple users: The Wwise upgrade, project migration, SDK upgrade, and game code update must be completed on a local system before multiple users can upgrade Wwise on their workstations.

  • Integrated game project: The game code must be modified as specified in the migration notes.

We strongly recommend that a migration team, composed of one or two designated individuals, perform the following tasks on a local system first:

After the migration team has carried out these tasks, you can proceed with:

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

Preparing your projects for migration

Before you upgrade to a new version of Wwise, you must prepare your projects for the upgrade, particularly if your Wwise project has been integrated into a game. 마이그레이션하려는 모든 프로젝트에서 다음 섹션에 있는 절차를 반복해 주세요.

The migration team must carry out the following tasks to prepare projects to be migrated to the latest version.

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

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

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

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

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

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

      For projects under source control, you might need to check out the project file (WPROJ) and all Work Unit files (WWU) from the various subfolders.

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

    1. In the current version of Wwise, open each project that you plan to migrate and save.

    2. If the Project Load Log dialog displays messages and suggested fixes, accept these fixes, save the changes, and close the project. 메시지가 없어질 때까지 이 과정을 반복합니다. 프로젝트 오류를 제거해서 업그레이드를 간단하게 만들어주는 것이 목표입니다.

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

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

      Committing the project at this point records all changes made prior to the migration process. 이제 소스 컨트롤 내역에 표시될 나머지 모든 변경 사항은 마이그레이션과 직접 연관된 작업입니다.

Upgrading Wwise and migrating your project

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

We recommend that the migration team migrates the Wwise project to the new Wwise version on a local system first. All other users must not modify the project until the migrated project has been tested and then committed by the migration team.

[참고]참고

Depending on the types of changes made to Wwise from one version to another, your projects might not need to be migrated when upgrading to a new version.

  • Major Release: 버전의 연도 숫자 혹은 연도 후 첫 번째 소수점이 바뀌었다면 이 버전은 몇 가지 주요 변화가 있는 메이저 출시입니다. For example, 2019.1 and 2019.2 were both major releases. When opening a project saved in the former version of Wwise with the latter version, Wwise will prompt you to migrate the project. If you accept, it's no longer possible to open that project with the 2019.1 version.

  • Minor Release: 버전의 연도 숫자 혹은 연도 이후 첫 번째 소수점이 같지만 추가 소수점이 서로 다르다면 이 버전은 마이너 출시입니다. For example, 2019.1.3 and 2019.1.4 were both minor releases with only a few changes. When opening a project saved in the former version of Wwise with the latter version, no migration is necessary.

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

    1. Upgrade Wwise on your local system as described in Installing Wwise and Component Packages.

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

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

    2. 백업 프로젝트를 만들어서 시스템이나 네트워크에 있는 다른 폴더에 저장합니다. The project will be backed up automatically by Wwise, but it is good practice to create your own backup as well.

    3. Open the new version of Wwise. In the Project Launcher dialog that opens, select the project you plan to migrate.

      The Project Migration dialog opens prompting you to migrate the project to the later version of Wwise.

      [참고]참고

      The Migration dialog is only displayed when significant changes have been made to the project file between versions. 프로젝트에 마이그레이션이 필요 없을 경우 Wwise는 다음 마이그레이션 단계로 건너뜁니다.

    4. Click Migrate.

      Wwise migrates the project. 프로젝트가 마이그레이션되고 나면 Wwise는 기존의 프로젝트 cache 폴더가 현재 Wwise 버전과 호환되는지 확인합니다. 호환되지 않을 경우 Wwise가 프로젝트 cache 폴더를 삭제합니다. When the project cache is deleted, the following message is displayed.

    5. OK를 클릭합니다.

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

    7. Logs 뷰에서 Project Load 탭을 선택합니다. The Project Load log displays messages related to the migration and indicates if any files were created for the new version of Wwise.

      [참고]참고

      This information is stored in the file named projectname.wproj_migration.log in the project folder. If needed, you can click Copy to clipboard to save this information for later reference.

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

    9. Logs 뷰를 닫습니다.

  3. SoundBank를 생성합니다:

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

Upgrading the Wwise SDK and updating game code

In addition to upgrading the Wwise authoring application, carry out the following tasks to upgrade the Wwise SDK and update the game code.

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

    1. Confirm that your system meets the Wwise SDK Platform Requirements.

    2. Optionally, uninstall the earlier version of the Wwise SDK.

      It's good practice to also manually remove any temporary files created by the sample C++ projects.

    3. Install the later version of the Wwise SDK. Refer to Install Wwise through the Launcher and select SDK (C++) under Packages.

    4. Verify that the WWISESDK environment variable points to the installation folder of the later version. (환경 변수 설정에 대한 더 많은 정보는 여러 버전의 Wwise SDK 사용하기를 참고해 주세요.)

  2. Update the game code for the later version of the Wwise SDK:

    1. Refer to the migration notes in the Wwise SDK documentation to familiarize yourself with the modifications you will be making.

    2. To migrate the game code, you must port the existing functionalities of the C++ project from the earlier version of the Wwise SDK to the later version. This task might include modifying or refactoring code in different modules. Changes to the following modules might need to be addressed to update the game code:

      • Sound Engine

      • Memory Manager

      • Stream Manager

      • Communications Module

      [참고]참고

      To ensure that your game is not adversely affected by some of the new features in the later version, we recommend you first upgrade the components that you need for your game. 게임이 안정적으로 실행되는 것을 확인하고 난 후에 필요할 경우 새로운 기능을 통합할 수 있습니다.

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

      [작은 정보]작은 정보

      It's good practice to rebuild the C++ project often when you are modifying the code.

  3. 게임을 빌드합니다.

시험하기

Before you can complete the upgrade and migration, you need to test the migrated game. To augment any testing protocol you might already use at your workplace, we have included a procedure. We recommend these tests are carried out by the migration team in both the Wwise authoring application and the game.

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

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

    • 기본 오디오 재생.

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

    • 플랫폼 작동 방식.

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

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

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

Upgrading Wwise on all workstations

After Wwise has been upgraded, the project has been successfully migrated, the SDK has been upgraded, game code changes have been made, and testing is completed on a local system, you are ready to advise other users to upgrade Wwise on their workstations.

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

  • 빌드 기기

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

  • 개발자의 작업 환경

  • 기타 Wwise 사용자 작업 환경

Ensure you have identified all the workstations that run Wwise so that you can upgrade them all.

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

  1. 원하시면 다음을 포함한 모든 Wwise 구성 요소를 삭제하셔도 됩니다: This might include:

    • Wwise 저작 애플리케이션

    • Wwise SDK

    For more information on uninstalling, refer to Uninstalling Wwise.

    [참고]참고

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

  2. Install the later version of Wwise. This might include:

    • Wwise 저작 애플리케이션

    • Wwise SDK

    • Wwise Game Simulator

    For more information about installing, refer to Installing Wwise and Component Packages.

Access the migrated Wwise project on all workstations:

  1. After you have installed the later version of Wwise, retrieve the migrated Wwise project.

  2. Wwise를 엽니다.

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

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

    Project Launcher 창이 열립니다.

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

    [참고]참고

    If some users have Work Units in the Wwise project that have been saved locally and are not under source control, a message appears prompting them to accept that these Work Units will be migrated when the project opens in the new version of Wwise.

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

  5. OK를 클릭합니다.

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


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

지원이 필요하신가요?

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

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

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

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

Wwise를 시작해 보세요