개요

모바일 기기에서 오디오 파일을 재생합니다.

지원 환경

Desktop NRE		Desktop WRE
☐ Windows	☐ macOS	☐ Edge	☐ Chrome	☐ Safari	☐ Firefox	☐ Opera
Mobile NRE		Mobile WRE
☑ Android	☑ iOS/iPadOS	☐ Android	☐ iOS/iPadOS

속성

currentpos

모바일기기에서 재생중인 오디오파일의 현재 재생위치를 밀리초(milliseconds) 단위로 갖는 읽기전용 속성입니다.

지원 환경

Desktop NRE		Desktop WRE
☐ Windows	☐ macOS	☐ Edge	☐ Chrome	☐ Safari	☐ Firefox	☐ Opera
Mobile NRE		Mobile WRE
☑ Android	☑ iOS/iPadOS	☐ Android	☐ iOS/iPadOS

속성 타입

☐ Enum

☐ Expr

☐ Control

☑ Hidden

☑ ReadOnly

☐ Bind

☐ Collection

☐ StringResource

참고

- currentpos 속성값은 onload 또는 onplaying 이벤트가 발생한 경우에 설정됩니다.

duration

로드된 오디오파일의 총 재생시간을 밀리초(milliseconds)단위로 갖는 읽기전용 속성입니다.

지원 환경

Desktop NRE		Desktop WRE
☐ Windows	☐ macOS	☐ Edge	☐ Chrome	☐ Safari	☐ Firefox	☐ Opera
Mobile NRE		Mobile WRE
☑ Android	☑ iOS/iPadOS	☐ Android	☐ iOS/iPadOS

속성 타입

☐ Enum

☐ Expr

☐ Control

☑ Hidden

☑ ReadOnly

☐ Bind

☐ Collection

☐ StringResource

참고

- duration 속성값은 onload 또는 onplaying 이벤트가 발생한 경우에 설정됩니다.

id

AudioPlayer의 고유 식별자를 설정하는 속성입니다.

지원 환경

Desktop NRE		Desktop WRE
☐ Windows	☐ macOS	☐ Edge	☐ Chrome	☐ Safari	☐ Firefox	☐ Opera
Mobile NRE		Mobile WRE
☑ Android	☑ iOS/iPadOS	☐ Android	☐ iOS/iPadOS

속성 타입

☐ Enum

☐ Expr

☐ Control

☐ Hidden

☑ ReadOnly

☐ Bind

☐ Collection

☐ StringResource

문법

AudioPlayer.id

문법 설정

id	AudioPlayer를 구별할 수 있는 유일값을 갖습니다.

참고

-  addChild나 insertChild 메소드를 사용하여 컴포넌트를 등록할때 parent 가 자식컴포넌트를 구별하기 위한 고유한 key값입니다.

- 속성명이나 메소드명과 같은 예약어를 id 속성값으로 설정할 경우 오류가 발생할 수 있습니다.

- 컴포넌트의 속성은 아니지만 편의를 위하여 넥사크로 스튜디오에서 설정할 수 있는 기능이 제공됩니다.

- name 속성은 사용자가 지정한 컴포넌트의 이름으로 논리적으로 중복이 가능합니다.

- 넥사크로 스튜디오에서 컴포넌트를 생성하거나 id 값을 설정하면 name 속성에 동일한 값이 설정됩니다.

name

AudioPlayer 의 이름을 설정하는 속성입니다.

지원 환경

Desktop NRE		Desktop WRE
☐ Windows	☐ macOS	☐ Edge	☐ Chrome	☐ Safari	☐ Firefox	☐ Opera
Mobile NRE		Mobile WRE
☑ Android	☑ iOS/iPadOS	☐ Android	☐ iOS/iPadOS

속성 타입

☐ Enum

☐ Expr

☐ Control

☑ Hidden

☐ ReadOnly

☐ Bind

☐ Collection

☐ StringResource

문법

AudioPlayer.name[= strName]

문법 설정

strName	컴포넌트의 이름을 설정합니다.

참고

- name 속성은 사용자가 지정한 컴포넌트의 이름으로 논리적으로 중복이 가능합니다.

- 넥사크로 스튜디오에서 컴포넌트를 생성하거나 id 값을 설정하면 name 속성에 동일한 값이 설정됩니다.

