4 * Copyright (c) 2000 - 2011 Samsung Electronics Co., Ltd. All rights reserved.
6 * Contact: JongHyuk Choi <jhchoi.choi@samsung.com>, YeJin Cho <cho.yejin@samsung.com>,
7 * Seungbae Shin <seungbae.shin@samsung.com>, YoungHwan An <younghwan_.an@samsung.com>
9 * Licensed under the Apache License, Version 2.0 (the "License");
10 * you may not use this file except in compliance with the License.
11 * You may obtain a copy of the License at
13 * http://www.apache.org/licenses/LICENSE-2.0
15 * Unless required by applicable law or agreed to in writing, software
16 * distributed under the License is distributed on an "AS IS" BASIS,
17 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
18 * See the License for the specific language governing permissions and
19 * limitations under the License.
23 #ifndef __MM_PLAYER_PRIV_H__
24 #define __MM_PLAYER_PRIV_H__
26 /*===========================================================================================
30 ========================================================================================== */
39 #include <tbm_bufmgr.h>
41 #include "mm_player.h"
42 #include "mm_player_internal.h"
43 #include "mm_player_audioeffect.h"
44 #include "mm_message.h"
45 #include "mm_player_ini.h"
46 #include <mm_resource_manager.h>
47 #include "mm_player_sound_focus.h"
48 #include "mm_player_pd.h"
49 #include "mm_player_streaming.h"
51 /*===========================================================================================
53 | GLOBAL DEFINITIONS AND DECLARATIONS FOR MODULE |
55 ========================================================================================== */
57 /*---------------------------------------------------------------------------
59 ---------------------------------------------------------------------------*/
60 #define MM_PLAYER_IMGB_MPLANE_MAX 4
61 #define MM_PLAYER_STREAM_COUNT_MAX 3
63 #define MM_PLAYER_CAST(x_player) ((mm_player_t *)(x_player))
65 * @x_player: MMHandleType of player
67 * Get the PD downloader of this player.
69 #define MM_PLAYER_GET_PD(x_player) (MM_PLAYER_CAST(x_player)->pd_downloader)
71 * @x_player: MMHandleType of player
73 * Get the attributes handle of this player.
75 #define MM_PLAYER_GET_ATTRS(x_player) (MM_PLAYER_CAST(x_player)->attrs)
77 #define ROTATION_USING_SINK 0
78 #define ROTATION_USING_CUSTOM 1
79 #define ROTATION_USING_FLIP 2
81 #define MM_MAX_STRING_LENGTH 4000 /* have to be less than MUSE_MSG_MAX_LENGTH */
83 #define VIDEO360_MAX_ZOOM 10.0f
85 /*---------------------------------------------------------------------------
86 | GLOBAL CONSTANT DEFINITIONS: |
87 ---------------------------------------------------------------------------*/
89 AUDIO_LATENCY_MODE_LOW = 0, /**< Low audio latency mode */
90 AUDIO_LATENCY_MODE_MID, /**< Middle audio latency mode */
91 AUDIO_LATENCY_MODE_HIGH, /**< High audio latency mode */
95 TAG_AUDIO_CODEC = 0x0001,
96 TAG_VIDEO_CODEC = 0x0002,
101 TAG_COPYRIGHT = 0x0040,
103 TAG_DESCRIPTION = 0x0100,
104 TAG_TRACK_NUMBER = 0x0200
107 enum content_attr_flag {
108 ATTR_MISSING_ONLY = 0x0001,
109 ATTR_DURATION = 0x0002,
112 ATTR_BITRATE = 0x0010,
116 /* async mode makes trouble. alsasink sometimes fails to pause. */
123 * Enumerations of Player Uri type
125 enum MMPlayerUriType {
126 MM_PLAYER_URI_TYPE_NONE, /**< Player URI type None */
127 MM_PLAYER_URI_TYPE_URL_RTSP, /**< Player URI type RTSP */
128 MM_PLAYER_URI_TYPE_URL_HTTP, /**< Player URI type HTTP */
129 MM_PLAYER_URI_TYPE_URL_MMS, /**< Player URI type MMS */
130 MM_PLAYER_URI_TYPE_MEM, /**< Player URI type Mem */
131 MM_PLAYER_URI_TYPE_FILE, /**< Player URI type File */
132 MM_PLAYER_URI_TYPE_URL, /**< Player URI type URL */
133 MM_PLAYER_URI_TYPE_MS_BUFF, /**< Player URI type Media Stream Buffer */
134 MM_PLAYER_URI_TYPE_HLS, /**< Player URI type http live streaming */
135 MM_PLAYER_URI_TYPE_SS, /**< Player URI type Smooth streaming */
136 MM_PLAYER_URI_TYPE_DASH, /**< Player URI type Mpeg Dash */
137 MM_PLAYER_URI_TYPE_NO_PERMISSION, /**< Player URI type No Permission */
138 MM_PLAYER_URI_TYPE_TEMP, /**< Player URI type Temp */
141 typedef enum _MissingCodec {
142 MISSING_PLUGIN_NONE = 0x00,
143 MISSING_PLUGIN_AUDIO = 0x01,
144 MISSING_PLUGIN_VIDEO = 0x02
148 typedef enum _FoundCodec {
149 FOUND_PLUGIN_NONE = 0x00,
150 FOUND_PLUGIN_AUDIO = 0x01,
151 FOUND_PLUGIN_VIDEO = 0x02
155 * Enumeration of signal type
158 MM_PLAYER_SIGNAL_TYPE_AUTOPLUG = 0,
159 MM_PLAYER_SIGNAL_TYPE_VIDEOBIN,
160 MM_PLAYER_SIGNAL_TYPE_AUDIOBIN,
161 MM_PLAYER_SIGNAL_TYPE_TEXTBIN,
162 MM_PLAYER_SIGNAL_TYPE_OTHERS,
163 MM_PLAYER_SIGNAL_TYPE_ALL,
164 MM_PLAYER_SIGNAL_TYPE_MAX = MM_PLAYER_SIGNAL_TYPE_ALL,
165 } MMPlayerSignalType;
167 /* main pipeline's element id */
169 MMPLAYER_M_PIPE = 0, /* NOTE : MMPLAYER_M_PIPE should be zero */
171 MMPLAYER_M_2ND_SRC, /* 2nd Source Element for es buff src */
174 /* it could be a decodebin or could be a typefind. depends on player ini */
178 MMPLAYER_M_AUTOPLUG_V_DEC,
179 MMPLAYER_M_AUTOPLUG_A_DEC,
181 /* NOTE : we need two fakesink to autoplug without decodebin.
182 * first one will hold whole pipeline state. and second one will hold state of
183 * a sink-decodebin for an elementary stream. no metter if there's more then one
184 * elementary streams because MSL reuse it.
186 MMPLAYER_M_SRC_FAKESINK,
187 MMPLAYER_M_SRC_2ND_FAKESINK,
189 /* streaming plugin */
190 MMPLAYER_M_MUXED_S_BUFFER,
191 MMPLAYER_M_DEMUXED_S_BUFFER,
193 MMPLAYER_M_ADAPTIVE_DEMUX,
195 /* es buff src queue */
200 /* FIXIT : if there's really no usage for following IDs. remove it */
208 MMPLAYER_M_V_INPUT_SELECTOR, // video input_select
209 MMPLAYER_M_A_INPUT_SELECTOR, // audio input_select
210 MMPLAYER_M_T_INPUT_SELECTOR, // text input_select
216 MMPLAYER_M_A_DEINTERLEAVE,
217 MMPLAYER_M_A_SELECTOR,
223 /* audio pipeline's element id */
224 enum AudioElementID {
225 MMPLAYER_A_BIN = 0, /* NOTE : MMPLAYER_A_BIN should be zero */
230 MMPLAYER_A_FILTER_SEC,
231 MMPLAYER_A_CAPS_DEFAULT,
232 MMPLAYER_A_CONV_BFORMAT,
235 MMPLAYER_A_RESAMPLER,
236 MMPLAYER_A_DEINTERLEAVE,
240 /* video pipeline's element id */
241 enum VideoElementID {
242 MMPLAYER_V_BIN = 0, /* NOTE : MMPLAYER_V_BIN should be zero */
252 /* text pipeline's element id */
254 MMPLAYER_T_BIN = 0, /* NOTE : MMPLAYER_V_BIN should be zero */
256 MMPLAYER_T_VIDEO_QUEUE,
257 MMPLAYER_T_VIDEO_CONVERTER,
259 MMPLAYER_T_FAKE_SINK,
264 /* midi main pipeline's element id */
267 MMPLAYER_MIDI_PLAYER,
271 enum PlayerCommandState {
272 MMPLAYER_COMMAND_NONE,
273 MMPLAYER_COMMAND_CREATE,
274 MMPLAYER_COMMAND_DESTROY,
275 MMPLAYER_COMMAND_UNREALIZE,
276 MMPLAYER_COMMAND_START,
277 MMPLAYER_COMMAND_REALIZE,
278 MMPLAYER_COMMAND_STOP,
279 MMPLAYER_COMMAND_PAUSE,
280 MMPLAYER_COMMAND_RESUME,
284 /* Note : StreamingSrcError is error enum for streaming source which post error message
285 * using custom message made by itself. The enum value must start with zero,
286 * because the streaming source(secrtspsrc) also does.
288 enum StreamingSrcError {
289 MMPLAYER_STREAMING_ERROR_NONE = 0,
290 MMPLAYER_STREAMING_ERROR_UNSUPPORTED_AUDIO,
291 MMPLAYER_STREAMING_ERROR_UNSUPPORTED_VIDEO,
292 MMPLAYER_STREAMING_ERROR_CONNECTION_FAIL,
293 MMPLAYER_STREAMING_ERROR_DNS_FAIL,
294 MMPLAYER_STREAMING_ERROR_SERVER_DISCONNECTED,
295 MMPLAYER_STREAMING_ERROR_BAD_SERVER,
296 MMPLAYER_STREAMING_ERROR_INVALID_PROTOCOL,
297 MMPLAYER_STREAMING_ERROR_INVALID_URL,
298 MMPLAYER_STREAMING_ERROR_UNEXPECTED_MSG,
299 MMPLAYER_STREAMING_ERROR_OUT_OF_MEMORIES,
300 MMPLAYER_STREAMING_ERROR_RTSP_TIMEOUT,
301 MMPLAYER_STREAMING_ERROR_BAD_REQUEST,
302 MMPLAYER_STREAMING_ERROR_NOT_AUTHORIZED,
303 MMPLAYER_STREAMING_ERROR_PAYMENT_REQUIRED,
304 MMPLAYER_STREAMING_ERROR_FORBIDDEN,
305 MMPLAYER_STREAMING_ERROR_CONTENT_NOT_FOUND,
306 MMPLAYER_STREAMING_ERROR_METHOD_NOT_ALLOWED,
307 MMPLAYER_STREAMING_ERROR_NOT_ACCEPTABLE,
308 MMPLAYER_STREAMING_ERROR_PROXY_AUTHENTICATION_REQUIRED,
309 MMPLAYER_STREAMING_ERROR_SERVER_TIMEOUT,
310 MMPLAYER_STREAMING_ERROR_GONE,
311 MMPLAYER_STREAMING_ERROR_LENGTH_REQUIRED,
312 MMPLAYER_STREAMING_ERROR_PRECONDITION_FAILED,
313 MMPLAYER_STREAMING_ERROR_REQUEST_ENTITY_TOO_LARGE,
314 MMPLAYER_STREAMING_ERROR_REQUEST_URI_TOO_LARGE,
315 MMPLAYER_STREAMING_ERROR_UNSUPPORTED_MEDIA_TYPE,
316 MMPLAYER_STREAMING_ERROR_PARAMETER_NOT_UNDERSTOOD,
317 MMPLAYER_STREAMING_ERROR_CONFERENCE_NOT_FOUND,
318 MMPLAYER_STREAMING_ERROR_NOT_ENOUGH_BANDWIDTH,
319 MMPLAYER_STREAMING_ERROR_NO_SESSION_ID,
320 MMPLAYER_STREAMING_ERROR_METHOD_NOT_VALID_IN_THIS_STATE,
321 MMPLAYER_STREAMING_ERROR_HEADER_FIELD_NOT_VALID_FOR_SOURCE,
322 MMPLAYER_STREAMING_ERROR_INVALID_RANGE,
323 MMPLAYER_STREAMING_ERROR_PARAMETER_IS_READONLY,
324 MMPLAYER_STREAMING_ERROR_AGGREGATE_OP_NOT_ALLOWED,
325 MMPLAYER_STREAMING_ERROR_ONLY_AGGREGATE_OP_ALLOWED,
326 MMPLAYER_STREAMING_ERROR_BAD_TRANSPORT,
327 MMPLAYER_STREAMING_ERROR_DESTINATION_UNREACHABLE,
328 MMPLAYER_STREAMING_ERROR_INTERNAL_SERVER_ERROR,
329 MMPLAYER_STREAMING_ERROR_NOT_IMPLEMENTED,
330 MMPLAYER_STREAMING_ERROR_BAD_GATEWAY,
331 MMPLAYER_STREAMING_ERROR_SERVICE_UNAVAILABLE,
332 MMPLAYER_STREAMING_ERROR_GATEWAY_TIME_OUT ,
333 MMPLAYER_STREAMING_ERROR_RTSP_VERSION_NOT_SUPPORTED,
334 MMPLAYER_STREAMING_ERROR_OPTION_NOT_SUPPORTED,
338 MMPLAYER_PATH_VOD = 0,
343 /* Video360 related enums. These are duplication from video360.h from
347 VIDEO360_MODE_UNKNOWN = -1,
348 VIDEO360_MODE_MONOSCOPIC = 0,
349 VIDEO360_MODE_STEREOSCOPIC_TOP_BOTTOM = 1,
350 VIDEO360_MODE_STEREOSCOPIC_LEFT_RIGHT = 2,
351 VIDEO360_MODE_STEREOSCOPIC_STEREO_MESH = 3,
352 VIDEO360_MODE_LAST_ITEM
353 } mm_player_stereo_mode_e;
356 VIDEO360_PROJECTION_TYPE_UNKNOWN = -1,
357 VIDEO360_PROJECTION_TYPE_EQUIRECTANGULAR = 0,
358 VIDEO360_PROJECTION_TYPE_CUBEMAP = 1,
359 VIDEO360_PROJECTION_TYPE_MESH = 2,
360 VIDEO360_PROJECTION_TYPE_LAST_ITEM
361 } mm_player_projection_type_e;
363 /* Spatial audio related enums. These are duplication from mm_file.h from
367 MMFILE_AMBISONIC_TYPE_UNKNOWN = 0,
368 MMFILE_AMBISONIC_TYPE_PERIPHONIC = 1, /**< To comply with Google's Spatial Audio RFC*/
369 MMFILE_AMBISONIC_TYPE_NON_PERIPHONIC = 2,
370 } MMFILE_AMBISONIC_TYPE;
373 MMFILE_AMBISONIC_FORMAT_UNKNOWN = 0,
374 MMFILE_AMBISONIC_FORMAT_AMBIX = 1, /**< AMBIX (Channel sequence: ACN, Normalization: SN3D) */
375 MMFILE_AMBISONIC_FORMAT_AMB = 2, /**< .AMB, Tetraproc (Channel sequence: FuMa, Normalization: FuMa) */
376 MMFILE_AMBISONIC_FORMAT_UA = 3, /**< Universal Ambisonics (Channel sequence: SID, Normalization: N3D) */
377 } MMFILE_AMBISONIC_FORMAT;
380 MMFILE_AMBISONIC_ORDER_UNKNOWN = 0,
381 MMFILE_AMBISONIC_ORDER_FOA = 1, /**< First order Ambisonics */
382 MMFILE_AMBISONIC_ORDER_SOA = 2, /**< Second order Ambisonics */
383 MMFILE_AMBISONIC_ORDER_TOA = 3, /**< Third order Ambisonics */
384 } MMFILE_AMBISONIC_ORDER;
386 /*---------------------------------------------------------------------------
387 | GLOBAL DATA TYPE DEFINITIONS: |
388 ---------------------------------------------------------------------------*/
393 } MMPlayerGstElement;
396 GstTagList *tag_list;
397 MMPlayerGstElement *mainbin;
398 MMPlayerGstElement *audiobin;
399 MMPlayerGstElement *videobin;
400 MMPlayerGstElement *textbin;
401 } MMPlayerGstPipelineInfo;
406 int bluetooth; /* enable/disable */
414 } tBuffer; /* FIXIT : choose better name */
421 char uri[MM_MAX_URL_LEN];
422 char urgent[MM_MAX_FILENAME_LEN];
423 } MMPlayerParseProfile;
427 storage_state_e state;
429 char path[MM_MAX_URL_LEN];
430 } MMPlayerStorageInfo;
434 MMPlayerPosFormatType format;
436 } MMPlayerPendingSeek;
441 } MMPlayerSignalItem;
447 bool video_zc; // video zero-copy
449 bool media_packet_video_stream;
458 gint active_pad_index;
459 gint total_track_num;
462 gulong event_probe_id;
463 } mm_player_selector_t;
468 gboolean stream_changed;
469 gboolean reconfigure;
471 GstClockTime start_time[MM_PLAYER_TRACK_TYPE_MAX]; /* updated once get SEGMENT event */
472 GstSegment segment[MM_PLAYER_TRACK_TYPE_MAX];
473 gboolean update_segment[MM_PLAYER_TRACK_TYPE_MAX];
475 } mm_player_gapless_t;
481 bool is_little_endian;
482 guint64 channel_mask;
486 } mm_player_audio_stream_buff_t;
489 * @brief data of video_bo_list
490 * @details this will be used when the sw codec is running.
496 } mm_player_video_bo_info_t;
507 } MMAdaptiveVariantInfo;
512 char *stitching_software;
513 char *projection_type_string;
514 char *stereo_mode_string;
515 mm_player_projection_type_e projection_type;
516 mm_player_stereo_mode_e stereo_mode;
518 int init_view_heading;
522 int full_pano_width_pixels;
523 int full_pano_height_pixels;
524 int cropped_area_image_width;
525 int cropped_area_image_height;
526 int cropped_area_left;
527 int cropped_area_top;
529 int ambisonic_format;
531 } mm_player_spherical_metadata_t;
535 int state; // player current state
536 int prev_state; // player previous state
537 int pending_state; // player state which is going to now
538 int target_state; // player state which user want to go to
539 guint state_change_timeout;
541 gboolean section_repeat;
542 gint section_repeat_start;
543 gint section_repeat_end;
552 GMutex playback_lock;
554 /* repeat thread lock */
555 GCond repeat_thread_cond;
556 GMutex repeat_thread_mutex;
557 GThread* repeat_thread;
558 gboolean repeat_thread_exit;
560 /* next play thread */
561 GThread* next_play_thread;
562 gboolean next_play_thread_exit;
563 GCond next_play_thread_cond;
564 GMutex next_play_thread_mutex;
565 mm_player_gapless_t gapless;
568 GThread* capture_thread;
569 gboolean capture_thread_exit;
570 GCond capture_thread_cond;
571 GMutex capture_thread_mutex;
572 MMPlayerVideoCapture capture;
573 MMPlayerVideoColorspace video_cs;
574 MMVideoBuffer captured;
576 /* gst bus msg thread, create during realize */
577 GThread* bus_msg_thread;
578 gboolean bus_msg_thread_exit;
579 GCond bus_msg_thread_cond;
580 GMutex bus_msg_thread_mutex;
581 gint bus_msg_timeout; /* ms */
583 /* fakesink handling lock */
586 /* update tag lock */
587 GMutex update_tag_lock;
589 /* player attributes */
592 /* message callback */
593 MMMessageCallback msg_cb;
596 /* progressive download */
597 mm_player_pd_t *pd_downloader;
598 gchar *pd_file_save_path;
599 MMPlayerPDMode pd_mode;
601 /* streaming player */
602 mm_player_streaming_t *streamer;
603 gchar *http_file_buffering_path;
605 /* gstreamer pipeline */
606 MMPlayerGstPipelineInfo *pipeline;
609 GstPad *ghost_pad_for_videobin;
611 guint64 media_stream_buffer_max_size[MM_PLAYER_STREAM_TYPE_MAX];
612 guint media_stream_buffer_min_percent[MM_PLAYER_STREAM_TYPE_MAX];
613 mm_player_media_stream_buffer_status_callback media_stream_buffer_status_cb[MM_PLAYER_STREAM_TYPE_MAX];
614 mm_player_media_stream_seek_data_callback media_stream_seek_data_cb[MM_PLAYER_STREAM_TYPE_MAX];
615 GMutex media_stream_cb_lock;
617 int video_num_buffers; /* total num of buffers in vcodec */
618 int video_extra_num_buffers; /* extra num of buffers in vcodec */
620 void* buffer_cb_user_param[MM_PLAYER_STREAM_TYPE_MAX];
621 void* seek_cb_user_param[MM_PLAYER_STREAM_TYPE_MAX];
623 /* video stream changed callback */
624 mm_player_stream_changed_callback video_stream_changed_cb;
625 void* video_stream_changed_cb_user_param;
627 /* audio stream changed callback */
628 mm_player_stream_changed_callback audio_stream_changed_cb;
629 void* audio_stream_changed_cb_user_param;
631 /* video stream callback */
632 mm_player_video_stream_callback video_stream_cb;
633 void* video_stream_cb_user_param;
635 GMutex video_bo_mutex;
636 GList* video_bo_list; /* mm_player_video_bo_info_t, bo list for decoded video data by sw codec */
638 bool video_stream_prerolled;
640 /* audio stram callback */
641 mm_player_audio_stream_callback audio_stream_cb;
642 void* audio_stream_cb_user_param;
643 bool audio_stream_sink_sync;
644 GList* audio_stream_buff_list; /* mm_player_audio_stream_buff_t, buff list of extract pcm data */
646 /* audio buffer callback */
647 mm_player_audio_stream_callback_ex audio_stream_render_cb_ex;
649 /* video capture callback*/
650 gulong video_capture_cb_probe_id;
653 MMPlayerSoundInfo sound;
658 /* video stream caps parsed by demuxer */
659 GstCaps* v_stream_caps;
661 /* audio effect infomation */
662 MMAudioEffectInfo audio_effect_info;
663 gboolean bypass_audio_effect;
665 gulong audio_cb_probe_id;
670 /* content profile */
671 MMPlayerParseProfile profile;
672 MMPlayerStorageInfo storage_info[MMPLAYER_PATH_MAX];
674 /* streaming service type */
675 MMStreamingType streaming_type;
679 gboolean have_dynamic_pad;
680 GList* parsers; // list of linked parser name
681 GList* audio_decoders; // list of linked audio name
682 gboolean no_more_pad;
683 gint num_dynamic_pad;
684 gboolean has_many_types;
686 /* progress callback timer */
687 /* FIXIT : since duplicated functionality with get_position
688 * this function will be deprecated after fixing all application
689 * which are using it.
691 guint progress_timer;
693 /* timer for sending delayed EOS */
696 /* last point (msec) that player is paused or seeking */
697 gint64 last_position;
702 /* data size of http streaming */
703 guint64 http_content_size;
706 gchar last_error_msg[1024]; /* FIXIT : should it be dynamic ? */
708 gboolean smooth_streaming;
710 gint videodec_linked;
711 gint audiodec_linked;
712 gint videosink_linked;
713 gint audiosink_linked;
714 gint textsink_linked;
716 /* missing plugin during autoplugging */
717 MissingCodec not_supported_codec;
719 /* unlinked audio/video mime type */
720 gchar *unlinked_video_mime;
721 gchar *unlinked_audio_mime;
722 gchar *unlinked_demuxer_mime;
724 /* found codec during autoplugging */
725 FoundCodec can_support_codec;
727 gboolean not_found_demuxer;
729 /* support seek even though player is not start */
730 MMPlayerPendingSeek pending_seek;
734 /* prevent to post msg over and over */
737 /* list of sink elements */
738 GList* sink_elements;
740 /* signal notifiers */
741 GList* signals[MM_PLAYER_SIGNAL_TYPE_MAX];
742 GMainContext *global_default;
743 MMPlayerUriList uri_info;
745 gboolean is_sound_extraction;
747 gfloat playback_rate;
749 /* player state resumed by fast rewind */
750 gboolean resumed_by_rewind;
752 gboolean is_nv12_tiled;
754 /* resource manager for H/W resources */
755 mm_resource_manager_h resource_manager;
756 mm_resource_manager_res_h video_overlay_resource;
757 mm_resource_manager_res_h video_decoder_resource;
758 gboolean interrupted_by_resource;
760 /* sound focus for being compatible with legacy session policy internally */
761 MMPlayerSoundFocus sound_focus;
763 gboolean is_subtitle_off;
764 gboolean is_external_subtitle_present;
765 gboolean is_external_subtitle_added_now;
766 gboolean pending_resume;
768 /* contents bitrate for buffering management */
769 guint bitrate[MM_PLAYER_STREAM_COUNT_MAX];
771 guint updated_bitrate_count;
772 guint maximum_bitrate[MM_PLAYER_STREAM_COUNT_MAX];
773 guint total_maximum_bitrate;
774 guint updated_maximum_bitrate_count;
776 /* prevent it from posting duplicatly*/
779 /* timeout source for lazy pause */
780 guint resume_event_id;
781 guint resumable_cancel_id;
783 gboolean play_subtitle;
784 gboolean is_subtitle_force_drop; // set TRUE after bus_cb get EOS
786 /* PD downloader message callback and param */
787 MMMessageCallback pd_msg_cb;
788 void* pd_msg_cb_param;
790 /* adjust subtitle position store */
791 gint64 adjust_subtitle_pos;
792 GList *subtitle_language_list;
793 GCond subtitle_info_cond;
794 GMutex subtitle_info_mutex;
796 /* To store the current multiwindow status */
797 gboolean last_multiwin_status;
799 /* To store the current running audio pad index of demuxer */
800 gint demux_pad_index;
802 mm_player_selector_t selector[MM_PLAYER_TRACK_TYPE_MAX];
803 mm_player_selector_t audio_mode;
804 gboolean use_deinterleave;
805 guint max_audio_channels;
807 guint internal_text_idx;
808 guint external_text_idx;
810 MMPlayerSetMode set_mode;
812 /* initialize values */
815 /* video share sync */
816 gint64 video_share_api_delta;
817 gint64 video_share_clock_delta;
819 /* just for native app (video hub) */
820 gboolean video_hub_download_mode;
821 gboolean sync_handler;
823 /* store dump pad list */
826 /* whether a video has closed caption or not */
827 gboolean has_closed_caption;
829 GstElement *video_fakesink;
831 /* audio stream caps parsed by demuxer or set by external demuxer */
832 GstCaps* a_stream_caps;
834 /* subtitle stream caps parsed by demuxer or set by external demuxer */
835 GstCaps* s_stream_caps;
837 /* es player using feed-data callback or calling app_src_push_buffer directly*/
838 gboolean es_player_push_mode;
840 /* tmb buffer manager for s/w codec tmb_bo */
846 MMAdaptiveVariantInfo adaptive_info;
848 /* Video360 related stuff
850 bool is_content_spherical;
851 mm_player_spherical_metadata_t video360_metadata;
852 bool is_openal_plugin_used;
853 bool is_video360_plugin_used;
854 /* User settable values */
855 bool is_video360_enabled;
856 float video360_yaw_radians;
857 float video360_pitch_radians;
859 int video360_horizontal_fov;
860 int video360_vertical_fov;
865 gchar *language_code;
868 } MMPlayerLangStruct;
872 gulong probe_handle_id;
873 FILE *dump_element_file;
881 int valid_type; // validity type
882 int value_min; //<- set validity value range
886 /*===========================================================================================
888 | GLOBAL FUNCTION PROTOTYPES |
890 ========================================================================================== */
895 int _mmplayer_create_player(MMHandleType hplayer);
896 int _mmplayer_destroy(MMHandleType hplayer);
897 int _mmplayer_realize(MMHandleType hplayer);
898 int _mmplayer_unrealize(MMHandleType hplayer);
899 int _mmplayer_get_state(MMHandleType hplayer, int* pstate);
900 int _mmplayer_set_volume(MMHandleType hplayer, MMPlayerVolumeType volume);
901 int _mmplayer_get_volume(MMHandleType hplayer, MMPlayerVolumeType *volume);
902 int _mmplayer_set_mute(MMHandleType hplayer, int mute);
903 int _mmplayer_get_mute(MMHandleType hplayer, int* pmute);
904 int _mmplayer_start(MMHandleType hplayer);
905 int _mmplayer_stop(MMHandleType hplayer);
906 int _mmplayer_pause(MMHandleType hplayer);
907 int _mmplayer_resume(MMHandleType hplayer);
908 int _mmplayer_set_position(MMHandleType hplayer, int format, int pos);
909 int _mmplayer_get_position(MMHandleType hplayer, int format, unsigned long *pos);
910 int _mmplayer_adjust_subtitle_postion(MMHandleType hplayer, int format, int pos);
911 int _mmplayer_adjust_video_postion(MMHandleType hplayer, int offset);
912 int _mmplayer_activate_section_repeat(MMHandleType hplayer, unsigned long start, unsigned long end);
913 int _mmplayer_deactivate_section_repeat(MMHandleType hplayer);
914 int _mmplayer_set_playspeed(MMHandleType hplayer, float rate, bool streaming);
915 int _mmplayer_set_message_callback(MMHandleType hplayer, MMMessageCallback callback, void *user_param);
916 int _mmplayer_set_videostream_changed_cb(MMHandleType hplayer, mm_player_stream_changed_callback callback, void *user_param);
917 int _mmplayer_set_audiostream_changed_cb(MMHandleType hplayer, mm_player_stream_changed_callback callback, void *user_param);
918 int _mmplayer_set_videostream_cb(MMHandleType hplayer, mm_player_video_stream_callback callback, void *user_param);
919 int _mmplayer_set_audiostream_cb(MMHandleType hplayer, mm_player_audio_stream_callback callback, void *user_param);
920 int _mmplayer_set_subtitle_silent(MMHandleType hplayer, int silent);
921 int _mmplayer_get_subtitle_silent(MMHandleType hplayer, int* silent);
922 int _mmplayer_set_external_subtitle_path(MMHandleType hplayer, const char* filepath);
923 int _mmplayer_get_buffer_position(MMHandleType hplayer, int format, unsigned long* start_pos, unsigned long* stop_pos);
925 /* test API for tuning audio gain. this API should be
926 * deprecated before the day of final release
928 int _mmplayer_set_volume_tune(MMHandleType hplayer, MMPlayerVolumeType volume);
929 int _mmplayer_update_video_param(mm_player_t* player, char *param_name);
930 int _mmplayer_set_audiobuffer_cb(MMHandleType hplayer, mm_player_audio_stream_callback callback, void *user_param);
931 int _mmplayer_change_videosink(MMHandleType handle, MMDisplaySurfaceType surface_type, void *display_overlay);
932 int _mmplayer_audio_effect_custom_apply(mm_player_t *player);
934 int _mmplayer_set_audiostream_cb_ex(MMHandleType hplayer, bool sync, mm_player_audio_stream_callback_ex callback, void *user_param);
935 gboolean __mmplayer_post_message(mm_player_t* player, enum MMMessageType msgtype, MMMessageParamType* param);
937 int _mmplayer_change_track_language(MMHandleType hplayer, MMPlayerTrackType type, int index);
938 int _mmplayer_sync_subtitle_pipeline(mm_player_t* player);
939 int _mmplayer_set_video_hub_download_mode(MMHandleType hplayer, bool mode);
940 int _mmplayer_use_system_clock(MMHandleType hplayer);
941 int _mmplayer_set_video_share_master_clock(MMHandleType hplayer, long long clock, long long clock_delta, long long video_time, long long media_clock, long long audio_time);
942 int _mmplayer_get_video_share_master_clock(MMHandleType hplayer, long long *video_time, long long *media_clock, long long *audio_time);
943 int _mmplayer_enable_sync_handler(MMHandleType hplayer, bool enable);
944 int _mmplayer_set_file_buffering_path(MMHandleType hplayer, const char* file_path);
945 int _mmplayer_set_uri(MMHandleType hplayer, const char* uri);
946 int _mmplayer_set_next_uri(MMHandleType hplayer, const char* uri, bool is_first_path);
947 int _mmplayer_get_next_uri(MMHandleType hplayer, char** uri);
948 int _mmplayer_has_closed_caption(MMHandleType hplayer, bool* exist);
949 void _mm_player_video_stream_internal_buffer_unref(void *buffer);
950 int _mmplayer_set_pcm_spec(MMHandleType hplayer, int samplerate, int channel);
951 int _mmplayer_get_timeout(MMHandleType hplayer, int *timeout);
952 int _mmplayer_get_num_of_video_out_buffers(MMHandleType hplayer, int *num, int *extra_num);
953 int _mmplayer_manage_external_storage_state(MMHandleType hplayer, int id, int state);
954 int __mmplayer_gst_set_state(mm_player_t* player, GstElement * pipeline, GstState state, gboolean async, gint timeout);
955 int __mmplayer_set_state(mm_player_t* player, int state);
956 int __mmplayer_check_state(mm_player_t* player, enum PlayerCommandState command);
957 gboolean __mmplayer_dump_pipeline_state(mm_player_t* player);
958 void __mmplayer_remove_g_source_from_context(GMainContext *context, guint source_id);
959 void _mmplayer_bus_msg_thread_destroy(MMHandleType hplayer);
962 const gchar * __get_state_name(int state);
963 gboolean __mmplayer_can_do_interrupt(mm_player_t *player);
964 gboolean __is_streaming(mm_player_t* player);
965 gboolean __is_rtsp_streaming(mm_player_t* player);
966 gboolean __is_live_streaming(mm_player_t* player);
967 gboolean __is_http_streaming(mm_player_t* player);
968 gboolean __is_http_live_streaming(mm_player_t* player);
969 gboolean __is_dash_streaming(mm_player_t* player);
970 gboolean __is_smooth_streaming(mm_player_t* player);
971 gboolean __is_http_progressive_down(mm_player_t* player);
973 gboolean __mmplayer_check_useful_message(mm_player_t *player, GstMessage * message);
974 gboolean __mmplayer_handle_gst_error(mm_player_t* player, GstMessage * message, GError* error);
975 gint __gst_handle_core_error(mm_player_t* player, int code);
976 gint __gst_handle_library_error(mm_player_t* player, int code);
977 gint __gst_handle_resource_error(mm_player_t* player, int code, GstMessage * message);
978 gint __gst_handle_stream_error(mm_player_t* player, GError* error, GstMessage * message);
979 int _mmplayer_sound_register_with_pid(MMHandleType hplayer, int pid);
980 int _mmplayer_get_client_pid(MMHandleType hplayer, int* pid);
981 int __mmplayer_get_video_angle(mm_player_t* player, int *user_angle, int *org_angle);
982 int _mmplayer_video_stream_release_bo(mm_player_t* player, void* bo);
983 int _mmplayer_get_adaptive_variant_info(MMHandleType hplayer, int *num, char **var_info);
984 int _mmplayer_set_max_adaptive_variant_limit(MMHandleType hplayer, int bandwidth, int width, int height);
985 int _mmplayer_get_max_adaptive_variant_limit(MMHandleType hplayer, int *bandwidth, int *width, int *height);
986 int _mmplayer_set_audio_only(MMHandleType hplayer, bool audio_only);
987 int _mmplayer_get_audio_only(MMHandleType hplayer, bool *paudio_only);
988 int _mmplayer_set_streaming_buffering_time(MMHandleType hplayer, int buffer_ms, int rebuffer_ms);
989 int _mmplayer_get_streaming_buffering_time(MMHandleType hplayer, int *buffer_ms, int *rebuffer_ms);
990 int _mmplayer_set_codec_type(MMHandleType hplayer, MMPlayerStreamType stream_type, MMPlayerVideoCodecType codec_type);
996 #endif /* __MM_PLAYER_PRIV_H__ */