5.1.6. 매체 처리기

사운드나 동영상등의 모든 Media 에 대해서 처리를 해주는 매체 처리기와 관련된 함수와 톤 재생 및 음성녹음 및 볼륨 조절에 관련한 패키지 이다

사운드, 톤, 동영상등의 모든 데이타는 클립(CLIP)으로 추상화되어 매체처리기에 서 수행한다. 매체재생기에서 지원하는 타입은 MC_knlSetSystemProperty()의 "MEDIADEVICES"에 의해 구해진 타입들이다.

매체처리, 톤 재생, 녹음 등의 상태 변화는 등록하는 콜백 함수로 전달된다. 볼륨 조절은 톤, 사운드, 녹음에 대해 각각 가능하다.

MC_MDA_STATUS_ERROR

설명

오류로 인한 정지 상태. 상수값은 -1.

프로토타입

#define MC_MDA_STATUS_ERROR (-1)

MC_MDA_STATUS_END_OF_DATA

설명

매체(혹은 톤)처리시 - 처리기가 매체(혹은 톤) 데이터의 마지막에 도달한 상태. 상수값은 1.

프로토타입

#define MC_MDA_STATUS_END_OF_DATA 1

MC_MDA_STATUS_START

설명

매체(혹은 톤)처리시 - 매체(혹은 톤) 처리를 시작한 상태. 상수값은 2.

프로토타입

#define MC_MDA_STATUS_STARTED 2

MC_MDA_STATUS_STOPP

설명

매체(혹은 톤)처리시 - 매체(혹은 톤) 처리를 종료한 상태 녹음시 – 녹음을 중단한 상태. 상수값은 3

MC_MDA_STATUS_PAUSE

프로토타입

#define MC_MDA_STATUS_STOPP 3

프로토타입

#define MC_MDA_STATUS_PAUSED 4

설명

매체(혹은 톤)처리시 - 매체(혹은 톤) 처리를 잠시 멈춘 상태 녹음시 – 녹음을 잠시 멈춘 상태. 상수값은 4

MC_MDA_STATUS_RESUME

설명

매체(혹은 톤)처리시 - 잠시 멈춘 매체(혹은 톤) 처리를 재개한 상태 녹음시 – 잠시 멈춘 녹음을 재개한 상태. 상수값은 5

프로토타입

#define MC_MDA_STATUS_RESUMED 5

MC_MDA_STATUS_RECORD

설명

녹음시 – 녹음을 시작한 상태. 상수값은 6

프로토타입

#define MC_MDA_STATUS_RECORDED 6

MC_MDA_STATUS_FULL_OF_DATA

설명

녹음시 – 클립내부버퍼가 완전히 채워진 상태. 상수값은 7.

프로토타입

#define MC_MDA_STATUS_FULL_OF_DATA 7

MC_MDA_VOLSEL_CUR

설명

현재 볼륨값을 의미하는 상수. 상수값은 0.

프로토타입

#define MC_MDA_VOLSEL_CUR 0

MC_MDA_VOLSEL_MIN

설명

최소 볼륨값을 의미하는 상수. 상수값은 1.

프로토타입

#define MC_MDA_VOLSEL_MIN 1

MC_MDA_VOLSEL_MAX

설명

최대 볼륨값을 의미하는 상수. 상수값은 2.

프로토타입

#define MC_MDA_VOLSEL_MAX 2

(*MEDIACB)

설명

처리기의 상태가 변경될 때 불려지는 콜백함수. 상태 값은 매체 처리 상태를 참조.

프로토타입

typedef void (*MEDIACB)(MC_MdaClip* clip, M_Int32 status)

매개 변수

clip - ? 클립
status ? 매체처리기 상태

부작용

없음

참고 항목

없음

MC_mdaClipCreate

설명

특정 타입의 CLIP 을 생성한다. 지원되는 타입은 MC_knlSetSystemProperty()의 “MEDIADEVICES”에 의해 구해진 타입들이다. 타입은 MIME 에서 지원하는 타입일 경 우 “audio/xxx”, “video/xxx”와 같이 MIME 타입을 따른다.