pan

모바일 기기에서 스피커의 밸런스를 설정하는 속성입니다.

지원 환경

Desktop NRE		Desktop WRE
☐ Windows	☐ macOS	☐ Edge	☐ Chrome	☐ Safari	☐ Firefox	☐ Opera
Mobile NRE		Mobile WRE
☑ Android	☑ iOS/iPadOS	☐ Android	☐ iOS/iPadOS

속성 타입

☐ Enum

☐ Expr

☐ Control

☐ Hidden

☐ ReadOnly

☐ Bind

☐ Collection

☐ StringResource

문법 설정

this.AudioPlayer00.pan = 0.5;
nPan	오디오파일 재생 시작 시 적용될 왼쪽 스피커의 밸런스를 "0.0 ~ 1.0" 범위의 실수값으로 설정합니다. "0" 설정 시 왼쪽 스피커만 사용합니다. "0.5" 설정 시 좌우 스피커를 동일하게 사용합니다. "1" 설정 시 오른쪽 스피커만 사용합니다. "-1" 설정 시 모바일에 설정되어 있는 밸런스값이 적용됩니다

this.AudioPlayer00.pan = 0.5;

nPan

오디오파일 재생 시작 시 적용될 왼쪽 스피커의 밸런스를 "0.0 ~ 1.0" 범위의 실수값으로 설정합니다.

"0" 설정 시 왼쪽 스피커만 사용합니다.

"0.5" 설정 시 좌우 스피커를 동일하게 사용합니다.

"1" 설정 시 오른쪽 스피커만 사용합니다.

"-1" 설정 시 모바일에 설정되어 있는 밸런스값이 적용됩니다

참고

- pan 속성값을 설저하지 않으면 "-1" 로 적용됩니다.

- pan 속성값을 "0.3" 으로 설정 시 오른쪽 스피커에 30% 음량이, 왼쪽 스피커에 70% 의 음량이 적용됩니다.

parent

AudioPlayer 의 부모 오브젝트를 갖는 읽기전용 속성입니다.

지원 환경

Desktop NRE		Desktop WRE
☐ Windows	☐ macOS	☐ Edge	☐ Chrome	☐ Safari	☐ Firefox	☐ Opera
Mobile NRE		Mobile WRE
☑ Android	☑ iOS/iPadOS	☐ Android	☐ iOS/iPadOS

속성 타입

☐ Enum

☐ Expr

☐ Control

☑ Hidden

☑ ReadOnly

☐ Bind

☐ Collection

☐ StringResource

문법

AudioPlayer.parent

문법 설정

var objParent = this.AudioPlayer00.parent;

참고

- parent 속성은 일반적으로 컴포넌트가 속한 Form을 갖습니다.

- AudioPlayer 이(가) Div 와 같은 컨테이너 컴포넌트에 자식으로 존재한다면 parent 속성은 해당 컨테이너 컴포넌트를 갖습니다.

- Calendar 와 같이 서브컨트롤이 존재하는 컴포넌트에서 서브컨트롤의 parent 속성은 해당 컴포넌트를 갖습니다.

repeatcount

모바일 기기에서 오디오 파일의 반복재생 횟수를 설정하는 속성입니다.

지원 환경

Desktop NRE		Desktop WRE
☐ Windows	☐ macOS	☐ Edge	☐ Chrome	☐ Safari	☐ Firefox	☐ Opera
Mobile NRE		Mobile WRE
☑ Android	☑ iOS/iPadOS	☐ Android	☐ iOS/iPadOS

속성 타입

☐ Enum

☐ Expr

☐ Control

☐ Hidden

☐ ReadOnly

☐ Bind

☐ Collection

☐ StringResource

문법 설정

this.AudioPlayer00.repeatcount = 3;
nRepeatCount	오디오 파일의 반복재생 횟수를 정수로 설정합니다. "0" 설정 시 오디오 파일을 무한 반복재생합니다. "1" 설정 시 오디오 파일을 반복재생하지 않습니다.

this.AudioPlayer00.repeatcount = 3;

nRepeatCount

오디오 파일의 반복재생 횟수를 정수로 설정합니다.

"0" 설정 시 오디오 파일을 무한 반복재생합니다.

"1" 설정 시 오디오 파일을 반복재생하지 않습니다.

참고

