개요

모바일 기기의 네트워크 연결정보를 제공합니다.

지원 환경

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

속성

availabletype

모바일 기기에서 사용가능한 네트워크에 대한 정보를 정수로 갖는 읽기전용 속성입니다.

지원 환경

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 nType = this.Network00.availabletype ;
"0"	사용가능한 네트워크가 없을 때 갖는 값입니다.
"1"	"3G" 또는 "LTE" 네트워크를 사용할 때 갖는 값입니다.
"2"	"WIFI" 네트워크를 사용할 때 갖는 값입니다.

참고

- onrecvsuccess 이벤트가 발생하면 최신값으로 갱신됩니다.

id

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

지원 환경

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

문법

Network.id

문법 설정

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

참고

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

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

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

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

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

name

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

지원 환경

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

문법

Network.name[= strName]

문법 설정

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

참고

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

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

parent

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

지원 환경

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

문법

Network.parent

문법 설정

var objParent = this.Network00.parent;

참고

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

- Network 이(가) 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

참고

- JavaScript 의 Date 자료형을 갖습니다.

- onrecvsuccess 이벤트가 발생하면 최신값으로 갱신됩니다.

메서드

isReachable

모바일 기기에서 특정 URL 의 접속 가능 여부를 반환하는 메소드입니다.

지원 환경

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

문법

Network.isReachable(strURL)

파라미터

Parameters	Type	Description
strURL	String	접속 가능 여부를 확인하려는 URL을 문자열로 설정합니다.
this.Network00.isReachable( "http://www.tobesoft.com" );

반환

Type	Description
Boolean	strURL 이 생략되거나 허용되지 않는 문자가 사용된 경우에는 "false" 를 반환합니다. 그 외의 정상적인 경우에는 "true" 를 반환합니다.

Type

Description

Boolean

strURL 이 생략되거나 허용되지 않는 문자가 사용된 경우에는 "false" 를 반환합니다.

그 외의 정상적인 경우에는 "true" 를 반환합니다.

참고

- 지정된 URL 에 접근이 가능하면 onrecvsuccess 이벤트가 발생합니다.
  지정된 URL 에 접근이 불가능하면 onrecverror 이벤트가 발생합니다.

- 지정된 URL 로 접근 시 일정시간 내에 응답이 없으면 onrecverror 이벤트가 발생합니다.

watchStart

모바일 기기에서 네트워크 상태를 일정 간격으로 수신하도록 설정하는 메소드입니다.

지원 환경

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

문법

Network.watchStart(nIntervalTime)

파라미터

Parameters	Type	Description
nIntervalTime	Number	네트워크 상태를 수신할 주기를 밀리초(milliseconds) 단위의 숫자로 설정합니다. 주기는 200ms ~ 86,400,000ms 사이의 값을 설정할 수 있습니다.
this.Network00.watchStart(1000);

Parameters

Type

Description

nIntervalTime

Number

네트워크 상태를 수신할 주기를 밀리초(milliseconds) 단위의 숫자로 설정합니다.

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

this.Network00.watchStart(1000);

반환

Type	Description
Boolean	nIntervalTime 이 생략되거나 허용되지 않는 문자가 사용된 경우에는 "false" 를 반환합니다. 그 외의 정상적인 경우에는 "true" 를 반환합니다.

Type

Description

Boolean

nIntervalTime 이 생략되거나 허용되지 않는 문자가 사용된 경우에는 "false" 를 반환합니다.

그 외의 정상적인 경우에는 "true" 를 반환합니다.

참고

- 네트워크 상태가 확인되면 onrecvsuccess 이벤트가 발생합니다.
  네트워크 상태가 확인되지 않으면 onrecverror 이벤트가 발생합니다.

- onrecvsuccess 이벤트가 발생하면 네트워크 정보를 availabletype, timestamp 속성에 저장합니다.

watchStop

watchStart() 메소드로 설정한 주기적인 네트워크 상태확인을 종료하는 메소드입니다.

지원 환경

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

문법

Network.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.Network,e:nexacro.NetworkErrorEventInfo);

파라미터

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

파라미터

Parameters	Type	Description
obj	Network	Event가 발생한 Object.
e	NetworkEventInfo	Event Object.

참고

- 네트워크 상태가 확인되면 네트워크 정보를 availabletype, timestamp 속성에 저장합니다.