MozMobileMessageManager

요약

기기에서 WebSMS를 사용하여 MMS와 SMS 메시지 전송과 관리를 할 수 있는 기능을 제공한다.

이벤트 핸들러

MozMobileMessageManager.ondeliveryerror

deliveryerror 이벤트에 대한 핸들러; MozMmsEvent 는 MMS 또는 SMS가 수취인에게 전달되지 않았을 때 발생한다.

MozMobileMessageManager.ondeliverysuccess

deliverysuccess 이벤트에 대한 핸들러; MozMmsEvent 는 MMS 또는 SMS가 수취인에게 전달되었을 때 발생한다.

MozMobileMessageManager.onreceived

received 이벤트에 대한 핸들러; MozMmsEvent 는 MMS 또는 SMS를 받았을 때 발생한다.

MozMobileMessageManager.onretrieving

retrieving 이벤트에 대한 핸들러; MozMmsEvent 는 검색 단계의 시작에 MMS 또는 SMS가 진입했을 때 발생한다.

MozMobileMessageManager.onsent

sent 이벤트에 대한 핸들러; MozMmsEvent 는 MMS 또는 SMS가 보내졌을 때 발생한다.

MozMobileMessageManager.onsending

sending 이벤트에 대한 핸들러; MozMmsEvent 는 전송 단계의 시작에 MMS 또는 SMS가 진입했을 때 발생한다.

MozMobileMessageManager.onfailed

failed 이벤트에 대한 핸들러; MozMmsEvent 는 SMS 전송이 실패했을 때 발생한다.

메소드

MozMobileMessageManager.delete(param)

메시지를 삭제하고 DOMRequest 객체를 반환한다 (DOMRequest.result는 메시지가 삭제되었는지 아닌지를 반영하는 Boolean 값이다). 메시지 id, MozSmsMessage 객체 또는 MozMmsMessage 객체가 파라미터로 사용된다.

MozSmsManager.getMessage(id)

해당 id에 대한 메시지를 받아서 DOMRequest 객체를 반환한다. 이 객체의 DOMRequest.result는 MozSmsMessage 이다.

MozSmsManager.getMessages(filter, reverseOrder)

여러 개의 메시지를 받는다. MozSmsFilter 객체를 사용하여 필터링이 가능하고 두번째 파라미터 Boolean 값에 따라 메시지의 순서를 거꾸로 바꿀 수도 있다. DOMCursor 를 반환한다.

MozMobileMessageManager.getSegmentInfoForText(text)

주어진 문자(보통 SMS당 160 글자)에 대한 멀티 파트 SMS를 만들기 위해 필요한 정보를 가진 MozSmsSegmentInfo 객체를 반환한다.

MozMobileMessageManager.markMessageRead(id, isRead)

해당 id 의 메시지를 Boolean isRead 값에 따라 읽음 또는 읽지 않음으로 표시한다. DOMRequest 객체를 반환한다.

MozMobileMessageManager.send(number, message)

해당 전화번호에 메시지를 전송한다. 만약 number가 DOMString (한 개의 전화번호) 라면 DOMRequest 객체를 반환한다. 만약 number가 DOMString 객체의 배열(여러 개의 전화번호)이라면 DOMRequest 객체의 배열을 반환한다.

MozMobileMessageManager.sendMMS(param)

수신자 목록에 MMS를 전송한다. DOMRequest 객체를 반환한다.
param 객체는 다음과 같은 4개의 속성을 가지고 있는 일반 JavaScript 객체이다:
receivers: 문자열 배열, 각 문자열은 수신자의 전화번호를 나타낸다.
subject: MMS의 제목을 나타내는 문자열이다.
smil: MMS를 정의하는 SMIL 문서의 문자열 버전이다.
attachments: SMIL에 의해 사용되는 첨부 파일 객체의 배열이다. 이 객체는 id, location, content (Blob)를 포함하고 있다.

MozMobileMessageManager.getThreads()

MozMobileMessageThread 의 목록을 받는다. DOMCursor 를 반환한다.

MozMobileMessageManager.retrieveMMS(id)

해당 id의 메시지를 받아 DOMRequest 를 반환한다. 이 객체의 DOMRequest.result 는 MozMmsMessage 이다.

MozMobileMessageManager 또한 EventTarget 의 메소드를 상속받는다.

EventTarget.addEventListener()

Register an event handler of a specific event type on the EventTarget.

EventTarget.removeEventListener()

Removes an event listener from the EventTarget.

EventTarget.dispatchEvent()

Dispatch an event to this EventTarget.

스펙

이 API는 비 표준 스펙의 구현체이다. 하지만 W3C의 System Application Working Group에서 논의되고 있다.

브라우저 호환성

당연하게도, 모바일 브라우저를 주로 지원할 것으로 예상된다.

참고 자료

• window.navigator.mozMobileMessage
• MozMmsEvent