- repeatcount 속성값을 설정하지 않으면 "1" 로 적용됩니다.

startpos

모바일 기기에서 구간 반복 시 구간의 시작지점을 설정하는 속성입니다.

지원 환경

Desktop NRE		Desktop WRE
☐ Windows	☐ macOS	☐ Edge	☐ Chrome	☐ Safari	☐ Firefox	☐ Opera
Mobile NRE		Mobile WRE
☑ Android	☑ iOS/iPadOS	☐ Android	☐ iOS/iPadOS

속성 타입

☐ Enum

☐ Expr

☐ Control

☐ Hidden

☐ ReadOnly

☐ Bind

☐ Collection

☐ StringResource

문법 설정

this.AudioPlayer00.startpos = 1000;
nStartPos	전체 오디오 재생시간 중 구간반복 시작지점의 시간을 밀리초(milliseconds) 단위의 숫자로 설정합니다. "-1" 설정 시 구간반복의 시작지점을 설정하지 않습니다.

this.AudioPlayer00.startpos = 1000;

nStartPos

전체 오디오 재생시간 중 구간반복 시작지점의 시간을 밀리초(milliseconds) 단위의 숫자로 설정합니다.

"-1" 설정 시 구간반복의 시작지점을 설정하지 않습니다.

참고

- startpos 속성값을 설정하지 않으면 -1 로 적용됩니다.

- 오디오파일이 로딩되면 -1 로 재설정 됩니다.

stoppos

모바일 기기에서 구간 반복 시 구간의 끝지점을 설정하는 속성입니다.

지원 환경

Desktop NRE		Desktop WRE
☐ Windows	☐ macOS	☐ Edge	☐ Chrome	☐ Safari	☐ Firefox	☐ Opera
Mobile NRE		Mobile WRE
☑ Android	☑ iOS/iPadOS	☐ Android	☐ iOS/iPadOS

속성 타입

☐ Enum

☐ Expr

☐ Control

☐ Hidden

☐ ReadOnly

☐ Bind

☐ Collection

☐ StringResource

문법 설정

this.AudioPlayer00.stoppos = 5000;
nStoppos	전체 오디오 재생시간 중 구간반복 끝지점의 시간을 밀리초(milliseconds) 단위의 숫자로 설정합니다. "-1" 설정 시 구간반복의 끝지점을 설정하지 않습니다.

this.AudioPlayer00.stoppos = 5000;

nStoppos

전체 오디오 재생시간 중 구간반복 끝지점의 시간을 밀리초(milliseconds) 단위의 숫자로 설정합니다.

"-1" 설정 시 구간반복의 끝지점을 설정하지 않습니다.

참고

- stoppos 속성값을 설정하지 않으면 "-1" 로 적용됩니다.

- 오디오파일이 로딩되면 "-1"로 재설정 됩니다.

url

AudioPlayer 에 로드된 오디오파일의 경로를 갖는 읽기전용 속성입니다.

지원 환경

Desktop NRE		Desktop WRE
☐ Windows	☐ macOS	☐ Edge	☐ Chrome	☐ Safari	☐ Firefox	☐ Opera
Mobile NRE		Mobile WRE
☑ Android	☑ iOS/iPadOS	☐ Android	☐ iOS/iPadOS

속성 타입

☐ Enum

☐ Expr

☐ Control

☑ Hidden

☑ ReadOnly

☐ Bind

☐ Collection

☐ StringResource

참고

- url 속성값은 load() 메소드가 수행될 때 설정됩니다.

volume

모바일 기기에서 오디오 파일 재생 시 볼륨값을 설정하는 속성입니다.

지원 환경

Desktop NRE		Desktop WRE
☐ Windows	☐ macOS	☐ Edge	☐ Chrome	☐ Safari	☐ Firefox	☐ Opera
Mobile NRE		Mobile WRE
☑ Android	☑ iOS/iPadOS	☐ Android	☐ iOS/iPadOS

속성 타입

☐ Enum

☐ Expr

☐ Control

☐ Hidden

☐ ReadOnly

☐ Bind

☐ Collection

☐ StringResource

문법 설정

this.AudioPlayer00.volume = 0.7;
nVolume	오디오파일 재생 시작 시 적용될 볼륨값을 0.0~1.0 범위의 실수값으로 설정합니다. -1 설정 시 모바일에 설정되어 있는 볼륨값이 적용됩니다.