메모리 버퍼를 데이터로 입력하고자 하는 경우 MC_mdaClipPutData()를 통하고, file 로 데이터를 입력하고자 하는 경우 MC_mdaClipPutDataByFile() 을 통하여 재 생할 데이터를 입력한다.

Clip 의 버퍼 크기는 입력하고자 하는 데이터의 전체 크기만큼 생성해야 한다.

콜백함수가 설정되지 않으면 매채재생기의 상태변화가 전달되지 않는다.

프로토타입

MC_MdaClip* MC_mdaClipCreate(M_Char* mType, M_Int32 bufSize, MEDIACB cb)

매개 변수

mType - [in] 미디어타입
bufSzie - [in] 버퍼 크기(CLIP 내에 생성될 버퍼크기)
cb - [in] 클립을 매체처리기에서 처리하는중 상태변화를 알려 줄 콜백함수

반환 값

성공

MC_MdaClip 객체 포인터 0

실패

부작용

없음

참고 항목

없음

MC_mdaClipFree

설명

클립에 할당된 모든 리소스를 해제한다.

프로토타입

M_Int32 MC_mdaClipFree(MC_MdaClip* clip)

매개 변수

clip - [in] 클립

반환 값

성공

실패

M_E_INUSE - 클립을 재생중이거나 녹음중에 해제할려고 시도함
M_E_INVALID - clip 이 NULL 이면 리턴

부작용

없음

참고 항목

없음

MC_mdaClipGetType

설명

클립의 타입을 구한다.

프로토타입

M_Int32 MC_mdaClipGetType(MC_MdaClip* clip, M_Byte* buf, M_Int32 bufSize)

매개 변수

clip - [in] 클립
buf – [out] 타입이 저장될 버퍼
bufSize – [in] 복사할 버퍼 크기

반환 값

성공

실패

M_E_SHORTBUF - 저장할 버퍼가 작음

부작용

없음

참고 항목

없음

MC_mdaClipPutData

설명

입력 할 미디어 데이터가 메모리에 저장되어 있을 때 클립에 미디어 데이타를 복 사한다. 미디어 데이타는 클립생성당시 설정한 타입의 데이타이어야 한다. 클립내 의 데이타는 매체재생기에서 재생되면 줄어들고, MC_mdaClipPutData()로 늘어나게 된다. 복사할 데이타가 크기가 클립내부버퍼가 수용할 데이타보다 크면 수용할 수 있는 만큼만 복사된다.

프로토타입

M_Int32 MC_mdaClipPutData (MC_MdaClip* clip, M_Byte* buf, M_Int32 size)

매개 변수

clip - [in] 클립
buf – [in] 직접버퍼
size – [in] 복사할 버퍼 크기

반환 값

성공

복사된 크기

실패

없음

부작용

없음

참고 항목

없음

MC_mdaClipPutDataByFile

설명

입력 할 미디어 데이터가 파일로 저장되어 있을 때, 클립에 미디어 데이타를 복사 한다. 미디어 데이타는 클립생성당시 설정한 타입의 데이타이어야 한다. 클립내의 데이타는 매체재생기에서 재생되면 줄어들고, MC_mdaClipPutData()로 늘어나게 된 다. 복사할 데이타가 크기가 클립내부버퍼가 수용할 데이타보다 크면 수용할 수 있는 만큼만 복사된다.

프로토타입

M_Int32 MC_mdaClipPutData (MC_MdaClip* clip, M_Byte* filename, M_Int32 size, M_Int32 aMode)

매개 변수

clip - [in] 클립
filename – [in] 복사해올 파일 이름
size – [in] 복사할 버퍼 크기
aMode
- MC_DIR_PRIVATE_ACCESS - private 디렉토리에 접근
- MC_DIR_SHARED_ACCESS - shared 디렉토리에 접근
- MC_DIR_SYSTEM_ACCESS - system 디렉토리에 접근

반환 값

성공

복사된 크기

실패

없음

부작용

없음

참고 항목

없음

MC_mdaClipGetData

설명

클립에서 버퍼로 미디어 데이타를 복사한다. 클립내의 데이타는 매체재생기에서 녹음되면 늘어나고, MC_mdaClipGetData()로 줄어들게 된다. 클립내부의 데이타가 전달한 버퍼보다 크면 버퍼크기만큼만 복사된다. 이 함수는 클립 타입이 "MEDIADEVICES"에서 얻어진 타입일때 사용된다.

