코덱 선택
코덱은 TSMP 바이트가 픽셀로 표현되는 방식을 결정합니다.
프로토콜은 헤더와 페이로드의 의미를 정의합니다. 코덱은 그 바이트들을 텍스처 경로로 운반하기 위한 시각적 표현을 정의합니다.
Luma4
Luma4는 TSMP에 포함된 기본 코덱입니다. 샘플 프리팹에서 사용하는 기준 경로이며, 처음 설정하거나 문제를 해결할 때 권장되는 첫 선택입니다.
Luma4를 사용하기 좋은 경우:
- TSMP를 처음 설정하는 경우.
- 캡처 설정을 바꾸기 전에 안정적인 기준 경로가 필요한 경우.
- 문제가 씬 설정인지 전송 경로인지 확인하려는 경우.
- 샘플 프리팹과 기본 설정이 씬과 정확히 맞기를 원하는 경우.
Setup에서 Luma4 사용
TSMPSetup의 Codec 탭에 Luma4 handler가 표시됩니다. 보이지 않는 경우:
- Luma4 패키지가 설치되어 있는지 확인합니다.
Refresh Codecs를 클릭합니다.- 코덱 프리팹과 catalog asset이 있는지 확인합니다.
Apply Setup을 클릭합니다.
송신자와 수신자는 호환되는 Luma4 설정을 사용해야 합니다. 코덱이 맞지 않아도 픽셀은 보일 수 있지만, 디코더가 잘못된 블록이나 바이트 값을 읽을 수 있습니다.
캡처 품질의 중요성
코덱은 전송 경로를 통과한 결과만 디코딩할 수 있습니다. 다음을 피하세요.
- 인코딩 영역의 bilinear/trilinear scaling.
- 색 보정 또는 tone mapping.
- TSMP 영역의 영상 압축.
- 픽셀 값을 바꾸는 OBS filter.
- 헤더나 페이로드 블록을 제거하는 crop.
- TSMP 출력 위에 그려지는 카메라 효과.
디코더가 CRC mismatch를 보고하면 네트워크 컴포넌트를 바꾸기 전에 전송 경로를 먼저 디버깅하세요.
용량과 품질의 균형
텍스처 해상도가 높을수록 페이로드 용량은 커지지만, 렌더링, 캡처, 디코드 비용도 증가합니다.
샘플 기본값으로 시작하세요. Debug canvas에서 payload 사용량이 용량에 가까워지고 불필요한 동기화 데이터를 줄인 뒤에만 해상도를 올리는 것이 좋습니다.