this.AudioPlayer00.volume = 0.7;

nVolume

오디오파일 재생 시작 시 적용될 볼륨값을 0.0~1.0 범위의 실수값으로 설정합니다.

-1 설정 시 모바일에 설정되어 있는 볼륨값이 적용됩니다.

참고

- volumn 속성값을 설정하지 않으면 -1 로 적용됩니다.

- iOS/iPadOS NRE 는 모바일 기기에 설정된 시스템 볼륨이 최대값으로 적용되므로 volumn 속성에 시스템 볼륨값보다 큰 값을 설정하여도 시스템 볼륨값으로 적용됩니다.

메서드

load

AudioPlayer 에 오디오파일을 로딩하는 메소드입니다.

지원 환경

Desktop NRE		Desktop WRE
☐ Windows	☐ macOS	☐ Edge	☐ Chrome	☐ Safari	☐ Firefox	☐ Opera
Mobile NRE		Mobile WRE
☑ Android	☑ iOS/iPadOS	☐ Android	☐ iOS/iPadOS

문법

AudioPlayer.load(strUrl)

파라미터

Parameters	Type	Description
strUrl	String	로딩할 오디오 파일의 위치를 URL 형식의 문자열로 설정합니다. 모바일 기기에 저장된 오디오 파일은 Alias 를 사용하여 문자열로 설정합니다.
this.AudioPlayer00.load( "%USERAPP%filename.mp3" );

Parameters

Type

Description

strUrl

String

로딩할 오디오 파일의 위치를 URL 형식의 문자열로 설정합니다.

모바일 기기에 저장된 오디오 파일은 Alias 를 사용하여 문자열로 설정합니다.

this.AudioPlayer00.load( "%USERAPP%filename.mp3" );

반환

Type	Description
Boolean	메소드 실행에 성공하면 "true"를 반환하고, onload 이벤트가 발생합니다. 메소드 실행에 실패하면 "true"를 반환하고, onerror 이벤트가 발생합니다. strUrl 값이 생략된 경우 "false"를 반환합니다.

Type

Description

Boolean

메소드 실행에 성공하면 "true"를 반환하고, onload 이벤트가 발생합니다.

메소드 실행에 실패하면 "true"를 반환하고, onerror 이벤트가 발생합니다.

strUrl 값이 생략된 경우 "false"를 반환합니다.

참고

- 오디오 파일을 정상적으로 로딩하면 오디오파일 위치가 url 속성에 저장됩니다.

- 모바일 기기의 경로에 사용되는 Alias 실제경로입니다.



  * %USERAPP% : 애플리케이션에서 할당받은 공간, 다른 애플리케이션 접근불가
  * %SD_CARD% : 모바일 기기의 SD카드 메모리 공간, 다른 애플리케이션 접근가능

movePos

모바일 기기에서 오디오파일의 재생위치를 특정 부분으로 이동하는 메소드입니다.

지원 환경

Desktop NRE		Desktop WRE
☐ Windows	☐ macOS	☐ Edge	☐ Chrome	☐ Safari	☐ Firefox	☐ Opera
Mobile NRE		Mobile WRE
☑ Android	☑ iOS/iPadOS	☐ Android	☐ iOS/iPadOS

문법

AudioPlayer.movePos(nPos)

파라미터

Parameters	Type	Description
nPos	Number	오디오파일의 재생 위치를 밀리초(milliseconds) 단위의 숫자로 설정합니다. 이동 위치는 "0ms ~ duration속성값" 사이의 값을 설정할 수 있습니다.
this.AudioPlayer.movePos(1000);

Parameters

Type

Description

nPos

Number

오디오파일의 재생 위치를 밀리초(milliseconds) 단위의 숫자로 설정합니다.

이동 위치는 "0ms ~ duration속성값" 사이의 값을 설정할 수 있습니다.

this.AudioPlayer.movePos(1000);

반환

Type	Description
Boolean	메소드 실행에 성공하면 "true"를 반환하고, onmovepos 이벤트가 발생합니다. 메소드 실행에 실패하거나 파라미터값을 잘 못 설정하면 "false"를 반환하고, onerror 이벤트가 발생합니다.

Type

Description

Boolean