프로토타입

M_Int32 MC_mdaClipGetData(MC_MdaClip* clip, M_Byte* buf, M_Int32 size)

매개 변수

clip - [in] 클립
buf – [in] 직접버퍼
size – [in] 복사할 버퍼 크기

반환 값

성공

복사된 크기

실패

없음

부작용

없음

참고 항목

없음

MC_mdaClipAvailableDataSize

설명

클립에서 이용가능한 데이타 크기(클립 내부버퍼 크기가 아님)

프로토타입

M_Int32 MC_mdaClipAvailableDataSize(MC_MdaClip* clip)

매개 변수

clip - [in] 클립

반환 값

이용가능한 데이타 크기

부작용

없음

참고 항목

없음

MC_mdaClipClearData

설명

클립내의 이용가능한 데이타를 모두 버린다.

프로토타입

M_Int32 MC_mdaClipClearData(MC_MdaClip* clip)

매개 변수

clip - [in] 클립

반환 값

성공

실패

M_E_ERROR – 사운드 재생이나 일시정지 상태에서 이 함수가 호출 될 경우 발생함.

부작용

없음

참고 항목

없음

MC_mdaClipSetPosition

설명

재생을 시작할 위치를 설정한다. 재생위치 설정기능을 지원하지 않는 타입으로 생성된 클립에 이 함수를 호출할 경우, M_E_NOTSUP 가 반환된다.

프로토타입

M_Int32 MC_mdaClipSetPosition(MC_MdaClip* clip, M_Int32 ms)

매개 변수

clip - [in] 클립
ms – [in] 클립 재생을 시작할 시작 시점(milli second)

반환 값

성공

실패

M_E_NOTSUP - ? 클립재생기가 재생위치 설정기능을 제공하지 않음
M_E_ERROR – 설정 실패

부작용

없음

참고 항목

없음

MC_mdaClipGetVolume

설명

클립 재생기의 볼륨을 읽어온다. 클립 재생기의 독립적인 볼륨 설정을 지원할 경우, 이 함수는 클립 재생기의 볼륨을 읽어온다. 지원하지 않을 경우는, 클립생성 타입이 달라도 같은 볼륨소스를 가리킬 수 있다.

볼륨의 최소값은 0, 최대값은 100 이다.

프로토타입

M_Int32 MC_mdaClipGetVolume(MC_MdaClip* clip)

매개 변수

clip - [in] 클립

반환 값

성공

볼륨값

실패

M_E_NOTSUP – 볼륨값이 존재하지 않는 미디어 장치부작용

참고 항목

없음

MC_mdaClipSetVolume

설명

클립 재생기의 볼륨을 설정한다. 클립 재생기의 독립적인 볼륨 설정을 지원할 경 우, 이 함수는 클립 재생기의 볼륨을 설정한다. 지원하지 않을 경우는, 클립생성 타입이 달라도 같은 볼륨소스를 가리킬 수 있다. 볼륨값의 최소는 0, 최대는 100 이다.

프로토타입

void MC_mdaClipSetVolume(MC_MdaClip* clip, M_Int32 level)

매개 변수

clip - [in] 클립
level – [in] 볼륨 값(0-100사이의 볼륨값)

반환 값

M_E_NOTSUP – 볼륨값 설정을 지원하지 않는 미디어 장치

부작용

없음

참고 항목

없음

MC_mdaPlay

설명

클립의 데이타를 재생한다.

이 함수가 불려 매체처리를 시작하면 클립생성시 등록된 콜백 함수에 MC_MDA_STATUS_STARTED 상태가 전달된다. 이미 함수가 불려 매체를 처리하고 있었 다면 이 함수는 아무런 역할을 하지 않는다. 클립데이타가 소진되면 콜백함수에 MC_MDA_STATUS_END_OF_DATA 상태가 전달된다.

스트리밍 재생을 하고 싶은 경우에는 클립 데이타가 완전 소진되기 전에, 주기적 으로 MC_mdaClipPutData()로 클립 데이타를 채워주어야 한다.

