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_pd.h"
48 #include "mm_player_streaming.h"
50 /*===========================================================================================
52 | GLOBAL DEFINITIONS AND DECLARATIONS FOR MODULE |
54 ========================================================================================== */
56 /*---------------------------------------------------------------------------
58 ---------------------------------------------------------------------------*/
59 #define MM_PLAYER_IMGB_MPLANE_MAX 4
60 #define MM_PLAYER_STREAM_COUNT_MAX 3
62 #define MM_PLAYER_CAST(x_player) ((mm_player_t *)(x_player))
64 * @x_player: MMHandleType of player
66 * Get the PD downloader of this player.
68 #define MM_PLAYER_GET_PD(x_player) (MM_PLAYER_CAST(x_player)->pd_downloader)
70 * @x_player: MMHandleType of player
72 * Get the attributes handle of this player.
74 #define MM_PLAYER_GET_ATTRS(x_player) (MM_PLAYER_CAST(x_player)->attrs)
76 #define ROTATION_USING_SINK 0
77 #define ROTATION_USING_CUSTOM 1
78 #define ROTATION_USING_FLIP 2
80 #define MM_MAX_STRING_LENGTH 4000 /* have to be less than MUSE_MSG_MAX_LENGTH */
82 #define VIDEO360_MAX_ZOOM 10.0f
84 /*---------------------------------------------------------------------------
85 | GLOBAL CONSTANT DEFINITIONS: |
86 ---------------------------------------------------------------------------*/
88 AUDIO_LATENCY_MODE_LOW = 0, /**< Low audio latency mode */
89 AUDIO_LATENCY_MODE_MID, /**< Middle audio latency mode */
90 AUDIO_LATENCY_MODE_HIGH, /**< High audio latency mode */
94 TAG_AUDIO_CODEC = 0x0001,
95 TAG_VIDEO_CODEC = 0x0002,
100 TAG_COPYRIGHT = 0x0040,
102 TAG_DESCRIPTION = 0x0100,
103 TAG_TRACK_NUMBER = 0x0200
106 enum content_attr_flag {
107 ATTR_MISSING_ONLY = 0x0001,
108 ATTR_DURATION = 0x0002,
111 ATTR_BITRATE = 0x0010,
115 /* async mode makes trouble. alsasink sometimes fails to pause. */
122 * Enumerations of Player Uri type
124 enum MMPlayerUriType {
125 MM_PLAYER_URI_TYPE_NONE, /**< Player URI type None */
126 MM_PLAYER_URI_TYPE_URL_RTSP, /**< Player URI type RTSP */
127 MM_PLAYER_URI_TYPE_URL_HTTP, /**< Player URI type HTTP */
128 MM_PLAYER_URI_TYPE_URL_MMS, /**< Player URI type MMS */
129 MM_PLAYER_URI_TYPE_MEM, /**< Player URI type Mem */
130 MM_PLAYER_URI_TYPE_FILE, /**< Player URI type File */
131 MM_PLAYER_URI_TYPE_URL, /**< Player URI type URL */
132 MM_PLAYER_URI_TYPE_MS_BUFF, /**< Player URI type Media Stream Buffer */
133 MM_PLAYER_URI_TYPE_HLS, /**< Player URI type http live streaming */
134 MM_PLAYER_URI_TYPE_SS, /**< Player URI type Smooth streaming */
135 MM_PLAYER_URI_TYPE_DASH, /**< Player URI type Mpeg Dash */
136 MM_PLAYER_URI_TYPE_NO_PERMISSION, /**< Player URI type No Permission */
137 MM_PLAYER_URI_TYPE_TEMP, /**< Player URI type Temp */
140 typedef enum _MissingCodec {
141 MISSING_PLUGIN_NONE = 0x00,
142 MISSING_PLUGIN_AUDIO = 0x01,
143 MISSING_PLUGIN_VIDEO = 0x02
147 typedef enum _FoundCodec {
148 FOUND_PLUGIN_NONE = 0x00,
149 FOUND_PLUGIN_AUDIO = 0x01,
150 FOUND_PLUGIN_VIDEO = 0x02
154 * Enumeration of signal type
157 MM_PLAYER_SIGNAL_TYPE_AUTOPLUG = 0,
158 MM_PLAYER_SIGNAL_TYPE_VIDEOBIN,
159 MM_PLAYER_SIGNAL_TYPE_AUDIOBIN,
160 MM_PLAYER_SIGNAL_TYPE_TEXTBIN,
161 MM_PLAYER_SIGNAL_TYPE_OTHERS,
162 MM_PLAYER_SIGNAL_TYPE_ALL,
163 MM_PLAYER_SIGNAL_TYPE_MAX = MM_PLAYER_SIGNAL_TYPE_ALL,
164 } MMPlayerSignalType;
166 /* main pipeline's element id */
168 MMPLAYER_M_PIPE = 0, /* NOTE : MMPLAYER_M_PIPE should be zero */
170 MMPLAYER_M_2ND_SRC, /* 2nd Source Element for es buff src */
173 /* it could be a decodebin or could be a typefind. depends on player ini */
177 MMPLAYER_M_AUTOPLUG_V_DEC,
178 MMPLAYER_M_AUTOPLUG_A_DEC,
180 /* NOTE : we need two fakesink to autoplug without decodebin.
181 * first one will hold whole pipeline state. and second one will hold state of
182 * a sink-decodebin for an elementary stream. no metter if there's more then one
183 * elementary streams because MSL reuse it.
185 MMPLAYER_M_SRC_FAKESINK,
186 MMPLAYER_M_SRC_2ND_FAKESINK,
188 /* streaming plugin */
189 MMPLAYER_M_MUXED_S_BUFFER,
190 MMPLAYER_M_DEMUXED_S_BUFFER,
192 MMPLAYER_M_ADAPTIVE_DEMUX,
194 /* es buff src queue */
199 /* FIXIT : if there's really no usage for following IDs. remove it */
207 MMPLAYER_M_V_INPUT_SELECTOR, // video input_select
208 MMPLAYER_M_A_INPUT_SELECTOR, // audio input_select
209 MMPLAYER_M_T_INPUT_SELECTOR, // text input_select
215 MMPLAYER_M_A_DEINTERLEAVE,
216 MMPLAYER_M_A_SELECTOR,
222 /* audio pipeline's element id */
223 enum AudioElementID {
224 MMPLAYER_A_BIN = 0, /* NOTE : MMPLAYER_A_BIN should be zero */
229 MMPLAYER_A_FILTER_SEC,
230 MMPLAYER_A_CAPS_DEFAULT,
231 MMPLAYER_A_CONV_BFORMAT,
234 MMPLAYER_A_RESAMPLER,
235 MMPLAYER_A_DEINTERLEAVE,
239 /* video pipeline's element id */
240 enum VideoElementID {
241 MMPLAYER_V_BIN = 0, /* NOTE : MMPLAYER_V_BIN should be zero */
251 /* text pipeline's element id */
253 MMPLAYER_T_BIN = 0, /* NOTE : MMPLAYER_V_BIN should be zero */
255 MMPLAYER_T_VIDEO_QUEUE,
256 MMPLAYER_T_VIDEO_CONVERTER,
258 MMPLAYER_T_FAKE_SINK,
263 /* midi main pipeline's element id */
266 MMPLAYER_MIDI_PLAYER,
270 enum PlayerCommandState {
271 MMPLAYER_COMMAND_NONE,
272 MMPLAYER_COMMAND_CREATE,
273 MMPLAYER_COMMAND_DESTROY,
274 MMPLAYER_COMMAND_UNREALIZE,
275 MMPLAYER_COMMAND_START,
276 MMPLAYER_COMMAND_REALIZE,
277 MMPLAYER_COMMAND_STOP,
278 MMPLAYER_COMMAND_PAUSE,
279 MMPLAYER_COMMAND_RESUME,
283 /* Note : StreamingSrcError is error enum for streaming source which post error message
284 * using custom message made by itself. The enum value must start with zero,
285 * because the streaming source(secrtspsrc) also does.
287 enum StreamingSrcError {
288 MMPLAYER_STREAMING_ERROR_NONE = 0,
289 MMPLAYER_STREAMING_ERROR_UNSUPPORTED_AUDIO,
290 MMPLAYER_STREAMING_ERROR_UNSUPPORTED_VIDEO,
291 MMPLAYER_STREAMING_ERROR_CONNECTION_FAIL,
292 MMPLAYER_STREAMING_ERROR_DNS_FAIL,
293 MMPLAYER_STREAMING_ERROR_SERVER_DISCONNECTED,
294 MMPLAYER_STREAMING_ERROR_BAD_SERVER,
295 MMPLAYER_STREAMING_ERROR_INVALID_PROTOCOL,
296 MMPLAYER_STREAMING_ERROR_INVALID_URL,
297 MMPLAYER_STREAMING_ERROR_UNEXPECTED_MSG,
298 MMPLAYER_STREAMING_ERROR_OUT_OF_MEMORIES,
299 MMPLAYER_STREAMING_ERROR_RTSP_TIMEOUT,
300 MMPLAYER_STREAMING_ERROR_BAD_REQUEST,
301 MMPLAYER_STREAMING_ERROR_NOT_AUTHORIZED,
302 MMPLAYER_STREAMING_ERROR_PAYMENT_REQUIRED,
303 MMPLAYER_STREAMING_ERROR_FORBIDDEN,
304 MMPLAYER_STREAMING_ERROR_CONTENT_NOT_FOUND,
305 MMPLAYER_STREAMING_ERROR_METHOD_NOT_ALLOWED,
306 MMPLAYER_STREAMING_ERROR_NOT_ACCEPTABLE,
307 MMPLAYER_STREAMING_ERROR_PROXY_AUTHENTICATION_REQUIRED,
308 MMPLAYER_STREAMING_ERROR_SERVER_TIMEOUT,
309 MMPLAYER_STREAMING_ERROR_GONE,
310 MMPLAYER_STREAMING_ERROR_LENGTH_REQUIRED,
311 MMPLAYER_STREAMING_ERROR_PRECONDITION_FAILED,
312 MMPLAYER_STREAMING_ERROR_REQUEST_ENTITY_TOO_LARGE,
313 MMPLAYER_STREAMING_ERROR_REQUEST_URI_TOO_LARGE,
314 MMPLAYER_STREAMING_ERROR_UNSUPPORTED_MEDIA_TYPE,
315 MMPLAYER_STREAMING_ERROR_PARAMETER_NOT_UNDERSTOOD,
316 MMPLAYER_STREAMING_ERROR_CONFERENCE_NOT_FOUND,
317 MMPLAYER_STREAMING_ERROR_NOT_ENOUGH_BANDWIDTH,
318 MMPLAYER_STREAMING_ERROR_NO_SESSION_ID,
319 MMPLAYER_STREAMING_ERROR_METHOD_NOT_VALID_IN_THIS_STATE,
320 MMPLAYER_STREAMING_ERROR_HEADER_FIELD_NOT_VALID_FOR_SOURCE,
321 MMPLAYER_STREAMING_ERROR_INVALID_RANGE,
322 MMPLAYER_STREAMING_ERROR_PARAMETER_IS_READONLY,
323 MMPLAYER_STREAMING_ERROR_AGGREGATE_OP_NOT_ALLOWED,
324 MMPLAYER_STREAMING_ERROR_ONLY_AGGREGATE_OP_ALLOWED,
325 MMPLAYER_STREAMING_ERROR_BAD_TRANSPORT,
326 MMPLAYER_STREAMING_ERROR_DESTINATION_UNREACHABLE,
327 MMPLAYER_STREAMING_ERROR_INTERNAL_SERVER_ERROR,
328 MMPLAYER_STREAMING_ERROR_NOT_IMPLEMENTED,
329 MMPLAYER_STREAMING_ERROR_BAD_GATEWAY,
330 MMPLAYER_STREAMING_ERROR_SERVICE_UNAVAILABLE,
331 MMPLAYER_STREAMING_ERROR_GATEWAY_TIME_OUT ,
332 MMPLAYER_STREAMING_ERROR_RTSP_VERSION_NOT_SUPPORTED,
333 MMPLAYER_STREAMING_ERROR_OPTION_NOT_SUPPORTED,
337 MMPLAYER_PATH_VOD = 0,
342 /* Video360 related enums. These are duplication from video360.h from
346 VIDEO360_MODE_UNKNOWN = -1,
347 VIDEO360_MODE_MONOSCOPIC = 0,
348 VIDEO360_MODE_STEREOSCOPIC_TOP_BOTTOM = 1,
349 VIDEO360_MODE_STEREOSCOPIC_LEFT_RIGHT = 2,
350 VIDEO360_MODE_STEREOSCOPIC_STEREO_MESH = 3,
351 VIDEO360_MODE_LAST_ITEM
352 } mm_player_stereo_mode_e;
355 VIDEO360_PROJECTION_TYPE_UNKNOWN = -1,
356 VIDEO360_PROJECTION_TYPE_EQUIRECTANGULAR = 0,
357 VIDEO360_PROJECTION_TYPE_CUBEMAP = 1,
358 VIDEO360_PROJECTION_TYPE_MESH = 2,
359 VIDEO360_PROJECTION_TYPE_LAST_ITEM
360 } mm_player_projection_type_e;
362 /* Spatial audio related enums. These are duplication from mm_file.h from
366 MMFILE_AMBISONIC_TYPE_UNKNOWN = 0,
367 MMFILE_AMBISONIC_TYPE_PERIPHONIC = 1, /**< To comply with Google's Spatial Audio RFC*/
368 MMFILE_AMBISONIC_TYPE_NON_PERIPHONIC = 2,
369 } MMFILE_AMBISONIC_TYPE;
372 MMFILE_AMBISONIC_FORMAT_UNKNOWN = 0,
373 MMFILE_AMBISONIC_FORMAT_AMBIX = 1, /**< AMBIX (Channel sequence: ACN, Normalization: SN3D) */
374 MMFILE_AMBISONIC_FORMAT_AMB = 2, /**< .AMB, Tetraproc (Channel sequence: FuMa, Normalization: FuMa) */
375 MMFILE_AMBISONIC_FORMAT_UA = 3, /**< Universal Ambisonics (Channel sequence: SID, Normalization: N3D) */
376 } MMFILE_AMBISONIC_FORMAT;
379 MMFILE_AMBISONIC_ORDER_UNKNOWN = 0,
380 MMFILE_AMBISONIC_ORDER_FOA = 1, /**< First order Ambisonics */
381 MMFILE_AMBISONIC_ORDER_SOA = 2, /**< Second order Ambisonics */
382 MMFILE_AMBISONIC_ORDER_TOA = 3, /**< Third order Ambisonics */
383 } MMFILE_AMBISONIC_ORDER;
385 /*---------------------------------------------------------------------------
386 | GLOBAL DATA TYPE DEFINITIONS: |
387 ---------------------------------------------------------------------------*/
392 } MMPlayerGstElement;
395 GstTagList *tag_list;
396 MMPlayerGstElement *mainbin;
397 MMPlayerGstElement *audiobin;
398 MMPlayerGstElement *videobin;
399 MMPlayerGstElement *textbin;
400 } MMPlayerGstPipelineInfo;
405 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 gboolean is_subtitle_off;
761 gboolean is_external_subtitle_present;
762 gboolean is_external_subtitle_added_now;
763 gboolean pending_resume;
765 /* contents bitrate for buffering management */
766 guint bitrate[MM_PLAYER_STREAM_COUNT_MAX];
768 guint maximum_bitrate[MM_PLAYER_STREAM_COUNT_MAX];
769 guint total_maximum_bitrate;
771 /* prevent it from posting duplicatly*/
774 gboolean play_subtitle;
775 gboolean is_subtitle_force_drop; // set TRUE after bus_cb get EOS
777 /* PD downloader message callback and param */
778 MMMessageCallback pd_msg_cb;
779 void* pd_msg_cb_param;
781 /* adjust subtitle position store */
782 gint64 adjust_subtitle_pos;
783 GList *subtitle_language_list;
784 GCond subtitle_info_cond;
785 GMutex subtitle_info_mutex;
787 /* To store the current multiwindow status */
788 gboolean last_multiwin_status;
790 /* To store the current running audio pad index of demuxer */
791 gint demux_pad_index;
793 mm_player_selector_t selector[MM_PLAYER_TRACK_TYPE_MAX];
794 mm_player_selector_t audio_mode;
795 gboolean use_deinterleave;
796 guint max_audio_channels;
798 guint internal_text_idx;
799 guint external_text_idx;
801 MMPlayerSetMode set_mode;
803 /* initialize values */
806 /* video share sync */
807 gint64 video_share_api_delta;
808 gint64 video_share_clock_delta;
810 /* just for native app (video hub) */
811 gboolean video_hub_download_mode;
812 gboolean sync_handler;
814 /* store dump pad list */
817 /* whether a video has closed caption or not */
818 gboolean has_closed_caption;
820 GstElement *video_fakesink;
822 /* audio stream caps parsed by demuxer or set by external demuxer */
823 GstCaps* a_stream_caps;
825 /* subtitle stream caps parsed by demuxer or set by external demuxer */
826 GstCaps* s_stream_caps;
828 /* es player using feed-data callback or calling app_src_push_buffer directly*/
829 gboolean es_player_push_mode;
831 /* tmb buffer manager for s/w codec tmb_bo */
837 MMAdaptiveVariantInfo adaptive_info;
839 /* Video360 related stuff
841 gboolean is_content_spherical;
842 mm_player_spherical_metadata_t video360_metadata;
843 gboolean is_openal_plugin_used;
844 /* User settable values */
845 gboolean is_video360_enabled;
846 float video360_yaw_radians;
847 float video360_pitch_radians;
849 int video360_horizontal_fov;
850 int video360_vertical_fov;
855 gchar *language_code;
858 } MMPlayerLangStruct;
862 gulong probe_handle_id;
863 FILE *dump_element_file;
871 int valid_type; // validity type
872 int value_min; //<- set validity value range
876 /*===========================================================================================
878 | GLOBAL FUNCTION PROTOTYPES |
880 ========================================================================================== */
885 int _mmplayer_create_player(MMHandleType hplayer);
886 int _mmplayer_destroy(MMHandleType hplayer);
887 int _mmplayer_realize(MMHandleType hplayer);
888 int _mmplayer_unrealize(MMHandleType hplayer);
889 int _mmplayer_get_state(MMHandleType hplayer, int* pstate);
890 int _mmplayer_set_volume(MMHandleType hplayer, MMPlayerVolumeType volume);
891 int _mmplayer_get_volume(MMHandleType hplayer, MMPlayerVolumeType *volume);
892 int _mmplayer_set_mute(MMHandleType hplayer, int mute);
893 int _mmplayer_get_mute(MMHandleType hplayer, int* pmute);
894 int _mmplayer_start(MMHandleType hplayer);
895 int _mmplayer_stop(MMHandleType hplayer);
896 int _mmplayer_pause(MMHandleType hplayer);
897 int _mmplayer_resume(MMHandleType hplayer);
898 int _mmplayer_set_position(MMHandleType hplayer, int format, int pos);
899 int _mmplayer_get_position(MMHandleType hplayer, int format, unsigned long *pos);
900 int _mmplayer_adjust_subtitle_postion(MMHandleType hplayer, int format, int pos);
901 int _mmplayer_adjust_video_postion(MMHandleType hplayer, int offset);
902 int _mmplayer_activate_section_repeat(MMHandleType hplayer, unsigned long start, unsigned long end);
903 int _mmplayer_deactivate_section_repeat(MMHandleType hplayer);
904 int _mmplayer_set_playspeed(MMHandleType hplayer, float rate, bool streaming);
905 int _mmplayer_set_message_callback(MMHandleType hplayer, MMMessageCallback callback, void *user_param);
906 int _mmplayer_set_videostream_changed_cb(MMHandleType hplayer, mm_player_stream_changed_callback callback, void *user_param);
907 int _mmplayer_set_audiostream_changed_cb(MMHandleType hplayer, mm_player_stream_changed_callback callback, void *user_param);
908 int _mmplayer_set_videostream_cb(MMHandleType hplayer, mm_player_video_stream_callback callback, void *user_param);
909 int _mmplayer_set_audiostream_cb(MMHandleType hplayer, mm_player_audio_stream_callback callback, void *user_param);
910 int _mmplayer_set_subtitle_silent(MMHandleType hplayer, int silent);
911 int _mmplayer_get_subtitle_silent(MMHandleType hplayer, int* silent);
912 int _mmplayer_set_external_subtitle_path(MMHandleType hplayer, const char* filepath);
913 int _mmplayer_get_buffer_position(MMHandleType hplayer, int format, unsigned long* start_pos, unsigned long* stop_pos);
915 /* test API for tuning audio gain. this API should be
916 * deprecated before the day of final release
918 int _mmplayer_set_volume_tune(MMHandleType hplayer, MMPlayerVolumeType volume);
919 int _mmplayer_update_video_param(mm_player_t* player, char *param_name);
920 int _mmplayer_set_audiobuffer_cb(MMHandleType hplayer, mm_player_audio_stream_callback callback, void *user_param);
921 int _mmplayer_change_videosink(MMHandleType handle, MMDisplaySurfaceType surface_type, void *display_overlay);
922 int _mmplayer_audio_effect_custom_apply(mm_player_t *player);
924 int _mmplayer_set_audiostream_cb_ex(MMHandleType hplayer, bool sync, mm_player_audio_stream_callback_ex callback, void *user_param);
925 gboolean __mmplayer_post_message(mm_player_t* player, enum MMMessageType msgtype, MMMessageParamType* param);
927 int _mmplayer_change_track_language(MMHandleType hplayer, MMPlayerTrackType type, int index);
928 int _mmplayer_sync_subtitle_pipeline(mm_player_t* player);
929 int _mmplayer_set_video_hub_download_mode(MMHandleType hplayer, bool mode);
930 int _mmplayer_use_system_clock(MMHandleType hplayer);
931 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);
932 int _mmplayer_get_video_share_master_clock(MMHandleType hplayer, long long *video_time, long long *media_clock, long long *audio_time);
933 int _mmplayer_enable_sync_handler(MMHandleType hplayer, bool enable);
934 int _mmplayer_set_file_buffering_path(MMHandleType hplayer, const char* file_path);
935 int _mmplayer_set_uri(MMHandleType hplayer, const char* uri);
936 int _mmplayer_set_next_uri(MMHandleType hplayer, const char* uri, bool is_first_path);
937 int _mmplayer_get_next_uri(MMHandleType hplayer, char** uri);
938 int _mmplayer_has_closed_caption(MMHandleType hplayer, bool* exist);
939 void _mm_player_video_stream_internal_buffer_unref(void *buffer);
940 int _mmplayer_set_pcm_spec(MMHandleType hplayer, int samplerate, int channel);
941 int _mmplayer_get_timeout(MMHandleType hplayer, int *timeout);
942 int _mmplayer_get_num_of_video_out_buffers(MMHandleType hplayer, int *num, int *extra_num);
943 int _mmplayer_manage_external_storage_state(MMHandleType hplayer, int id, int state);
944 int __mmplayer_gst_set_state(mm_player_t* player, GstElement * pipeline, GstState state, gboolean async, gint timeout);
945 int __mmplayer_set_state(mm_player_t* player, int state);
946 int __mmplayer_check_state(mm_player_t* player, enum PlayerCommandState command);
947 gboolean __mmplayer_dump_pipeline_state(mm_player_t* player);
948 void __mmplayer_remove_g_source_from_context(GMainContext *context, guint source_id);
949 void _mmplayer_bus_msg_thread_destroy(MMHandleType hplayer);
952 const gchar * __get_state_name(int state);
953 gboolean __mmplayer_can_do_interrupt(mm_player_t *player);
954 gboolean __is_streaming(mm_player_t* player);
955 gboolean __is_rtsp_streaming(mm_player_t* player);
956 gboolean __is_live_streaming(mm_player_t* player);
957 gboolean __is_http_streaming(mm_player_t* player);
958 gboolean __is_http_live_streaming(mm_player_t* player);
959 gboolean __is_dash_streaming(mm_player_t* player);
960 gboolean __is_smooth_streaming(mm_player_t* player);
961 gboolean __is_http_progressive_down(mm_player_t* player);
963 gboolean __mmplayer_check_useful_message(mm_player_t *player, GstMessage * message);
964 gboolean __mmplayer_handle_gst_error(mm_player_t* player, GstMessage * message, GError* error);
965 gint __gst_handle_core_error(mm_player_t* player, int code);
966 gint __gst_handle_library_error(mm_player_t* player, int code);
967 gint __gst_handle_resource_error(mm_player_t* player, int code, GstMessage * message);
968 gint __gst_handle_stream_error(mm_player_t* player, GError* error, GstMessage * message);
969 int __mmplayer_get_video_angle(mm_player_t* player, int *user_angle, int *org_angle);
970 int _mmplayer_video_stream_release_bo(mm_player_t* player, void* bo);
971 int _mmplayer_get_adaptive_variant_info(MMHandleType hplayer, int *num, char **var_info);
972 int _mmplayer_set_max_adaptive_variant_limit(MMHandleType hplayer, int bandwidth, int width, int height);
973 int _mmplayer_get_max_adaptive_variant_limit(MMHandleType hplayer, int *bandwidth, int *width, int *height);
974 int _mmplayer_set_audio_only(MMHandleType hplayer, bool audio_only);
975 int _mmplayer_get_audio_only(MMHandleType hplayer, bool *paudio_only);
976 int _mmplayer_set_streaming_buffering_time(MMHandleType hplayer, int buffer_ms, int rebuffer_ms);
977 int _mmplayer_get_streaming_buffering_time(MMHandleType hplayer, int *buffer_ms, int *rebuffer_ms);
978 int _mmplayer_set_codec_type(MMHandleType hplayer, MMPlayerStreamType stream_type, MMPlayerVideoCodecType codec_type);
984 #endif /* __MM_PLAYER_PRIV_H__ */