ABOUT ME

-

Today
-
Yesterday
-
Total
-
  • sk-sms 프로그램인 mmsc.exe 의 파라메터 목록
    프로그래밍 2010. 6. 5. 18:33
    반응형

    SKT Windows Mobile기반

    SMS/MMS Client

    Open API 개발 규격서 

    Version 1.0 
     
     
     
     

    2009. 11 
     
     
     

     

    문서 개정 내역 

    변경일 버전 변경 내용 작성자 승인자
    2009-11-10 1.0 최초 작성(Draft)    
             
             
             
             
             
             
             
             
             
             
     

     

    목차

     

    1. WM MMSC Open API 개요

       스마트폰(GPOS)기반의 SMS/MMS는 그 특성상 다양한 Application과의 연동이 가능합니다. 따라서, 본 가이드는 SKT SMS/MMS의 다양한 기능을 T-Store의 Application이 손쉽게 연동할 수 있도록 개방된 API 셋트를 제공하며, 향후 SK Telecom이 공급하는 모든 스마트폰 기반의 SMS/MMS Client 어플리케이션에서 이를 지원할 계획입니다.

      1. 적용 단말

       - 삼성전자 : SCH-M710, SCH-M715, SCH-M720

       -  LG전자 : LG-SU210

       * 향후, 출시하는 SKT의 스마트폰 단말에 적용예정.

    1. API  사용 방법

    3rd Party 어플리케이션에서 MMS 어플리케이션을 사용하는 방식은 일반적인 객체지향 프로그램 방식인 이벤트 처리 방식을 사용합니다.

    3rd Party 어플리케이션에서 지정된 형식의 파라미터(Parameter)를 구성하고, 이를 SMS/MMS 어플리케이션의 이벤트로 전달하면, 이를 전달 받아 그 기능을 실행하게 됩니다. 

       Ex)  MMSDummy.exe [RunMode] [Parameter] 

    [3rd Party App에서 Open API 사용 예시]

       
      //사용자가 컨트롤 (에디트박스)에 입력한 파라미터 내용을 해당 변수에 대입합니다.

      UpdateData(); 

      // 프로세스에 해당하는 내용을 전달하기 위한 구조체를 선언합니다.

      PROCESS_INFORMATION pi; 

      //사용자가 입력한 내용을 저장할 변수를 선언합니다.

      TCHAR szMsg[256]={0,};  

      // 에디트박스에 입력한 내용을 변수에 저장합니다. (예 “0” “MSG_BOX”)

      wsprintf(szMsg,_T("%s"), m_strParamEdit );  

      //입력된 파라미터 값을 이용하여 MMS 어플리케이션 프로세스를 생성합니다.

      BOOL bRet = CreateProcess(_T("\\Windows\\MMSDummy.exe"), szMsg, NULL, NULL, FALSE, 0, NULL, NULL, NULL, &pi); 

      return 0;

     
     

     [ RunMode 규격]

      필드명 의미 정의
      RunMode MMS Client 프로세스 동작을 요청하는 실행 모드 ID “0“ 특정 메뉴 이동
      “1“ 전화번호를 이용한 MMS 메시지 작성
      “2“ 카메라 및 컨텐츠 보관함의 미디어를 이용한 MMS 메시지를 작성
      “5” 텍스트(Text) 데이터를 이용한 MMS 메시지 작성
      “6” 상용구 메시지를 보내기 위한 MMS 호출.
      Parameter RunMode 에 따른 파라메터 “ MSG_BOX” “0101231234;0104564567” RunMode에 따라 파라메터 값이 달라진다. 아래 Parameter 구성 형식 참조하여 호출해야 한다.

      (파라메터들의 순서는 반드시 지켜져야 한다.)

    1. RunMode 에 따른 API 사용 방법

      각각의 RunMode 따른 연동 규격을 설명한다.

      1. MMS Client 구동 시 특정 메뉴로 이동하기 위한 연동 규격

      MMS Client의 특정 메뉴로 이동하기 위한 연동 규격은 다음과 같다. 

    • <RunMode> 형식

        실행 모드 ID 값은 “0” 를 부여한다.  

    • [parameter] 구성 형식
      Menu Name
     
      필드명 의미 정의
      Menu Name 이동하고자 하는 메뉴 “MSG_BOX” 메시지 수신함으로 이동
      “USIM_BOX” USIM 메시지 보관함으로 이동
      “NEW_MSG” 메시지 작성으로 이동
     

         Ex) MMSDummy.exe “0” “ MSG_BOX” 

          è MMS Client를 실행해서 메시지 수신함으로 이동

      1. 전화번호를 이용하여 메시지 작성하기  위한 연동 규격

      전화번호를 이용하여 메시지를 작성하기 위한 연동 규격은 다음과 같다.  

    • <RunMode> 형식

         실행 모드 ID 값은 “1” 를 부여한다.

    • [parameter] 구성 형식
      Receive Information
     
      필드명 의미 정의
      Receive

      Information

      수신자 정보 “0111231234”

      “0101231234;0104564567”

      수신자 전화번호

      여러 개일 경우 세미콜론으로 구분

     

         Ex) MMSDummy.exe “1” “0101231234;0104564567”

         è 주소록에서 메시지 작성모드로 MMS Client를 구동시킴

      1. 카메라 UI 및 컨텐츠 보관함에서 메시지를 작성하기 위한 연동 규격

      카메라 UI에서 MMS Client를 호출하기 위한 연동 규격은 다음과 같다.

      단말기에서 사진 촬영을 한 직 후, ‘전송’ 기능을 선택하거나 OEM의 카메라 앨범 메뉴에서 ‘전송하기’ 기능을 선택한 경우, 3rd Party App은 다음의 규격을 따라 MMS Client를 구동한다. 

    • <RunMode> 형식

      실행 모드 ID 값은 “2” 를 부여한다. 

    • [parameter] 구성 형식
      Content Count   Type   File Name with File Path    
     
      필드명 의미 정의
      Content Count 첨부되는 파일의 개수 “2” 컨텐츠의 개수
      Type 사진/동영상 선택 “PHOTO” 사진 컨텐츠를 의미함
      “MOVIE” 동영상 컨텐츠를 의미함
      “AUDIO” 오디오 컨텐츠를 의미함
      File Path 파일 경로 “"\NATE Store\미디어 앨범\PIC_01.jpg” 파일패스를 포함한 컨텐츠의 파일명
     

      Ex) MMSDummy.exe "2" "3" "PHOTO" "\NATE Store\미디어 앨범\PIC_02.jpg" "VIDEO" "\NATE Store\미디어 앨범\move_01.skm" "PHOTO" "\NATE Store\미디어 앨범\PIC_01.jpg"

      è MMS Client를 구동해서 컨텐츠보관함 UI에서 작성모드로 경로 “\\NATE Store\\미디어 앨범”에 있는 PIC_01.jpg, PIC_02.jpg 이미지와 “\\NATE Store\\미디어 앨범”에 있는 move_01.skm 을 첨부하여 구동시킴 

         * 3rd Party App은 단말 사진 앨범에서 사용자가 최대 3개의 사진을 선택하여 전송할 수 있다.

      1. Text 를 전달하여 메시지를 작성하기 위한 연동 규격

      MMS Client 구동 시 메시지를 작성 창에 Text를 포함하기 위한 연동 규격은 다음과 같다.  

      • <RunMode> 형식

      실행 모드 ID 값은 “5” 를 부여한다. 

      • [parameter] 구성 형식
      Text Information
     
      필드명 의미 정의
      Text

      Information

      메시지 작성시 들어갈 Text Data “오늘 모임 장소는 강남역 7번 출구입니다.” Text 는 최대 2,000byte 이하로 해야 한다.
     

           Ex) MMSDummy.exe “5” “오늘 모임 장소는 강남역 7번 출구입니다.” 

      1. Text 를 전달하여 메시지를 작성하기 위한 연동 규격

      MMS Client 구동 시 메시지를 작성 창에 Text를 포함하기  위한 연동 규격은 다음과 같다.  

      • <RunMode> 형식

      실행 모드 ID 값은 “5” 를 부여한다. 

      • [parameter] 구성 형식
      Text Information
     
      필드명 의미 정의
      Text

      Information

      메시지 작성시 들어갈 Text Data “오늘 모임 장소는 강남역 7번 출구입니다.” Text 는 최대 2,000byte 이하로 해야 한다.
     

           Ex) MMSDummy.exe “5” “오늘 모임 장소는 강남역 7번 출구입니다.”

      1. 상용구 메시지를 보내기 위한 연동 규격

      상용구 메시지를 보내기 위해 MMS Client 구동하기  위한 연동 규격은 다음과 같다.  

      • <RunMode> 형식

      실행 모드 ID 값은 “6” 를 부여한다. 

      • [parameter] 구성 형식
      Receive Information
     
      필드명 의미 정의
      Receive

      Information

      수신자 정보 “0111231234” 상용구 메시지를 전달하기 위한 수신자 정보
     

           Ex) MMSDummy.exe “6” “0101231234”

           è 상용구 메시지를 전달하기 화면을 구동함



      옴니아2 의 경우 MMSDummy.exe ==> MMSC.exe 로 사용.

    반응형

    댓글

Designed by Tistory.