프로토타입

M_Int32 MC_mdaPlay(MC_MdaClip* clip, M_Boolean repeat)

매개 변수

clip - [in] 클립
repeat - [in] 0 이면 한번, 1 이면 반복 재생

반환 값

성공

실패

M_E_INUSE – 클립재생기가 이미 다른 클립을 재생하고 있음
M_E_ERROR – 이미 같은 클립을 재생중에 있음

부작용

없음

참고 항목

없음

MC_mdaPause

설명

매체 처리(재생/녹음)를 일시적으로 멈춘다.

이 함수가 불려 매체처리 일시 정지하게 되면 클립생성시 등록한 콜백 함수에 MC_MDA_STATUS_PAUSED 상태가 전달된다. 일시로 멈추어 있거나, 정지되어 있는 처리기에 대해서 이 함수를 다시 부르면, 이 함수는 아무런 역할을 하지 않는다.

프로토타입

M_Int32 MC_mdaPause(MC_MdaClip* clip)

매개 변수

clip - [in] 클립

반환 값

성공

실패

M_E_NOTSUP – paue 를 지원하지 않는 클립재생기
M_E_ERROR - 이미 멈추어 있거나, 정지되어 있음

부작용

없음

참고 항목

없음

MC_mdaResume

설명

일시 정지한 매체처리(재생/녹음)를 재개한다.

이 함수가 불려 매체처리를 재개하면 클립생성시 등록한 콜백 함수에 MC_MDA_STATUS_RESUMED 상태가 전달된다. 매채처리중인 처리기에 대해서 이 함수 를 다시 부르면, 이 함수는 아무런 역활을 하지 않는다.

프로토타입

M_Int32 MC_mdaResume(MC_MdaClip* clip)

매개 변수

clip - [in] 클립

반환 값

성공

실패

M_E_NOTSUP – resume 를 지원하지 않는 클립재생기
M_E_ERROR - 이미 매체처리중

부작용

없음

참고 항목

없음

MC_mdaStop

설명

매체처리(재생/녹음)를 종료한다.

이 함수가 불려 매체처리를 종료하면 클립생성시 등록한 콜백 함수에 MC_MDA_STATUS_STOPPED 상태가 전달된다. 정지되어 있는 처리기에 대해서 이 함수를 다시 부르면, 이 함수는 아무런 역활을 하지 않는다.

프로토타입

M_Int32 MC_mdaStop(MC_MdaClip* clip)

매개 변수

clip - [in] 클립

반환 값

성공

0 실패
M_E_ERROR - 이미 정지되어 있음

부작용

없음

참고 항목

없음

MC_ mdaRecord

설명

녹음을 시작한다.

녹음을 지원하지 않는 타입으로 생성된 클립으로 녹음을 시도할 경우, 아무기능도 하지 않는다. 이 함수가 불려 매체처리를 시작하면 클립생성시 등록된 콜백 함수에 MC_MDA_STATUS_RECORDED 상태가 전달된다. 이미 함수가 불려 녹음중이었다면, 이 함수는 아무런 역할을 하지 않는다. 녹음 중, 클립 내부버퍼가 완전히 차면 콜 백함수에 MC_MDA_STATUS_FULL 상태가 전달된다.

스트리밍 녹음을 하고 싶은 경우에는 클립 내부버퍼가 완전히 차기전에, 주기적으로 MC_mdaClipGetData()로 클립 내부버퍼를 비워주어야 한다.

프로토타입

M_Int32 MC_mdaRecord(MC_MdaClip* clip)

매개 변수

clip - [in] 클립

반환 값

성공

실패

M_E_INUSE – 이미녹음중인 다른클립이 있음
M_E_ERROR – 이미 같은 클립을 녹음중에 있음

부작용

없음

참고 항목

없음

MC_mdaGetVolume

설명