메소드 실행에 성공하면 "true"를 반환하고, onmovepos 이벤트가 발생합니다.

메소드 실행에 실패하거나 파라미터값을 잘 못 설정하면 "false"를 반환하고, onerror 이벤트가 발생합니다.

pause

모바일기기에서 오디오파일의 재생을 일시중지하는 메소드입니다.

지원 환경

Desktop NRE		Desktop WRE
☐ Windows	☐ macOS	☐ Edge	☐ Chrome	☐ Safari	☐ Firefox	☐ Opera
Mobile NRE		Mobile WRE
☑ Android	☑ iOS/iPadOS	☐ Android	☐ iOS/iPadOS

문법

AudioPlayer.pause()

파라미터

this.AudioPlayer00.pause();

참고

- pause() 메소드 수행이 완료되면  onstop 이벤트가 발생합니다.
  이 때, onstop 이벤트의 e.reason 속성값은 "6" 이 됩니다.

play

모바일기기에서 로딩 된 오디오파일을 재생하는 메소드입니다.

지원 환경

Desktop NRE		Desktop WRE
☐ Windows	☐ macOS	☐ Edge	☐ Chrome	☐ Safari	☐ Firefox	☐ Opera
Mobile NRE		Mobile WRE
☑ Android	☑ iOS/iPadOS	☐ Android	☐ iOS/iPadOS

문법

AudioPlayer.play( [nIntervalTime] )

파라미터

Parameters	Type	Description
nIntervalTime	Object	오디오 파일 재생 중 onplaying 이벤트가 발생하는 주기를 밀리초(milliseconds) 단위의 숫자로 설정합니다. 주기는 200ms ~ 86,400,000ms 사이의 값을 설정할 수 있습니다. 값을 생략하거나 200ms 미만으로 설정 시 onplaying 이벤트가 발생하지 않습니다.
this.AudioPlayer00.play(1000);

Parameters

Type

Description

nIntervalTime

Object

오디오 파일 재생 중 onplaying 이벤트가 발생하는 주기를 밀리초(milliseconds) 단위의 숫자로 설정합니다.

주기는 200ms ~ 86,400,000ms 사이의 값을 설정할 수 있습니다.

값을 생략하거나 200ms 미만으로 설정 시 onplaying 이벤트가 발생하지 않습니다.

this.AudioPlayer00.play(1000);

반환

Type	Description
Boolean	메소드 실행에 성공하면 true 를 반환합니다. 메소드 실행에 실패하거나 파라미터값을 잘 못 설정하면 false 를 반환합니다.

Type

Description

Boolean

메소드 실행에 성공하면 true 를 반환합니다.

메소드 실행에 실패하거나 파라미터값을 잘 못 설정하면 false 를 반환합니다.

참고

- 오디오파일 재생에 성공하면 onplay 이벤트 발생 후 onplaying 이벤트가 설정된 주기만큼 반복 발생합니다.
   오디오파일 재생에 실패하면 onerror 이벤트가 발생합니다.

resume

모바일 기기에서 일시중지 상태의 오디오파일을 재생상태로 전환하는 메소드입니다.

지원 환경

Desktop NRE		Desktop WRE
☐ Windows	☐ macOS	☐ Edge	☐ Chrome	☐ Safari	☐ Firefox	☐ Opera
Mobile NRE		Mobile WRE
☑ Android	☑ iOS/iPadOS	☐ Android	☐ iOS/iPadOS

문법

AudioPlayer.resume()

참고

- resume() 메소드 수행이 완료되면  onplay 이벤트가 발생합니다.
   이 때, onplay 이벤트의 e.reason 속성값은 2 가 됩니다.

stop

모바일 기기에서 오디오파일의 재생을 중지하는 메소드입니다.

지원 환경

Desktop NRE		Desktop WRE
☐ Windows	☐ macOS	☐ Edge	☐ Chrome	☐ Safari	☐ Firefox	☐ Opera
Mobile NRE		Mobile WRE
☑ Android	☑ iOS/iPadOS	☐ Android	☐ iOS/iPadOS

문법

AudioPlayer.stop()

파라미터

this.AudioPlayer00.stop();

참고

- stop() 메소드 수행이 완료되면  onstop 이벤트가 발생합니다.
  이 때, onstop 이벤트의 e.reason 속성값은 "5" 가 됩니다.

