개요

모바일 기기의 오디오를 레코딩하여 파일로 저장합니다.

지원 환경

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

속성

audiofile

모바일 기기에서 녹음 시 오디오 데이터를 저장 할 파일명을 설정하는 속성입니다.

지원 환경

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.AudioRecorder00.audiofile = "%SD_CARD% rec001.mp3"; this.AudioRecorder00.audiofile = "%USERAPP% rec001.wav"; this.AudioRecorder00.audiofile = "%USERAPP% rec001";
strAudioFile	오디오 데이터를 저장 할 파일명을 문자열로 설정합니다.

참고

- audiofile 속성값에 확장자를 설정하지 않으면 audioformat 속성값에 따라 자동으로 적용됩니다.

- 확장자는 audioformat 속성값에 맞게 설정해야 정상적인 재생이 가능합니다.

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



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

OS	Alias	Path
Android	%USERAPP%	/data/data/{PackageName}/files/NEXACRO/
	%SD_CARD%	/mnt/sdcard (Android v4.0 이하)/storage/emulated/0 (Android v4.1 이상)
	%INSTALLROOT%	%USERAPP%
iOS	%USERAPP%	/Library/Caches/nexacro/
	%SD_CARD%	미지원
	%INSTALLROOT%	%USERAPP%

audioformat

모바일 기기에서 녹음 시 오디오 데이타의 포맷을 설정하는 속성입니다.

지원 환경

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

문법 설정

enumFormat ::= 'WAV' \| 'OGG' \| 'MP3' \| 'AMR_NB' \| 'AMR_WB'
this.AudioRecoder00.audioformat = "WAV"; this.AudioRecoder00.audioformat = "MP3"; this.AudioRecoder00.audioformat = "OGG"; this.AudioRecoder00.audioformat = "AMR_NB"; this.AudioRecoder00.audioformat = "AMR_WB";
enumFormat	오디오 데이터의 포맷을 설정합니다. "WAV", "OGG", "MP3", "AMR_NB", "AMR_WB" 중 하나의 값을 설정합니다.

enumFormat ::= 'WAV' | 'OGG' | 'MP3' | 'AMR_NB' | 'AMR_WB'

this.AudioRecoder00.audioformat = "WAV";
this.AudioRecoder00.audioformat = "MP3";
this.AudioRecoder00.audioformat = "OGG";
this.AudioRecoder00.audioformat = "AMR_NB";
this.AudioRecoder00.audioformat = "AMR_WB";

enumFormat

오디오 데이터의 포맷을 설정합니다.

"WAV", "OGG", "MP3", "AMR_NB", "AMR_WB" 중 하나의 값을 설정합니다.

참고

- audioformat 속성값을 설정하지 않으면 Android NRE 는 "MP3" 로 적용되고, iOS/iPadOS NRE 는 "WAV" 로 적용됩니다.

- 파일포맷에 따른 샘플비율 범위입니다.

File Format	Extension	Sample Rate	Android	iOS
WAV	*.wav	8000 ~ 96000	X	O
OGG	*.ogg	8000, 11025, 16000, 22050, 32000, 44100	O	X
MP3	*.mp3	8000, 11025, 16000	O	X
AMR_NB	*.mp3	8000	O	X
AMR_WB	*.mp3	16000	O	X

channelconfig

모바일 기기에서 녹음 시 오디오 채널의 종류를 설정하는 속성입니다.

지원 환경

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

문법 설정

enumChannel ::= '1' \| '2'
this.AudioRecorder00.channelconfig = 1; this.AudioRecorder00.channelconfig = 2;
enumChannel	"1" 설정 시 Mono 로 녹음이 됩니다. "2" 설정 시 Stereo 로 녹음이 됩니다.

enumChannel ::= '1' | '2'

this.AudioRecorder00.channelconfig = 1;
this.AudioRecorder00.channelconfig = 2;

enumChannel

"1" 설정 시 Mono 로 녹음이 됩니다.

"2" 설정 시 Stereo 로 녹음이 됩니다.

참고

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

- audioformat 속성값이 "AMR_NB" 인 경우는 channelconfig 속성값을 "1" 만 설정할 수 있습니다.

id

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

지원 환경

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

문법

AudioRecorder.id

문법 설정

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

참고

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

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

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

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

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

name

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

지원 환경

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

문법

AudioRecorder.name[= strName]

문법 설정

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

참고

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

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

parent

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

지원 환경

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

문법

AudioRecorder.parent

문법 설정

var objParent = this.AudioRecorder00.parent;

참고

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

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

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

samplerate

모바일 기기에서 녹음 시 오디오 데이터의 샘플비율을 설정하는 속성입니다.

지원 환경

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.AudioRecoder00.samplerate = 9000;
nSampleRate	샘플비율을 숫자로 설정합니다. audioformat 속성값에 따라 설정할 수 있는 범위가 달라집니다.

this.AudioRecoder00.samplerate = 9000;

nSampleRate

샘플비율을 숫자로 설정합니다.

audioformat 속성값에 따라 설정할 수 있는 범위가 달라집니다.

참고

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

- 파일포맷에 따른 샘플비율 범위입니다.

File Format	Extension	Sample Rate	Android	iOS
WAV	*.wav	8000 ~ 96000	X	O
OGG	*.ogg	8000, 11025, 16000, 22050, 32000, 44100	O	X
MP3	*.mp3	8000, 11025, 16000	O	X
AMR_NB	*.mp3	8000	O	X
AMR_WB	*.mp3	16000	O	X

메서드

pause

모바일 기기에서 오디오 데이터의 녹음을 일시중지시키는 메소드입니다.

지원 환경

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

문법

AudioRecord.pause()

파라미터

this.AudioRecord00.pause();

참고

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

- iOS/iPadOS NRE 만 지원되는 메소드입니다.

recordingStart

모바일 기기에서 오디오 데이터의 녹음을 시작하는 메소드입니다.

지원 환경

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

문법

AudioRecord.recordingStart( [nIntervalTime] )

파라미터

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

Parameters

Type

Description

nIntervalTime

Number

오디오 데이터 녹음 중 onrecording 이벤트가 발생하는 주기를 밀리초(milliseconds) 단위의 숫자로 설정합니다.

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

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

this.AudioRecord00.recordingStart();
this.AudioRecord00.recordingStart(1000);

반환

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

Type

Description

Boolean

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

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

참고

- audiofile, audioformat, samplerate, channelconfig 속성에 유효하지 않은 값이 설정된 경우 녹음이 시작되지 않고, onerror 이벤트가 발생합니다.

- 파일을 생성할 수 없을 경우 녹음이 시작되지 않고, onerror 이벤트가 발생합니다.

recordingStop

모바일 기기에서 오디오 데이타의 녹음을 중지하는 메소드입니다

지원 환경

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

문법

AudioRecord.recordingStop()

파라미터

this.AudioRecord00.recordingStop();

resume

모바일 기기에서 일시중지 된 녹음을 다시 진행하는 메소드입니다.

지원 환경

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

문법

AudioRecord.resume()

파라미터

this.AudioRecord00.resume();

참고

- iOS/iPadOS NRE 만 지원되는 메소드입니다.

이벤트

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.AudioRecorder,e:nexacro.AudioErrorEventInfo);

파라미터

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

onrecording

모바일 기기에서 오디오 데이터를 녹음중일때 발생하는 이벤트입니다.

지원 환경

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

문법

onrecording(obj:nexacro.AudioRecorder,e:nexacro.AudioEventInfo);

파라미터

Parameters	Type	Description
obj	AudioRecorder	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.AudioRecorder,e:nexacro.AudioEventInfo);

파라미터

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