개요

모바일 기기의 진동기능을 제공합니다.

지원 환경

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

속성

id

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

지원 환경

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

문법

Vibrator.id

문법 설정

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

참고

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

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

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

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

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

name

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

지원 환경

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

문법

Vibrator.name[= strName]

문법 설정

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

참고

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

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

parent

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

지원 환경

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

문법

Vibrator.parent

문법 설정

var objParent = this.Vibrator00.parent;

참고

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

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

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

patterns

모바일 기기에서 진동 패턴을 배열로 설정하는 속성입니다.

지원 환경

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

문법

문법 설정

var arrPattern = new Array(1000, 200, 1000, 2000, 1200, 1000); this.Vibrator00.patterns = arrPattern;
arrPattern	진동 패턴을 "무진동, 진동" 의 쌍으로 이루어진 배열로 설정합니다. 배열의 요소값은 밀리초(milliseconds)단위의 시간으로 설정합니다.

var arrPattern = new Array(1000, 200, 1000, 2000, 1200, 1000);
this.Vibrator00.patterns = arrPattern;

arrPattern

진동 패턴을 "무진동, 진동" 의 쌍으로 이루어진 배열로 설정합니다.

배열의 요소값은 밀리초(milliseconds)단위의 시간으로 설정합니다.

참고

- patterns 속성값을 설정하지 않으면 "{100, 100}" 으로 적용됩니다.

- iOS/iPadOS NRE 는 지원하지 않는 기능입니다.

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.Vibrator00.repeatcount = 10;
nRepeatCount	patterns 속성값에 설정된 진동패턴이 반복되는 횟수를 숫자로 설정합니다. 0 설정 시 진동패턴이 무한반복됩니다. 1 설정 시 반복없이 1회만 실행됩니다.

this.Vibrator00.repeatcount = 10;

nRepeatCount

patterns 속성값에 설정된 진동패턴이 반복되는 횟수를 숫자로 설정합니다.

0 설정 시 진동패턴이 무한반복됩니다.

1 설정 시 반복없이 1회만 실행됩니다.

참고

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

- iOS/iPadOS 는 patterns 속성값이 무시되고, 디바이스에서 제공하는 진동패턴이 적용됩니다.

startpos

patterns 속성에 설정된 진동 패턴의 시작위치를 설정하는 속성입니다.

지원 환경

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.Vibrator00.startpos = 10;
nStartPos	patterns 속성에 설정된 진동패턴 배열값에서 진동을 시작할 배열요소의 인덱스값을 설정합니다. 배열요소의 갯수보다 큰 값을 설정할 수 없습니다.

this.Vibrator00.startpos = 10;

nStartPos

patterns 속성에 설정된 진동패턴 배열값에서 진동을 시작할 배열요소의 인덱스값을 설정합니다.

배열요소의 갯수보다 큰 값을 설정할 수 없습니다.

참고

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

- 지정된 위치부터 패턴의 끝까지 반복 실행됩니다.

- iOS/iPadOS NRE 는 지원하지 않는 기능입니다.

메서드

hasVibrator

모바일 기기에서 진동 기능을 사용할 수 있는지 확인하는 메소드입니다.

지원 환경

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

문법

Vibrator.hasVibrator()

파라미터

this.Vibrator00.hasVibrator();

반환

Type	Description
Boolean	기기에서 진동기능을 사용할수 있으면 "true" 를 반환합니다. 기기에서 진동기능을 사용할 수 없으면 "false" 를 반환합니다.

Type

Description

Boolean

기기에서 진동기능을 사용할수 있으면 "true" 를 반환합니다.

기기에서 진동기능을 사용할 수 없으면 "false" 를 반환합니다.

play

모바일 기기에서 진동을 발생시키는 메소드입니다.

지원 환경

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

문법

Vibrator.play()

파라미터

this.Vibrator00.play();

참고

- Android NRE 는 patterns 속성값에 설정된 순서대로 repeatCount 속성값만큼 반복하여 진동기능을 수행합니다.

- iOS/iPadOS NRE 는 patterns 속성값을 사용할 수 없고, 디바이스가 제공하는 진동을 repeatCount 속성값만큼 반복하여 진동기능을 수행합니다.

stop

모바일 기기에서 진동을 중지하는 메소드입니다.

지원 환경

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

문법

Vibrator.stop()

파라미터

this.Vibrator00.stop();

이벤트

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.Vibrator,e:nexacro.VibratorErrorEventInfo);

파라미터

Parameters	Type	Description
obj	Vibrator	Event가 발생한 Object.
e	VibratorErrorEventInfo	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.Vibrator,e:nexacro.VibratorEventInfo);

파라미터

Parameters	Type	Description
obj	Vibrator	Event가 발생한 Object.
e	VibratorEventInfo	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.Vibrator,e:nexacro.VibratorEventInfo);

파라미터

Parameters	Type	Description
obj	Vibrator	Event가 발생한 Object.
e	VibratorEventInfo	Event Object.