오디오 동기화 그룹 디버그 함수 설명
개요
이 문서는 audio_sync_group_debug 함수에 대한 설명입니다. 이 함수는 더 이상 사용되지 않으므로 audio_debug 함수를 대신 사용해야 합니다. 이 함수는 지정된 동기화 그룹에 대한 디버그 정보를 표시합니다. 동기화 그룹의 인덱스는 audio_create_sync_group 함수를 사용할 때 반환되는 값입니다. 인덱스를 -1로 설정하면 오버레이를 끌 수 있습니다.
디버깅 정보
오디오 동기화 그룹을 디버깅 할 때 오버레이에는 다음 정보가 표시됩니다:
- 디버깅 중인 동기화 그룹: 어떤 그룹이 디버깅 되는지.
- 채널 수: 동기화 그룹의 총 채널 수.
- 실패 횟수: 그룹이 실패한 횟수 (너무 많은 작업을 시도했음을 의미).
- 채널 목록:
- 빨간색: 현재 작업을 수행하지 않는 채널
- 노란색: 초기 상태 (디코딩 또는 재생되지 않음)
- 초록색: 현재 추적 중/디코딩 중
- 보라색: 데이터가 소진된 채널
- 프로파일링 막대: 디코딩 스레드가 수행하고 있는 작업을 표시합니다:
- 파란색: 파일이 처음 읽히고 있는 중
- 빨간색: 스레드가 파일을 읽어 위치를 찾고 있음
- 초록색: 스레드가 데이터 디코딩 중
- 보라색: 스레드가 작업할 필요가 없을 때 잠자고 있음
문법
audio_sync_group_debug(group_index);
인수 설명
| 인수 이름 | 타입 | 설명 |
|---|---|---|
| group_index | Audio Sync Group ID | 디버깅할 그룹 인덱스 또는 -1 (디버깅 끔) |
반환값
N/A
예제 코드
디버그 모드에서 오디오 동기화 그룹 디버그 오버레이를 켜거나 끄는 방법은 다음과 같습니다:
if (debug_mode) {
audio_sync_group_debug(sg);
} else {
audio_sync_group_debug(-1);
}
위 코드는 게임이 디버그 모드에서 실행 중인지 여부에 따라 sg 변수에 있는 동기화 그룹 인덱스를 표시하거나 디버깅을 끕니다.
활용 및 응용 예제
- 디버깅 시뮬레이션: 게임의 동기화 그룹에 다양한 파일을 추가하여 디버깅 정보를 확인합니다.
gml audio_create_sync_group(); audio_sync_group_debug(0); // 그룹 인덱스 0 디버깅 시작 - 사용자 인터페이스와의 통합: 게임의 UI에 버튼을 추가하여 오디오 디버그 표시를 켜거나 끌 수 있도록 합니다.
gml if (ui_button_debug_pressed()) { audio_sync_group_debug(sg); // 버튼 클릭 시 디버깅 시작 } else { audio_sync_group_debug(-1); // 버튼 클릭이 아닐 경우 종료 } - 동기화를 유지하는 알고리즘 구현: 여러 동기화 그룹을 동시에 오버레이하여서 각 그룹의 상태를 분석합니다.
gml for (var i = 0; i < number_of_sync_groups; i++) { audio_sync_group_debug(i); // 모든 그룹 디버깅 }
다음 단계
옵션으로, 일반 오디오 디버깅을 위한 audio_debug 함수를 사용할 수 있습니다.
© 저작권 YoYo Games Ltd. 2024 모든 권리 보유.