볼륨의 값을 리턴한다. 각 디바이스마다 독립적인 볼륨이 설정되었을 경우, 이 값 은 정확하지 않을 수 있다. 그럴경우, 정확한 각 디바이스의 볼륨은 MC_mdaClipGetVolume()으로 읽어와야 한다 반환되는 볼륨값은 0 – 100 사이의 값으로 환산하여 반환되어야 한다. 0-100 사이값을 어느정도의 볼륨세기와 일치시 키는가는 아래의 예처럼 하드웨어가 지원하는 볼륨단계를 백분율로 일치시킨것에 따른다. 하드웨어가 몇단계의 볼륨세기를 지원하는가는 MC_knlGetSystemProperty()에서 반환한다.

예) 볼륨세기가 강, 약 두개인 하드웨어 => 1-50 : 약볼륨 51-100 : 강볼륨 볼륨세기가 강,중,약 세개인 하드웨어 => 1-33:약볼륨, 34 -66:중볼륨, 67-100:강볼륨

프로토타입

M_int32 MC_mdaGetVolume()

매개 변수

반환 값

볼륨 값

부작용

없음

참고 항목

없음

MC_mdaSetVolume

설명

볼륨을 설정한다. 볼륨을 설정할 수 있는 모든 디바이스의 볼륨을 설정한다. 각 디바이스마다 독립적인 불륨을 설정할 경우, Clip 에 있는 볼륨 API 을 이용하도록 한다. 설정할 볼륨의 최소값은 0 이고, 최대값은 100 이다.

프로토타입

void MC_mdaSetVolume(M_Int32 value)

매개 변수

value - [in] 볼륨값(0-100 사이의 볼륨값)

반환 값

없음

부작용

없음

참고 항목

없음

MC_mdaVibrator

설명

Vibrator 를 제어 한다. 지정한 시간 동안 on 시킨 후 자동으로 꺼진다.

매개변수 level값이 0보다 큰 경우만 timeout 값이 유효하다. level값 0은 virbrator 가 꺼지는 것을 의미한다. 진동강도는 매개변수 level값으로 정해지고 0-100사이의 값 이 올수 있다. 100은 하드웨어가 지원하는 가장 강한 진동을 0은 가장 약한 진동을 의 미한다. 0-100사이값을 어느정도의 진동세기와 일치시키는가는 아래의 예처럼 하드웨 어가 지원하는 진동단계를 백분율로 일치시킨것에 따른다. 하드웨어가 몇단계의 진동 세기를 지원하는가는 MC_knlGetSystemProperty(“VIBRATORLEVEL”) 에서 알수 있다.

예) 진동세기가 하나인 하드웨어 => 1-100 : 진동 진동세기가 강, 약 두개인 하드웨어 => 1-50 : 약진동, 51-100 : 강진동 진동세기가 강,중,약 세개인 하드웨어 => 1-33:약진동, 34-66:중진동, 67-100:강진동

프로토타입

void MC_mdaVibrator(M_Int32 level, M_Int32 timeout)

매개 변수

level - [in] 0 이면 off, 1-100 이면 운영체제에서 일치시킨 진동세기로 진동
timeout - [in] 진동시간, 밀리초 단위

부작용

없음

참고 항목

없음

MC_mdaSetMuteState

설명

단말기의 음원별 소리 발생 방지를 설정한다.

프로토타입

M_Int32 MC_mdaSetMuteState(M_int32 source, M_Boolean bmute)

매개 변수

source – [in] 볼륨소스. MC_MDA_VOLTYPE_TONE, MC_MDA_VOLTYPE_SOUND,MC_MDA_VOLTYPE_RECORDER 중의 하나가 될 수 있다
bmute – [in] 소리발생 방지 설정
- TRUE - 소리 발생 방지
- FALSE - 소리 발생 허용

반환 값

성공

M_E_SUCCESS – 성공

실패

M_E_ERROR – 실패

부작용

없음

참고 항목

없음

MC_mdaGetMuteState

설명

단말기의 음원별 소리 발생 방지 설정 상태를 얻는다.

프로토타입

M_Boolean MC_mdaGetMuteState(M_int32 source)

매개 변수

source – [in] 볼륨소스. MC_MDA_VOLTYPE_TONE, MC_MDA_VOLTYPE_SOUND,MC_MDA_VOLTYPE_RECORDER 중의 하나가 될 수 있다

반환 값

TRUE - 소리 발생 방지
FALSE - 소리 발생 허용

부작용

없음

참고 항목

없음