4 * Copyright (c) 2000 - 2011 Samsung Electronics Co., Ltd. All rights reserved.
6 * Contact: Jonghyuk Choi <jhchoi.choi@samsung.com>
8 * Licensed under the Apache License, Version 2.0 (the "License");
9 * you may not use this file except in compliance with the License.
10 * You may obtain a copy of the License at
12 * http://www.apache.org/licenses/LICENSE-2.0
14 * Unless required by applicable law or agreed to in writing, software
15 * distributed under the License is distributed on an "AS IS" BASIS,
16 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
17 * See the License for the specific language governing permissions and
18 * limitations under the License.
23 #ifndef __MM_MESSAGE_H__
24 #define __MM_MESSAGE_H__
35 * @brief This file declares the messages type of Multimedia framework.
38 * This file declares the messages type of Multimedia framework.
42 * Enumerations of messages type.
46 MM_MESSAGE_UNKNOWN = 0x00, /**< Unknown message type */
47 MM_MESSAGE_ERROR, /**< Error message type */
48 MM_MESSAGE_WARNING, /**< Warning message type */
49 MM_MESSAGE_STATE_CHANGED, /**< State change message type */
50 MM_MESSAGE_STATE_INTERRUPTED, /**< State change by interrupt */
51 MM_MESSAGE_READY_TO_RESUME, /**< Ready to resume message type */
54 MM_MESSAGE_CONNECTING = 0x100, /**< Connecting message type */
55 MM_MESSAGE_CONNECTED, /**< Rtspsrc has successed to connecting to server */
56 MM_MESSAGE_CONNECTION_TIMEOUT, /**< Connection timeout message type */
57 MM_MESSAGE_BUFFERING, /**< Buffering message type */
58 MM_MESSAGE_BEGIN_OF_STREAM, /**< Streaming begin message type */
59 MM_MESSAGE_END_OF_STREAM, /**< End of stream message type */
60 MM_MESSAGE_BLUETOOTH_ON, /**< Bluetooth A2DP Connection ON */
61 MM_MESSAGE_BLUETOOTH_OFF, /**< Bluetooth A2DP Connection OFF */
62 MM_MESSAGE_RESUMED_BY_REW, /**< Resumed by fast rewind message type */
63 MM_MESSAGE_UPDATE_SUBTITLE, /**< Update subtitle type */
64 MM_MESSAGE_RTP_SENDER_REPORT, /**< RTP sender report */
65 MM_MESSAGE_RTP_RECEIVER_REPORT, /**< RTP receiver report */
66 MM_MESSAGE_RTP_SESSION_STATUS, /**< RTP session status */
67 MM_MESSAGE_SENDER_STATE, /**< Sender state */
68 MM_MESSAGE_RECEIVER_STATE, /**< Receiver state */
69 MM_MESSAGE_FILE_NOT_SUPPORTED, /**< Not supported file */
70 MM_MESSAGE_FILE_NOT_FOUND, /**< Not founded file */
71 MM_MESSAGE_DRM_NOT_AUTHORIZED, /**< Not authorized to play the content */
72 MM_MESSAGE_VIDEO_CAPTURED, /**< Video frame has been captured */
73 MM_MESSAGE_VIDEO_NOT_CAPTURED, /**< video capture failed */
74 MM_MESSAGE_SEEK_COMPLETED, /**< Seek completed */
75 MM_MESSAGE_PD_DOWNLOADER_START, /**< PD downloader start message */
76 MM_MESSAGE_PD_DOWNLOADER_END, /**< PD downloader end message */
77 MM_MESSAGE_IMAGE_BUFFER, /**< hls image buffer message type */
78 MM_MESSAGE_DRM_NO_LICENSE, /**< No license */
79 MM_MESSAGE_DRM_EXPIRED, /**< Expired license */
80 MM_MESSAGE_DRM_FUTURE_USE, /**< License for future use */
81 MM_MESSAGE_VIDEO_BIN_CREATED, /**< Video bin is created */
82 MM_MESSAGE_GAPLESS_CONSTRUCTION, /**< pipeline is under the construction for gapless */
83 MM_MESSAGE_PLAY_POSITION, /**< Play position */
86 MM_MESSAGE_CAMCORDER_STATE_CHANGED = 0x200, /**< State changed.*/
87 MM_MESSAGE_CAMCORDER_STATE_CHANGED_BY_ASM, /**< State change by audio session manager message type */
88 MM_MESSAGE_CAMCORDER_MAX_SIZE, /**< Maximum size, camcorder waits for user's order (cam_commit/cancel).*/
89 MM_MESSAGE_CAMCORDER_NO_FREE_SPACE, /**< No free space, camcorder waits for user's order (cam_commit/cancel).*/
90 MM_MESSAGE_CAMCORDER_TIME_LIMIT, /**< Time limit, camcorder waits for user's order (cam_commit/cancel)*/
91 MM_MESSAGE_CAMCORDER_CAPTURED, /**< Image captured */
92 MM_MESSAGE_CAMCORDER_ERROR, /**< Error occurred.*/
93 MM_MESSAGE_CAMCORDER_FOCUS_CHANGED, /**< Focus changed */
94 MM_MESSAGE_CAMCORDER_CURRENT_VOLUME, /**< Current volume level of real input stream */
95 MM_MESSAGE_CAMCORDER_FIRMWARE_UPDATE, /**< Firmware update */
96 MM_MESSAGE_CAMCORDER_RECORDING_STATUS, /**< Recording status. (Elapsed time, total time, file size(KB))*/
97 MM_MESSAGE_CAMCORDER_STATE_CHANGED_BY_SECURITY, /**< State change by system security(ex:MDM) message type */
98 MM_MESSAGE_CAMCORDER_VIDEO_SNAPSHOT_CAPTURED, /**< Image captured while video recording */
99 MM_MESSAGE_CAMCORDER_HDR_PROGRESS, /**< Progressing percent of HDR capture */
100 MM_MESSAGE_CAMCORDER_FACE_DETECT_INFO, /**< Face detection information */
101 MM_MESSAGE_CAMCORDER_VIDEO_CAPTURED, /**< Video captured */
102 MM_MESSAGE_CAMCORDER_AUDIO_CAPTURED, /**< Audio captured */
103 MM_MESSAGE_CAMCORDER_LOW_LIGHT_STATE, /**< Low light state */
104 MM_MESSAGE_CAMCORDER_CAPTURE_SOUND, /**< Noti to play capture sound - only single capture available */
105 MM_MESSAGE_CAMCORDER_CAPTURE_SOUND_COMPLETED, /**< Noti to play capture sound completed - only single capture available */
106 MM_MESSAGE_CAMCORDER_STATE_CHANGED_BY_RM, /**< State change by resource manager.*/
109 MM_MESSAGE_RADIO_SCAN_START = 0x300, /**< Radio frequency scanning initiated */
110 MM_MESSAGE_RADIO_SCAN_INFO, /**< Founded radio frequency report. check message parameters */
111 MM_MESSAGE_RADIO_SCAN_FINISH, /**< Radio frequency scanning has finished */
112 MM_MESSAGE_RADIO_SCAN_STOP, /**< Radio frequency scanning has stopped */
113 MM_MESSAGE_RADIO_SEEK_START, /**< Radio seeking has established */
114 MM_MESSAGE_RADIO_SEEK_FINISH, /**< Radio seeking has finished */
115 MM_MESSAGE_RADIO_SET_FREQUENCY, /**< Radio set frequency async*/
116 MM_MESSAGE_RADIO_RDS_PS, /**< Radio RDS Program Service Data has arrived> */
117 MM_MESSAGE_RADIO_RDS_RT, /**< Radio RDS Radio Text Data has arrived> */
121 MM_MESSAGE_MEDIACALL_RESERVED = 0x400, /**< Reserved message for Media Call */
124 MM_MESSAGE_IMAGE_RESERVED = 0x500, /**< Reserved message for Image */
127 MM_MESSAGE_SOUND_PCM_CAPTURE_RESTRICTED = 0x600, /**< Sound pcm capture is restricted by system */
128 MM_MESSAGE_SOUND_PCM_INTERRUPTED, /**< Sound pcm is interrupted by audio system */
131 MM_MESSAGE_FILEINFO_RESERVED = 0x700, /**< Reserved message for File Info */
133 /* STREAM RECORDER */
134 MM_MESSAGE_STREAMRECORDER_ERROR = 0x800,
135 MM_MESSAGE_STREAMRECORDER_CONSUME_COMPLETE,
136 MM_MESSAGE_STREAMRECORDER_STATE_CHANGED,
137 MM_MESSAGE_STREAMRECORDER_MAX_SIZE, /**< Maximum size, streamcorder waits for user's order (commit/cancel) */
138 MM_MESSAGE_STREAMRECORDER_NO_FREE_SPACE, /**< No free space,streamcorder waits for user's order (commit/cancel) */
139 MM_MESSAGE_STREAMRECORDER_TIME_LIMIT, /**< Time limit, streamcorder waits for user's order (commit/cancel) */
140 MM_MESSAGE_STREAMRECORDER_RECORDING_STATUS, /**< Recording status. (Elapsed time, total time, file size(KB)) */
141 MM_MESSAGE_STREAMRECORDER_VIDEO_CAPTURED, /**< Video captured done. This message will be called when video capture is finished (eos) */
142 MM_MESSAGE_STREAMRECORDER_AUDIO_CAPTURED, /**< Audio captured done. This message will be called when audio capture is finished (eos) */
144 MM_MESSAGE_NUM, /**< The number of the messages */
149 * Union type of 'MMMessageParamType' structure. Please add type when you make new union type of MMMessageParamType
151 enum MMMessageUnionType {
152 MM_MSG_UNION_CODE, /**< Default */
155 MM_MSG_UNION_CONNECTION,
156 MM_MSG_UNION_FIRMWARE,
157 MM_MSG_UNION_RTPSENDER_REPORT,
158 MM_MSG_UNION_RTPRECEIVER_REPORT,
159 MM_MSG_UNION_RTPSESSION_STATUS,
160 MM_MSG_UNION_SUBTITLE,
161 MM_MSG_UNION_RADIO_SCAN,
162 MM_MSG_UNION_RECORDING_STATUS,
163 MM_MSG_UNION_REC_VOLUME_DB,
164 MM_MSG_UNION_CONSUME_RECORDER_BUFFER,
168 * Enumerations of code for MM_MESSAGE_STATE_INTERRUPTED messages type.
170 enum MMMessageInterruptedCode {
171 MM_MSG_CODE_INTERRUPTED_BY_MEDIA = 0,
172 MM_MSG_CODE_INTERRUPTED_BY_CALL_START,
173 MM_MSG_CODE_INTERRUPTED_BY_CALL_END,
174 MM_MSG_CODE_INTERRUPTED_BY_EARJACK_UNPLUG,
175 MM_MSG_CODE_INTERRUPTED_BY_RESOURCE_CONFLICT,
176 MM_MSG_CODE_INTERRUPTED_BY_ALARM_START,
177 MM_MSG_CODE_INTERRUPTED_BY_ALARM_END,
178 MM_MSG_CODE_INTERRUPTED_BY_EMERGENCY_START,
179 MM_MSG_CODE_INTERRUPTED_BY_EMERGENCY_END,
180 MM_MSG_CODE_INTERRUPTED_BY_OTHER_PLAYER_APP,
181 MM_MSG_CODE_INTERRUPTED_BY_NOTIFICATION_START,
182 MM_MSG_CODE_INTERRUPTED_BY_NOTIFICATION_END,
186 * Enumerations of code for MM_MESSAGE_SOUND_PCM_CAPTURE_RESTRICTED messages type.
188 enum MMMessagePcmCaptureCode {
189 MM_MSG_CODE_PCM_CAPTURE_RESTRICTED = 0,
190 MM_MSG_CODE_PCM_CAPTURE_ALLOWED,
194 * Message callback function type.
196 typedef int (*MMMessageCallback) (int id, void *param, void *user_param);
202 void *data; /**< Allocated data */
207 int union_type; /**< Type of union. Please refer MMMessageUnionType */
210 int code; /**< Error or warning code */
215 int previous; /**< Previous state */
216 int current; /**< Current state */
217 int code; /**< Error or warning code */
223 unsigned int elapsed; /**< Elapsed time */
224 unsigned int total; /**< Total time */
230 unsigned int buffering; /**< Buffering percent */
237 int state; /**< Update state*/
238 int progress; /**< Update progress percentage */
244 unsigned char is_valid; /**< Structure is valid or not */
245 //int64 ntptime; /**< The NTP timestamp indicates the point of time measured in wall clock time when this report was sent. */ unsigned int rtptime; /**< The RTP timestamp resembles the same time as the NTP timestamp ,but is measured in the same units and with the same random offset as the RTP timestamps in data packets */
246 unsigned long long ntptime; /**< The NTP timestamp indicates the point of time measured in wall clock time when this report was sent. */ unsigned int rtptime; /**< The RTP timestamp resembles the same time as the NTP timestamp ,but is measured in the same units and with the same random offset as the RTP timestamps in data packets */
247 unsigned int packet_count; /**< The sender's packet count totals up the number of RTP data packets transmitted by the sender since joining the RTP session */
248 unsigned int octet_count; /**< The total number of payload octets (i.e., not including the header or any padding) transmitted in RTP data packets by the sender since starting up transmission */
249 } RTPSenderReport; /**< RTPSenderReport message parameter structure. */
254 unsigned char is_valid; /**< Structure is valid or not */
255 unsigned int ssrc; /**< The SSRC identifier of the sender whose reception is reported in this block . who the report is from */
256 unsigned char fractionlost; /**< The sender of the receiver report estimates the fraction of the RTP data packets from source SSRC_n that it assumes to be lost since it sent the previous SR or RR packet.*/
257 unsigned int packetslost; /**< The sender of a receiver report blocks also tries to estimate the total number of RTP data packets from source SSRC_n that have been lost since the beginning of reception. Packets that arrive late are not counted as lost, and the loss may be negative if there are duplicates. */
258 unsigned int exthighestseq; /**< The low 16 bits of the extended highest sequence number contain the highest sequence number received in an RTP data packet from source SSRC_n, and the most significant 16 bits extend that sequence number with the corresponding count of sequence number cycles. */
259 unsigned int jitter; /**< An estimate of the statistical variance of the RTP data packet inter-arrival time, measured in timestamp units and expressed as an unsigned intege */
260 unsigned int lsr; /**< Last SR Timestamp */
261 unsigned int dlsr; /**< Delay since last SR Timestamp */
262 } RTPReceiverReport; /**< RTPReceiverReport message parameter structure. */
267 double bandwidth; /**< Bandwidth Modifier*/
268 double sender_fraction; /**< Fraction of packet loss by sender*/
269 double receiver_fraction; /**< Fraction of packet loss from Receiver*/
270 double rtcp_bandwidth; /**< The total bandwidth that will be used for RTCP packets by all members of this session, in octets per second */
271 double min_interval; /**< Minimum Interval */
272 unsigned int sender_sources; /**< Identifies the synchronization source from sender*/
273 unsigned int active_sources; /**< Identifies the Active source from sender*/
274 unsigned int avg_rtcp_packet_size; /**< Average RTCP packet size */
275 unsigned int bye_members; /**< BYE Packet members */
276 } RTPSessionStatus; /**< RTPSessionStatus message parameter structure. */
281 unsigned long duration; /**< duration */
288 int frequency; /**< detected active frequency with MM_MESSAGE_RADIO_SCAN_INFO */
292 * Radio RDS PS and RT Info
295 int frequency; /**< The frequency at which the RDS data was obtained> */
296 char* rt_ps; /**< the radio text obtained with MM_MESSAGE_RADIO_RDS_PS and MM_MESSAGE_RADIO_RDS_RT */
302 unsigned long long elapsed; /**< Elapsed time (ms) */
303 unsigned long long total; /**< Total time */
304 unsigned long long filesize; /**< Recording File size (KB). An approximate value. */
305 unsigned long long remained_time; /**< Remained time (ms).
306 This is available if time limit is not set or
307 time limit is bigger than estimated remained time. */
311 * Recording volume level - dB
316 void * consumed_buffer;
318 } consumed_mediabuffer;
321 * Video frame capture
324 unsigned int width; /* width of captured image */
325 unsigned int height; /* height of captured image */
326 unsigned int orientation; /* orientation of captured image */
330 int size; /**< Allocated size of 'data' */
332 int reserved; /**< reserved field for future use */
333 } MMMessageParamType;
344 #endif /* __MM_MESSAGE_H__ */