이벤트

onerror

모바일 기기에서 오디오파일에 대한 처리가 실패했을 때 발생하는 이벤트입니다.

지원 환경

Desktop NRE		Desktop WRE
☐ Windows	☐ macOS	☐ Edge	☐ Chrome	☐ Safari	☐ Firefox	☐ Opera
Mobile NRE		Mobile WRE
☑ Android	☑ iOS/iPadOS	☐ Android	☐ iOS/iPadOS

문법

onerror(obj:nexacro.AudioPlayer,e:nexacro.AudioErrorEventInfo);

파라미터

Parameters	Type	Description
obj	AudioPlayer	Event가 발생한 Object.
e	AudioErrorEventInfo	Event Object.

onload

모바일 기기에서 오디오파일이 로드됐을 때 발생하는 이벤트입니다.

지원 환경

Desktop NRE		Desktop WRE
☐ Windows	☐ macOS	☐ Edge	☐ Chrome	☐ Safari	☐ Firefox	☐ Opera
Mobile NRE		Mobile WRE
☑ Android	☑ iOS/iPadOS	☐ Android	☐ iOS/iPadOS

문법

onload(obj:nexacro.AudioPlayer,e:nexacro.AudioEventInfo);

파라미터

Parameters	Type	Description
obj	AudioPlayer	Event가 발생한 Object.
e	AudioEventInfo	Event Object.

참고

- 오디오파일이 로딩 된 후 url, duration, currentpos 속성값이 파일정보에 맞게 설정됩니다.

onmovepos

모바일 기기에서 오디오파일의 재생 위치가 이동됐을 때 발생하는 이벤트입니다.

지원 환경

Desktop NRE		Desktop WRE
☐ Windows	☐ macOS	☐ Edge	☐ Chrome	☐ Safari	☐ Firefox	☐ Opera
Mobile NRE		Mobile WRE
☑ Android	☑ iOS/iPadOS	☐ Android	☐ iOS/iPadOS

문법

onmovepos(obj:nexacro.AudioPlayer,e:nexacro.AudioEventInfo);

파라미터

Parameters	Type	Description
obj	AudioPlayer	Event가 발생한 Object.
e	AudioEventInfo	Event Object.

onplay

모바일 기기에서 오디오파일의 재생이 시작됐을 때 발생하는 이벤트입니다.

지원 환경

Desktop NRE		Desktop WRE
☐ Windows	☐ macOS	☐ Edge	☐ Chrome	☐ Safari	☐ Firefox	☐ Opera
Mobile NRE		Mobile WRE
☑ Android	☑ iOS/iPadOS	☐ Android	☐ iOS/iPadOS

문법

onplay(obj:nexacro.AudioPlayer,e:nexacro.AudioEventInfo);

파라미터

Parameters	Type	Description
obj	AudioPlayer	Event가 발생한 Object.
e	AudioEventInfo	Event Object.

onplaying

모바일 기기에서 오디오파일이 재생중일 때 발생하는 이벤트입니다.

지원 환경

Desktop NRE		Desktop WRE
☐ Windows	☐ macOS	☐ Edge	☐ Chrome	☐ Safari	☐ Firefox	☐ Opera
Mobile NRE		Mobile WRE
☑ Android	☑ iOS/iPadOS	☐ Android	☐ iOS/iPadOS

문법

onplaying(obj:nexacro.AudioPlayer,e:nexacro.AudioEventInfo);

파라미터

Parameters	Type	Description
obj	AudioPlayer	Event가 발생한 Object.
e	AudioEventInfo	Event Object.

onstop

모바일 기기에서 오디오파일의 재생이 중지됐을 때 발생하는 이벤트입니다.

지원 환경

Desktop NRE		Desktop WRE
☐ Windows	☐ macOS	☐ Edge	☐ Chrome	☐ Safari	☐ Firefox	☐ Opera
Mobile NRE		Mobile WRE
☑ Android	☑ iOS/iPadOS	☐ Android	☐ iOS/iPadOS

문법

onstop(obj:nexacro.AudioPlayer,e:nexacro.AudioEventInfo);

파라미터

Parameters	Type	Description
obj	AudioPlayer	Event가 발생한 Object.
e	AudioEventInfo	Event Object.