개요

모바일 기기의 가속도 정보를 제공합니다.

지원 환경

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

속성

accuracy

모바일 기기에서 수신한 가속도 정보의 정확도를 갖는 읽기전용 속성입니다.

지원 환경

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

참고

- accuracy 속성은 "0~3" 범위의 정수값만을 가질 수 있습니다.

id

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

지원 환경

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

문법

Acceleration.id

문법 설정

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

참고

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

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

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

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

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

name

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

지원 환경

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

문법

Acceleration.name[= strName]

문법 설정

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

참고

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

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

parent

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

지원 환경

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

문법

Acceleration.parent

문법 설정

var objParent = this.Acceleration00.parent;

참고

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

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

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

timestamp

모바일 기기에서 가속도 정보를 수신한 시간을 갖는 읽기전용 속성입니다.

지원 환경

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

xpos

모바일 기기에서 수신한 가속도 정보 중 x 축의 값을 갖는 읽기전용 속성입니다.

지원 환경

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

참고

- 모바일 기기의 기울기 방향에 따라 양수 또는 음수값을 갖습니다.

ypos

모바일 기기에서 수신한 가속도 정보 중 y 축의 값을 갖는 읽기전용 속성입니다.

지원 환경

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

참고

- 모바일 기기의 기울기 방향에 따라 양수 또는 음수값을 갖습니다.

zpos

모바일 기기에서 수신한 가속도 정보 중 z 축의 값을 갖는 읽기전용 속성입니다.

지원 환경

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

참고

- 모바일 기기의 기울기 방향에 따라 양수 또는 음수값을 갖습니다.

메서드

getCurrentAcceleration

모바일 기기의 가속도 정보를 반환하는 메소드입니다.

지원 환경

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

문법

Acceleration.getCurrentAcceleration( [nAccuracy] )

파라미터

Parameters	Type	Description
nAccuracy	Number	가속도 정보의 정확도를 "0~3" 범위의 숫자로 설정합니다. 값이 작을수록 반환되는 값의 정확도가 높아집니다. 값 생략 시 0 으로 적용됩니다.
Acceleration.getCurrentAcceleration(2);

Parameters

Type

Description

nAccuracy

Number

가속도 정보의 정확도를 "0~3" 범위의 숫자로 설정합니다.

값이 작을수록 반환되는 값의 정확도가 높아집니다.

값 생략 시 0 으로 적용됩니다.

Acceleration.getCurrentAcceleration(2);

반환

Type	Description
Boolean	가속도 정보 수신에 성공하면 true 를 반환하고, onrecvsuccess 이벤트가 발생합니다. 가속도 정보 수신에 실패하면 false 를 반환하고, onrecverror 이벤트가 발생합니다. nAccuracy 값이 "0~3" 값이 아니면 false 를 반환합니다.

Type

Description

Boolean

가속도 정보 수신에 성공하면 true 를 반환하고, onrecvsuccess 이벤트가 발생합니다.

가속도 정보 수신에 실패하면 false 를 반환하고, onrecverror 이벤트가 발생합니다.

nAccuracy 값이 "0~3" 값이 아니면 false 를 반환합니다.

watchStart

모바일 기기의 가속도 정보를 일정 간격으로 수신하도록 설정하는 메소드입니다.

지원 환경

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

문법

Acceleration.watchStart( nAccuracy, nIntervalTime )

파라미터

Parameters	Type	Description
nAccuracy	Number	가속도 정보 정확도를 "0~3"범위의 숫자로 설정합니다. 값이 작을수록 반환되는 값의 정확도가 높아집니다.
nIntervalTime	Number	가속도 정보를 수신할 주기를 밀리초(milliseconds) 단위의 숫자로 설정합니다. 주기는 200ms ~ 86,400,000ms 사이의 값을 설정할 수 있습니다.
Acceleration.watchStart(1, 1000);

Parameters

Type

Description

nAccuracy

Number

가속도 정보 정확도를 "0~3"범위의 숫자로 설정합니다.

값이 작을수록 반환되는 값의 정확도가 높아집니다.

nIntervalTime

Number

가속도 정보를 수신할 주기를 밀리초(milliseconds) 단위의 숫자로 설정합니다.

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

Acceleration.watchStart(1, 1000);

반환

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

Type

Description

Boolean

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

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

참고

- nIntervalTime 간격으로 nAccuracy 정확도의 가속도 정보를 수신합니다.
  가속도 정보 수신에 성공하면 onrecvsuccess 이벤트가 발생합니다.
  가속도 정보 수신에 실패하면 onrecverror 이벤트가 발생합니다.

watchStop

watchStart() 메소드로 설정한 주기적인 가속도 정보 수신을 종료하는 메소드입니다.

지원 환경

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

문법

Acceleration.watchStop()

파라미터

Acceleration.watchStop();

이벤트

onrecverror

모바일 기기에서 가속도 정보 수신이 실패했을 때 발생하는 이벤트입니다.

지원 환경

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

문법

onrecverror(obj:nexacro.Acceleration,e:nexacro.AccelerationErrorEventInfo);

파라미터

Parameters	Type	Description
obj	Acceleration	Event가 발생한 Object.
e	AccelerationErrorEventInfo	Event Object.

onrecvsuccess

모바일 기기에서 가속도 정보 수신이 성공했을 때 발생하는 이벤트입니다.

지원 환경

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

문법

onrecvsuccess(obj:nexacro.Acceleration,e:nexacro.AccelerationEventInfo);

파라미터

Parameters	Type	Description
obj	Acceleration	Event가 발생한 Object.
e	AccelerationEventInfo	Event Object.