개요

단문 메시지 서비스(SMS)를 지원하는 오브젝트로 문자메시지 송수신을 처리합니다.

지원 환경

속성

id

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

지원 환경

속성 타입

문법

Sms.id

문법 설정

참고

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

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

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

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

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

message

모바일 기기에서 상대에게 전송할 메시지를 설정하는 속성입니다.

지원 환경

속성 타입

문법 설정

this.Sms00.message = "hello";

참고

- 만일 문자열 길이가 80 Bytes가 넘을 경우 통신사 또는 제조사의 기준에 따라 자동으로 MMS/LMS 형태로 변경되어 처리됩니다.
  문자열 길이 제한에 대해 사용자에게 알리는 방법은 통신사 또는 제조사마다 방식이 다릅니다.

name

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

지원 환경

속성 타입

문법

Sms.name[= strName]

문법 설정

참고

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

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

parent

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

지원 환경

속성 타입

문법

Sms.parent

문법 설정

var objParent = this.Sms00.parent;

참고

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

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

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

phonenumber

모바일 기기에서 메시지를 보낼 상대의 전화번호를 설정하는 속성입니다.

지원 환경

속성 타입

문법 설정

this.Sms00.phonenumber = "010-1234-5678";

참고

메서드

deleteMessage

모바일 기기에 저장되어 있는 SMS 에서 지정한 메시지를 삭제하는 메소드입니다.

지원 환경

문법

Sms.deleteMessage(nSmsid)

파라미터

this.Sms00.deleteMessage( 1 );

반환

참고

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

- Android KitKat v4.4 버전 이상의 디바이스는 기본 SMS 앱에서만 SMS 메시지를 삭제할 수 있습니다.
   따라서 deleteMessage() 메소드는 Android KitKat v4.4 미만 버전까지 사용할 수 있습니다.

readMessageList

모바일 기기에 저장되어 있는 SMS 목록을 반환하는 메소드입니다.

지원 환경

문법

Sms.readMessageList()

파라미터

this.Sms00.readMessageList();

참고

- readMessageList() 메소드가 정상적으로 수행되면 onreadmessagelist 이벤트가 발생합니다.

- 저장된 SMS 의 텍스트만 반환됩니다.

- Android NRE 는 기기에서 SMS 접근경로를 공개한 경우만 지원가능합니다.
  (지원되지 않는 기기의 경우 onreadmessagelist 이벤트에서 빈 값의 목록을 전달 받습니다)

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

recvStart

모바일 기기에서 SMS 수신 시 이벤트를 발생시키도록 설정하는 메소드입니다.

지원 환경

문법

Sms.recvStart()

파라미터

this.Sms00.recvStart();

참고

- SMS 가 정상적으로 수신될 때마다 onrecvmessage 이벤트가 발생합니다.
   SMS 수신 시 에러가 발생하면 onerror 이벤트가 발생합니다.

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

recvStop

recvStart() 메소드로 설정한 이벤트 발생 기능을 종료하는 메소드입니다.

지원 환경

문법

Sms.recvStop()

파라미터

this.Sms00.recvStop()

참고

- SMS 수신에 따른 이벤트 발생을 중지합니다.

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

sendMessage

모바일 기기에서 문자 메시지 전송을 위해 SMS 작성화면을 표시하는 메소드입니다.

지원 환경

문법

Sms.sendMessage([strNumber [,strMessage]])

파라미터

this.Sms00.sendMessage("010-1234-5678", "hello");

반환

참고

- MMS 또는 이메일을 전송할 수 있습니다.

- sendMessage() 메소드 수행 시 모바일 기기의 SMS 작성화면이 호출되며, 메시지의 발송여부 또는 전달여부를 이벤트로 확인할 수 없습니다.

- iPad 계열의 디바이스에서는 지원하지 않는 메소드입니다.

이벤트

cansendmessage

모바일 기기에서 SMS 메시지가 송신될 때 발생하는 이벤트입니다.

지원 환경

문법

cansendmessage(obj:nexacro.Sms,e:nexacro.SmsEventInfo);

파라미터

반환

참고

ondeletemessage

모바일 기기에 저장되어 있는 SMS 가 삭제될 때 발생하는 이벤트입니다.

지원 환경

문법

ondeletemessage(obj:nexacro.Sms,e:nexacro.SmsEventInfo);

파라미터

참고

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

onerror

모바일 기기에서 SMS 관련 처리가 실패했을 때 발생하는 이벤트입니다.

지원 환경

문법

onerror(obj:nexacro.Sms,e:nexacro.SmsErrorEventInfo);

파라미터

참고

- iOS/iPadOS 는 메시지 발신 시 성공/실패 여부를 확인할 수 없어 발신에 실패하더라도 onerror 이벤트가 발생하지 않습니다.

onreadmessagelist

모바일 기기에 저장되어 있는 SMS 목록을 조회할 때 발생하는 이벤트입니다.

지원 환경

문법

onreadmessagelist(obj:nexacro.Sms,e:nexacro.SmsMessageListEventInfo);

파라미터

참고

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

onrecvmessage

모바일 기기에서 SMS 메시지가 수신될 때 발생하는 이벤트입니다.

지원 환경

문법

onrecvmessage(obj:nexacro.Sms,e:nexacro.SmsEventInfo);

파라미터

참고

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

onsendmessage

모바일 기기에서 SMS 메시지가 송신된 후 발생하는 이벤트입니다.

지원 환경

문법

onsendmessage(obj:nexacro.Sms,e:nexacro.SmsEventInfo);

파라미터