해당 경로에 있는 wave파일을 실행시키는 API이다.
strFileName 파라미터는 wave파일 경로를 설정하며, 파일 경로를 Empty("")로 설정할 경우 현재 플레이중인 wave파일이 있는 경우 플레이를 멈추게된다.
bRepeat 파라미터는 옵션 파라미터로 해당 wave파일을 반복하여 플레이할지 여부로 값을 설정하지 않은 경우 default는 false이다. 주의할점은 bAsync파라미터를 true로 설정한 경우에만 반복적으로 플레이한다.
bAsync 파리미터는 옵션 파라미터로 wave파일의 플레이처리를 동기/비동기로 처리 할지 선택할 수 있는 파라미터이다. 동기방식으로 플레이 할경우 wave파일의 플레이가 끝날때까지 대기하게 된다. 값을 설정 하지 않은 경우 default는 true이다.
| Parameters | Type | Description |
|---|---|---|
| strFileName | STRING | wave 파일 경로 |
| bRepeat | BOOL | [옵션]반복하여 플레이할지 여부(기본값:false) |
| bAsync | BOOL | [옵션]비동기/동기 처리 여부(기본값:true) |
| Type | Description |
|---|---|
| short | 성공,실패 |
** 반환되는값 1 : 성공 0 : 실패 -1 : 실패(해당 경로에 파일이 존재 하지 않는 경우) -2 : 실패(xFrameViewr내부 오류)
전용 브라우저 환경에서만 동작합니다.
function btnPlaywave_on_mouseup()
{
// wave파일 비동기방식으로 한번 출력
factory.xplusplaywave("C:\\WINDOWS\\Media\\ding.wav");
// wave파일 비동기방식으로 반복 출력
factory.xplusplaywave("C:\\WINDOWS\\Media\\ding.wav", true);
}
function btnStopPlaywave_on_mouseup()
{
// 현재 플레중인 wave파일이 있을 경우 멈춤
factory.xplusplaywave("");
}