미디어 재생
오디오 및 비디오를 재생하는 동작입니다. mp3, mp4 등 대부분의 형식의 로컬 파일 및 웹 스트리밍을 지원합니다.

[미디어 플레이어 선택]
사용할 미디어 플레이어를 선택합니다.


[명령]
실행할 명령을 선택합니다.

- 재생 : 로컬 파일 또는 웹 스트리밍을 재생합니다.
- 일시 정지 : 재생을 일시 정지합니다.
- 다시 재생 : 일시 정지된 미디어를 다시 재생합니다.
- 정지 : 재생을 정지합니다.
- 볼륨 조절 : 사운드의 볼륨을 조절합니다.
- 속도 조절 : 재생 속도를 조절합니다.
- 재생 위치 이동 : 미디어의 재생 위치를 이동합니다.
- 현재 상태 읽기 : 미디어의 현재 상태를 읽어옵니다.
[미디어 타입]
미디어의 타입을 선택합니다. [명령]이 “재생”인 경우에만 표시됩니다.

- 파일 : 컨트롤러에 저장된 로컬 파일을 재생합니다. mp3, mp4 등 대부분의 포맷을 지원합니다.
- 스트리밍 : 웹 스트리밍으로부터 재생합니다.
[파일 경로]
컨트롤러에 저장된 로컬 파일의 경로를 입력합니다. [명령]이 “재생”이고 [미디어 타입]이 “파일”인 경우에만 표시됩니다.

[스트리밍 URL]
스트리밍할 URL 주소를 입력합니다. [명령]이 “재생” 이고 [미디어 타입]이 “스트리밍”인 경우에만 표시됩니다.

[재생 종료 대기]
미디어를 재생하는 동안 동작을 대기할지 여부를 설정합니다. 값이 true이면 재생 또는 일시정지 상태에서는 동작이 “진행중…” 상태가 되며, 값이 false이면 재생 시작 후 바로 동작이 “완료” 상태가 됩니다. [명령]이 “재생”인 경우에만 표시됩니다.

[오디오 분석]
실시간으로 오디오를 분석하여 음향의 크기, 주파수 분포등의 정보를 파악할 수 있습니다. [명령]이 “재생”인 경우에만 표시됩니다.

[분석 데이터]
실시간으로 오디오를 분석할 데이터를 구성합니다. [오디오 분석]이 체크된 경우에만 표시됩니다.


> [이름]
분석할 데이터의 이름을 입력합니다. 임의의 이름을 사용할 수 있습니다.

> [데이터 타입]
분석할 데이터의 타입을 선택합니다.

- 전체 평균 세기: 모든 채널의 신호를 평균 (RMS, Root Mean Square) 한 값으로 전체적인 소리의 크기를 나타냅니다.
- 채널별 평균 세기: 특정 채널의 신호를 평균 (RMS, Root Mean Square) 한 값으로 채널별 소리의 크기를 나타냅니다.
- 주파수별 세기: 특정 채널에서 특정 주파수의 세기를 구합니다.
- 최대 세기 주파수: 특정 채널에서 최대 세기을 가지는 주파수와 세기를 구합니다.
- 센트로이드 주파수: 특정 채널에서 센트로이드 주파수를 구합니다. 센트로이드 주파수란 에너지가 집중된 중심 주파수를 의미하며 소리의 밝기(Brightness)를 나타냅니다. 센트로이드 주파수가 높을 수록 밝고 날카로운 소리를, 낮을 수록 어둡고 둔탁한 소리를 가집니다.
> [채널]
분석할 채널의 인덱스 번호를 입력합니다. 오디오 샘플에 따라 채널의 구성은 달라지며 일반적인 채널 번호는 아래와 같습니다.
- 모노: 0
- 스테레오: 0-왼쪽, 1-오른쪽
- 5.1채널: 0-앞 왼쪽, 1-앞 오른쪽, 2-중앙, 3-서브우퍼, 4-뒤 왼쪽, 5-뒤 오른쪽

> [주파수(Hz)]
분석할 주파수를 입력합니다. 일반적으로 사람이 들을 수 있는 주파수의 범위는 20Hz~20000Hz 입니다.

> [세기 (dBFS)]
세기를 저장할 [숫자] 타입의 변수를 선택합니다. dBFS 단위는 디지털 오디오 시스템에서 최대 신호 레벨 (Full Scale)인 0dB 기준으로 상대적인 데시벨 값을 나타낸 것입니다. 그러므로 값은 음수로 표시되며 0에 가까울수록 큰 값을 의미합니다. [데이터 타입]이 “전체 평균 세기”, “채널별 평균 세기”, “주파수별 세기” 인 경우에만 표시됩니다.

> [최대 세기 주파수 (Hz)]
최대 세기를 가진 주파수를 저장할 [숫자] 타입의 변수를 선택합니다. [데이터 타입]이 “최대 세기 주파수” 인 경우에만 표시됩니다.

> [최대 세기 (dBFS)]
최대 세기를 저장할 [숫자] 타입의 변수를 선택합니다. [데이터 타입]이 “최대 세기 주파수” 인 경우에만 표시됩니다.

> [센트로이드 주파수 (Hz)]
센트로이드 주파수를 저장할 [숫자] 타입의 변수를 선택합니다. [데이터 타입]이 “센트로이드 주파수” 인 경우에만 표시됩니다.

[볼륨]
오디오 출력의 볼륨을 0~100% 사이의 값으로 입력합니다. [명령] 이 “볼륨 조절”인 경우에만 표시됩니다.

[재생 속도]
재생 속도를 선택하거나 직접 입력합니다. [명령]이 “속도 조절”인 경우에만 표시됩니다.

[재생 위치]
이동할 재생 위치를 입력합니다. [명령]이 “재생 위치 이동”인 경우에만 표시됩니다.

[상태]
미디어의 현재 상태를 저장할 [숫자] 타입의 변수를 선택합니다. [명령]이 “현재 상태 읽기”인 경우에만 표시됩니다.

변수의 값에 따른 상태는 아래와 같습니다.
- 0 : 초기 상태
- 1 : 재생중
- 2 : 일시 정지
- 3 : 정지
- 4 : 재생 완료
- 5 : 에러