XMA2 개요

XBOX One에서 XMA2 오디오 압축 해제는 하드웨어로 구현됩니다. 그러나 xWMA는 그렇지 않으며 소프트웨어 디코딩이 필요합니다. XMA2와 xWMA는 모두 동일한 압축 알고리즘을 사용하지만, xWMA는 더 광범위한 인코딩 형식을 제공합니다. 성능과 압축 이점을 위해 XMA2로 인코딩하되, 일부 고품질 음악은 xWMA로 렌더링될 때 더 잘 들릴 수 있으므로 청취 테스트가 필요할 수 있습니다. XAudio2를 통해 XMA2를 코딩하는 것이 가장 간단한 접근 방식이지만, Audio Control Processor(ACP) 명령을 사용하여 XMA2를 하드웨어에 직접 코딩할 수도 있습니다.

xWMA와 XMA2는 모두 Windows Media Audio(WMA)용으로 개발된 코덱에서 유래했으며, 둘 다 XBOX 게임용으로 특별히 개발되었습니다. XMA2에서 사용하는 사용 가능한 코덱과 매개변수의 부분집합은 xWMA에서 사용하는 부분집합보다 작습니다. xWMA와 XMA2 모두 XBOX용으로 개발되었지만, 서로 교환 가능하지 않습니다: 각 파일 형식의 헤더가 다르며 형식은 PC 버전의 Windows와 호환되지 않습니다. XMA2와 xWMA에서 사용하는 코덱도 약간 다르므로 각각은 사용된 압축 시스템에서 자체 아티팩트를 갖게 됩니다.

이 항목에서는 다음을 다룹니다:

XMA2 인코딩
XMA2 AXI 버스 오류

XMA2 인코딩

Microsoft Game Development Kit(GDK)의 일부로 제공되는 XMA2 인코더 도구를 사용하여 오디오 데이터를 XMA2로 인코딩하십시오. XMA2 파일은 XMA2WAVEFORMATEX 형식 헤더와 Seek 위치 테이블 내의 추가 seek 청크를 가진 .wav 파일입니다. XMA2 형식은 XBOX 360과 호환되며, Seek 테이블은 XBOX One의 경우 ULONG 바이트 스왑되어야 합니다. 입력이 .wav 파일이라면 출력은 변경 없이 사용할 수 있습니다. Seek 테이블을 바이트 스왑하려면 다음 코드 줄을 사용하십시오.

      for(UINT32 i = 0;(i < xmaformat->BlockCount);i++)
      {
      rgpXMASeekTable[i] = _byteswap_ulong(rgpXMASeekTable[i]);
      }  

먼저 앱에 이 코드를 추가하여 기능을 테스트한 다음, 앱에서 사전 처리가 필요하지 않도록 스왑을 수행하는 별도의 도구를 작성하는 것을 고려하십시오. XBOX One의 경우, 플로우그래프와 함께 사용되는 모든 Direct Memory Access(DMA) 입력 및 출력 버퍼와 소스 버퍼에 제출되는 모든 XMA 콘텐츠는 ApuAlloc 메서드를 사용하여 할당되고 ApuFree 메서드를 사용하여 해제되어야 합니다. 이는 다음 코드에 나와 있습니다. 블록이 올바르게 정렬되도록 SHAPE_XMA_INPUT_BUFFER_ALIGNMENT 플래그의 사용에 유의하십시오.

      HRESULT ApuVirtualAllocate(void** virtualAddress,UINT32 sizeInBytes)
      {
        DWORD dwsize = sizeInBytes;
        DWORD change = 0;
        if(FixBlockAlign((DWORD*)&sizeInBytes,SHAPE_XMA_INPUT_BUFFER_SIZE_ALIGNMENT,&change)) // Returns TRUE if an alignment was needed; else, returns FALSE.
        {
          return E_INVALIDARG;
        }
        return ApuAlloc(virtualAddress,NULL,sizeInBytes,SHAPE_XMA_INPUT_BUFFER_ALIGNMENT);
      }

      void ApuVirtualFree(void* virtualAddress)
      {
        if(virtualAddress)
        {
          ApuFree(virtualAddress);
        }
      }

      BOOL FixBlockAlign(DWORD* pBYTES,DWORD BLOCKALIGN,DWORD* pChange)
      {
        if(pBYTES && (BLOCKALIGN > 1))
        {
          DWORD bytes = (*pBYTES);
          (*pBYTES) /=  BLOCKALIGN;
          (*pBYTES) *=  BLOCKALIGN;
          if(pChange)
          {
            (*pChange) = bytes&mdash;(*pBYTES);
            if((*pChange) > 0)
            {
              return TRUE;
            }
          }
        }
        return FALSE;
      }  

XMA2로 인코딩된 파일에서 구조의 필드를 사용하는 방법에 대한 자세한 내용은 XMA2WAVEFORMATEX 구조를 참고하십시오.

XMA2 AXI 버스 오류

XMA 하드웨어 디코더(및 XBOX 360)의 오랜 버그는 AcpHal을 직접 사용하는 경우 타이틀이 우회 방법을 제공하도록 요구합니다. XAudio2는 이미 우회 방법을 제공합니다. 그러나 XMA2 인코더 도구가 업데이트될 때까지 다음 정보를 유의하십시오. XMA 비트 스트림을 디코딩하고 단일 XMA 입력 버퍼만 사용할 때, XMA 버퍼의 마지막 64바이트에 인코딩된 데이터가 포함되어 있으면 AXI 버스 오류를 트리거할 수 있습니다. XMA 비트 스트림에 마지막 64바이트 내에 인코딩된 데이터가 포함되는 경우는 드뭅니다. 그럼에도 불구하고 이는 AXI 버스 오류를 방지하기 위해 처리되어야 합니다. XMA2 인코더 도구가 비트 스트림의 마지막 64바이트에 인코딩된 데이터가 포함된 인코딩된 파일이 없도록 업데이트될 때까지, 다음 방법 중 하나를 사용하여 이 문제를 피할 수 있습니다.

항상 두 XMA 입력 버퍼를 모두 사용하고, 어느 입력 버퍼의 포인터도 유효하지 않은 값으로 설정하지 마십시오.
다른 버퍼를 활성화하지 않더라도 사용되지 않은 입력 버퍼의 포인터를 다른 입력 버퍼의 포인터와 동일하게 설정하십시오. 예:

      context->ptrRead1 = context->ptrRead0

콘텐츠를 생성하는 동안 오프라인 도구를 사용하여 XMA 파일을 스캔하십시오. 인코딩된 XMA 비트 스트림의 마지막 64바이트 중 하나라도 0xFF 이외의 값이 있으면 파일을 다시 인코딩하십시오.

이러한 방법 중 하나는 XMA prefetcher가 유효하지 않은 주소를 읽는 것을 방지합니다.

참조 API 문서

APU (API contents)
- Functions
  - ApuAlloc
  - ApuFree
XMA2Defs (API contents)
- Structures
  - XMA2WAVEFORMATEX

함께 보기

XMA2 인코더 도구

GDK and Game Engines Integration

Steam porting guide

Game Principles

Core Features

Console Features

XMA2 인코딩

XMA2 AXI 버스 오류

참조 API 문서

함께 보기

​XMA2 인코딩

​XMA2 AXI 버스 오류

​참조 API 문서

​함께 보기

XMA2 인코딩

XMA2 AXI 버스 오류

참조 API 문서

함께 보기