gst/rtsp-server/rtsp-media.c

   1 /* GStreamer
   2  * Copyright (C) 2008 Wim Taymans <wim.taymans at gmail.com>
   3  *
   4  * This library is free software; you can redistribute it and/or
   5  * modify it under the terms of the GNU Library General Public
   6  * License as published by the Free Software Foundation; either
   7  * version 2 of the License, or (at your option) any later version.
   8  *
   9  * This library is distributed in the hope that it will be useful,
  10  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  11  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
  12  * Library General Public License for more details.
  13  *
  14  * You should have received a copy of the GNU Library General Public
  15  * License along with this library; if not, write to the
  16  * Free Software Foundation, Inc., 51 Franklin St, Fifth Floor,
  17  * Boston, MA 02110-1301, USA.
  18  */
  19
  20 #include <string.h>
  21 #include <stdlib.h>
  22
  23 #include <gst/app/gstappsrc.h>
  24 #include <gst/app/gstappsink.h>
  25
  26 #include "rtsp-media.h"
  27
  28 #define GST_RTSP_MEDIA_GET_PRIVATE(obj)  \
  29      (G_TYPE_INSTANCE_GET_PRIVATE ((obj), GST_TYPE_RTSP_MEDIA, GstRTSPMediaPrivate))
  30
  31 struct _GstRTSPMediaPrivate
  32 {
  33   GMutex lock;
  34   GCond cond;
  35
  36   /* protected by lock */
  37   gboolean shared;
  38   gboolean reusable;
  39   GstRTSPLowerTrans protocols;
  40   gboolean reused;
  41   gboolean eos_shutdown;
  42   guint buffer_size;
  43   GstRTSPAuth *auth;
  44   GstRTSPAddressPool *pool;
  45
  46   GstElement *element;
  47   GRecMutex state_lock;         /* locking order: state lock, lock */
  48   GPtrArray *streams;           /* protected by lock */
  49   GList *dynamic;               /* protected by lock */
  50   GstRTSPMediaStatus status;    /* protected by lock */
  51   gint prepare_count;
  52   gint n_active;
  53   gboolean adding;
  54
  55   /* the pipeline for the media */
  56   GstElement *pipeline;
  57   GstElement *fakesink;         /* protected by lock */
  58   GSource *source;
  59   guint id;
  60
  61   gboolean time_provider;
  62   GstNetTimeProvider *nettime;
  63
  64   gboolean is_live;
  65   gboolean seekable;
  66   gboolean buffering;
  67   GstState target_state;
  68
  69   /* RTP session manager */
  70   GstElement *rtpbin;
  71
  72   /* the range of media */
  73   GstRTSPTimeRange range;       /* protected by lock */
  74   GstClockTime range_start;
  75   GstClockTime range_stop;
  76 };
  77
  78 #define DEFAULT_SHARED          FALSE
  79 #define DEFAULT_REUSABLE        FALSE
  80 #define DEFAULT_PROTOCOLS       GST_RTSP_LOWER_TRANS_UDP | GST_RTSP_LOWER_TRANS_TCP
  81 //#define DEFAULT_PROTOCOLS      GST_RTSP_LOWER_TRANS_UDP_MCAST
  82 #define DEFAULT_EOS_SHUTDOWN    FALSE
  83 #define DEFAULT_BUFFER_SIZE     0x80000
  84 #define DEFAULT_TIME_PROVIDER   FALSE
  85
  86 /* define to dump received RTCP packets */
  87 #undef DUMP_STATS
  88
  89 enum
  90 {
  91   PROP_0,
  92   PROP_SHARED,
  93   PROP_REUSABLE,
  94   PROP_PROTOCOLS,
  95   PROP_EOS_SHUTDOWN,
  96   PROP_BUFFER_SIZE,
  97   PROP_ELEMENT,
  98   PROP_TIME_PROVIDER,
  99   PROP_LAST
 100 };
 101
 102 enum
 103 {
 104   SIGNAL_NEW_STREAM,
 105   SIGNAL_REMOVED_STREAM,
 106   SIGNAL_PREPARED,
 107   SIGNAL_UNPREPARED,
 108   SIGNAL_NEW_STATE,
 109   SIGNAL_LAST
 110 };
 111
 112 GST_DEBUG_CATEGORY_STATIC (rtsp_media_debug);
 113 #define GST_CAT_DEFAULT rtsp_media_debug
 114
 115 static void gst_rtsp_media_get_property (GObject * object, guint propid,
 116     GValue * value, GParamSpec * pspec);
 117 static void gst_rtsp_media_set_property (GObject * object, guint propid,
 118     const GValue * value, GParamSpec * pspec);
 119 static void gst_rtsp_media_finalize (GObject * obj);
 120
 121 static gpointer do_loop (GstRTSPMediaClass * klass);
 122 static gboolean default_handle_message (GstRTSPMedia * media,
 123     GstMessage * message);
 124 static void finish_unprepare (GstRTSPMedia * media);
 125 static gboolean default_unprepare (GstRTSPMedia * media);
 126 static gboolean
 127 default_convert_range (GstRTSPMedia * media, GstRTSPTimeRange * range,
 128     GstRTSPRangeUnit unit);
 129
 130 static guint gst_rtsp_media_signals[SIGNAL_LAST] = { 0 };
 131
 132 G_DEFINE_TYPE (GstRTSPMedia, gst_rtsp_media, G_TYPE_OBJECT);
 133
 134 static void
 135 gst_rtsp_media_class_init (GstRTSPMediaClass * klass)
 136 {
 137   GObjectClass *gobject_class;
 138
 139   g_type_class_add_private (klass, sizeof (GstRTSPMediaPrivate));
 140
 141   gobject_class = G_OBJECT_CLASS (klass);
 142
 143   gobject_class->get_property = gst_rtsp_media_get_property;
 144   gobject_class->set_property = gst_rtsp_media_set_property;
 145   gobject_class->finalize = gst_rtsp_media_finalize;
 146
 147   g_object_class_install_property (gobject_class, PROP_SHARED,
 148       g_param_spec_boolean ("shared", "Shared",
 149           "If this media pipeline can be shared", DEFAULT_SHARED,
 150           G_PARAM_READWRITE | G_PARAM_STATIC_STRINGS));
 151
 152   g_object_class_install_property (gobject_class, PROP_REUSABLE,
 153       g_param_spec_boolean ("reusable", "Reusable",
 154           "If this media pipeline can be reused after an unprepare",
 155           DEFAULT_REUSABLE, G_PARAM_READWRITE | G_PARAM_STATIC_STRINGS));
 156
 157   g_object_class_install_property (gobject_class, PROP_PROTOCOLS,
 158       g_param_spec_flags ("protocols", "Protocols",
 159           "Allowed lower transport protocols", GST_TYPE_RTSP_LOWER_TRANS,
 160           DEFAULT_PROTOCOLS, G_PARAM_READWRITE | G_PARAM_STATIC_STRINGS));
 161
 162   g_object_class_install_property (gobject_class, PROP_EOS_SHUTDOWN,
 163       g_param_spec_boolean ("eos-shutdown", "EOS Shutdown",
 164           "Send an EOS event to the pipeline before unpreparing",
 165           DEFAULT_EOS_SHUTDOWN, G_PARAM_READWRITE | G_PARAM_STATIC_STRINGS));
 166
 167   g_object_class_install_property (gobject_class, PROP_BUFFER_SIZE,
 168       g_param_spec_uint ("buffer-size", "Buffer Size",
 169           "The kernel UDP buffer size to use", 0, G_MAXUINT,
 170           DEFAULT_BUFFER_SIZE, G_PARAM_READWRITE | G_PARAM_STATIC_STRINGS));
 171
 172   g_object_class_install_property (gobject_class, PROP_ELEMENT,
 173       g_param_spec_object ("element", "The Element",
 174           "The GstBin to use for streaming the media", GST_TYPE_ELEMENT,
 175           G_PARAM_CONSTRUCT_ONLY | G_PARAM_READWRITE));
 176
 177   g_object_class_install_property (gobject_class, PROP_EOS_SHUTDOWN,
 178       g_param_spec_boolean ("time-provider", "Time Provider",
 179           "Use a NetTimeProvider for clients",
 180           DEFAULT_TIME_PROVIDER, G_PARAM_READWRITE | G_PARAM_STATIC_STRINGS));
 181
 182   gst_rtsp_media_signals[SIGNAL_NEW_STREAM] =
 183       g_signal_new ("new-stream", G_TYPE_FROM_CLASS (klass), G_SIGNAL_RUN_LAST,
 184       G_STRUCT_OFFSET (GstRTSPMediaClass, new_stream), NULL, NULL,
 185       g_cclosure_marshal_generic, G_TYPE_NONE, 1, GST_TYPE_RTSP_STREAM);
 186
 187   gst_rtsp_media_signals[SIGNAL_REMOVED_STREAM] =
 188       g_signal_new ("removed-stream", G_TYPE_FROM_CLASS (klass),
 189       G_SIGNAL_RUN_LAST, G_STRUCT_OFFSET (GstRTSPMediaClass, removed_stream),
 190       NULL, NULL, g_cclosure_marshal_generic, G_TYPE_NONE, 1,
 191       GST_TYPE_RTSP_STREAM);
 192
 193   gst_rtsp_media_signals[SIGNAL_PREPARED] =
 194       g_signal_new ("prepared", G_TYPE_FROM_CLASS (klass), G_SIGNAL_RUN_LAST,
 195       G_STRUCT_OFFSET (GstRTSPMediaClass, prepared), NULL, NULL,
 196       g_cclosure_marshal_VOID__VOID, G_TYPE_NONE, 0, G_TYPE_NONE);
 197
 198   gst_rtsp_media_signals[SIGNAL_UNPREPARED] =
 199       g_signal_new ("unprepared", G_TYPE_FROM_CLASS (klass), G_SIGNAL_RUN_LAST,
 200       G_STRUCT_OFFSET (GstRTSPMediaClass, unprepared), NULL, NULL,
 201       g_cclosure_marshal_VOID__VOID, G_TYPE_NONE, 0, G_TYPE_NONE);
 202
 203   gst_rtsp_media_signals[SIGNAL_NEW_STATE] =
 204       g_signal_new ("new-state", G_TYPE_FROM_CLASS (klass), G_SIGNAL_RUN_LAST,
 205       G_STRUCT_OFFSET (GstRTSPMediaClass, new_state), NULL, NULL,
 206       g_cclosure_marshal_VOID__INT, G_TYPE_NONE, 0, G_TYPE_INT);
 207
 208   klass->context = g_main_context_new ();
 209   klass->loop = g_main_loop_new (klass->context, TRUE);
 210
 211   GST_DEBUG_CATEGORY_INIT (rtsp_media_debug, "rtspmedia", 0, "GstRTSPMedia");
 212
 213   klass->thread = g_thread_new ("Bus Thread", (GThreadFunc) do_loop, klass);
 214
 215   klass->handle_message = default_handle_message;
 216   klass->unprepare = default_unprepare;
 217   klass->convert_range = default_convert_range;
 218 }
 219
 220 static void
 221 gst_rtsp_media_init (GstRTSPMedia * media)
 222 {
 223   GstRTSPMediaPrivate *priv = GST_RTSP_MEDIA_GET_PRIVATE (media);
 224
 225   media->priv = priv;
 226
 227   priv->streams = g_ptr_array_new_with_free_func (g_object_unref);
 228   g_mutex_init (&priv->lock);
 229   g_cond_init (&priv->cond);
 230   g_rec_mutex_init (&priv->state_lock);
 231
 232   priv->shared = DEFAULT_SHARED;
 233   priv->reusable = DEFAULT_REUSABLE;
 234   priv->protocols = DEFAULT_PROTOCOLS;
 235   priv->eos_shutdown = DEFAULT_EOS_SHUTDOWN;
 236   priv->buffer_size = DEFAULT_BUFFER_SIZE;
 237   priv->time_provider = DEFAULT_TIME_PROVIDER;
 238 }
 239
 240 static void
 241 gst_rtsp_media_finalize (GObject * obj)
 242 {
 243   GstRTSPMediaPrivate *priv;
 244   GstRTSPMedia *media;
 245
 246   media = GST_RTSP_MEDIA (obj);
 247   priv = media->priv;
 248
 249   GST_INFO ("finalize media %p", media);
 250
 251   g_ptr_array_unref (priv->streams);
 252
 253   g_list_free_full (priv->dynamic, gst_object_unref);
 254
 255   if (priv->pipeline)
 256     gst_object_unref (priv->pipeline);
 257   if (priv->nettime)
 258     gst_object_unref (priv->nettime);
 259   gst_object_unref (priv->element);
 260   if (priv->auth)
 261     g_object_unref (priv->auth);
 262   if (priv->pool)
 263     g_object_unref (priv->pool);
 264   g_mutex_clear (&priv->lock);
 265   g_cond_clear (&priv->cond);
 266   g_rec_mutex_clear (&priv->state_lock);
 267
 268   G_OBJECT_CLASS (gst_rtsp_media_parent_class)->finalize (obj);
 269 }
 270
 271 static void
 272 gst_rtsp_media_get_property (GObject * object, guint propid,
 273     GValue * value, GParamSpec * pspec)
 274 {
 275   GstRTSPMedia *media = GST_RTSP_MEDIA (object);
 276
 277   switch (propid) {
 278     case PROP_ELEMENT:
 279       g_value_set_object (value, media->priv->element);
 280       break;
 281     case PROP_SHARED:
 282       g_value_set_boolean (value, gst_rtsp_media_is_shared (media));
 283       break;
 284     case PROP_REUSABLE:
 285       g_value_set_boolean (value, gst_rtsp_media_is_reusable (media));
 286       break;
 287     case PROP_PROTOCOLS:
 288       g_value_set_flags (value, gst_rtsp_media_get_protocols (media));
 289       break;
 290     case PROP_EOS_SHUTDOWN:
 291       g_value_set_boolean (value, gst_rtsp_media_is_eos_shutdown (media));
 292       break;
 293     case PROP_BUFFER_SIZE:
 294       g_value_set_uint (value, gst_rtsp_media_get_buffer_size (media));
 295       break;
 296     case PROP_TIME_PROVIDER:
 297       g_value_set_boolean (value, gst_rtsp_media_is_time_provider (media));
 298       break;
 299     default:
 300       G_OBJECT_WARN_INVALID_PROPERTY_ID (object, propid, pspec);
 301   }
 302 }
 303
 304 static void
 305 gst_rtsp_media_set_property (GObject * object, guint propid,
 306     const GValue * value, GParamSpec * pspec)
 307 {
 308   GstRTSPMedia *media = GST_RTSP_MEDIA (object);
 309
 310   switch (propid) {
 311     case PROP_ELEMENT:
 312       media->priv->element = g_value_get_object (value);
 313       gst_object_ref_sink (media->priv->element);
 314       break;
 315     case PROP_SHARED:
 316       gst_rtsp_media_set_shared (media, g_value_get_boolean (value));
 317       break;
 318     case PROP_REUSABLE:
 319       gst_rtsp_media_set_reusable (media, g_value_get_boolean (value));
 320       break;
 321     case PROP_PROTOCOLS:
 322       gst_rtsp_media_set_protocols (media, g_value_get_flags (value));
 323       break;
 324     case PROP_EOS_SHUTDOWN:
 325       gst_rtsp_media_set_eos_shutdown (media, g_value_get_boolean (value));
 326       break;
 327     case PROP_BUFFER_SIZE:
 328       gst_rtsp_media_set_buffer_size (media, g_value_get_uint (value));
 329       break;
 330     case PROP_TIME_PROVIDER:
 331       gst_rtsp_media_use_time_provider (media, g_value_get_boolean (value));
 332       break;
 333     default:
 334       G_OBJECT_WARN_INVALID_PROPERTY_ID (object, propid, pspec);
 335   }
 336 }
 337
 338 static gpointer
 339 do_loop (GstRTSPMediaClass * klass)
 340 {
 341   GST_INFO ("enter mainloop");
 342   g_main_loop_run (klass->loop);
 343   GST_INFO ("exit mainloop");
 344
 345   return NULL;
 346 }
 347
 348 /* must be called with state lock */
 349 static void
 350 collect_media_stats (GstRTSPMedia * media)
 351 {
 352   GstRTSPMediaPrivate *priv = media->priv;
 353   gint64 position, duration;
 354
 355   if (priv->status != GST_RTSP_MEDIA_STATUS_PREPARED &&
 356       priv->status != GST_RTSP_MEDIA_STATUS_PREPARING)
 357     return;
 358
 359   priv->range.unit = GST_RTSP_RANGE_NPT;
 360
 361   GST_INFO ("collect media stats");
 362
 363   if (priv->is_live) {
 364     priv->range.min.type = GST_RTSP_TIME_NOW;
 365     priv->range.min.seconds = -1;
 366     priv->range_start = -1;
 367     priv->range.max.type = GST_RTSP_TIME_END;
 368     priv->range.max.seconds = -1;
 369     priv->range_stop = -1;
 370   } else {
 371     /* get the position */
 372     if (!gst_element_query_position (priv->pipeline, GST_FORMAT_TIME,
 373             &position)) {
 374       GST_INFO ("position query failed");
 375       position = 0;
 376     }
 377
 378     /* get the duration */
 379     if (!gst_element_query_duration (priv->pipeline, GST_FORMAT_TIME,
 380             &duration)) {
 381       GST_INFO ("duration query failed");
 382       duration = -1;
 383     }
 384
 385     GST_INFO ("stats: position %" GST_TIME_FORMAT ", duration %"
 386         GST_TIME_FORMAT, GST_TIME_ARGS (position), GST_TIME_ARGS (duration));
 387
 388     if (position == -1) {
 389       priv->range.min.type = GST_RTSP_TIME_NOW;
 390       priv->range.min.seconds = -1;
 391       priv->range_start = -1;
 392     } else {
 393       priv->range.min.type = GST_RTSP_TIME_SECONDS;
 394       priv->range.min.seconds = ((gdouble) position) / GST_SECOND;
 395       priv->range_start = position;
 396     }
 397     if (duration == -1) {
 398       priv->range.max.type = GST_RTSP_TIME_END;
 399       priv->range.max.seconds = -1;
 400       priv->range_stop = -1;
 401     } else {
 402       priv->range.max.type = GST_RTSP_TIME_SECONDS;
 403       priv->range.max.seconds = ((gdouble) duration) / GST_SECOND;
 404       priv->range_stop = duration;
 405     }
 406   }
 407 }
 408
 409 /**
 410  * gst_rtsp_media_new:
 411  * @element: (transfer full): a #GstElement
 412  *
 413  * Create a new #GstRTSPMedia instance. @element is the bin element that
 414  * provides the different streams. The #GstRTSPMedia object contains the
 415  * element to produce RTP data for one or more related (audio/video/..)
 416  * streams.
 417  *
 418  * Ownership is taken of @element.
 419  *
 420  * Returns: a new #GstRTSPMedia object.
 421  */
 422 GstRTSPMedia *
 423 gst_rtsp_media_new (GstElement * element)
 424 {
 425   GstRTSPMedia *result;
 426
 427   g_return_val_if_fail (GST_IS_ELEMENT (element), NULL);
 428
 429   result = g_object_new (GST_TYPE_RTSP_MEDIA, "element", element, NULL);
 430
 431   return result;
 432 }
 433
 434 /**
 435  * gst_rtsp_media_take_element:
 436  * @media: a #GstRTSPMedia
 437  * @pipeline: (transfer full): a #GstPipeline
 438  *
 439  * Set @pipeline as the #GstPipeline for @media. Ownership is
 440  * taken of @pipeline.
 441  */
 442 void
 443 gst_rtsp_media_take_pipeline (GstRTSPMedia * media, GstPipeline * pipeline)
 444 {
 445   GstRTSPMediaPrivate *priv;
 446   GstElement *old;
 447   GstNetTimeProvider *nettime;
 448
 449   g_return_if_fail (GST_IS_RTSP_MEDIA (media));
 450   g_return_if_fail (GST_IS_PIPELINE (pipeline));
 451
 452   priv = media->priv;
 453
 454   g_mutex_lock (&priv->lock);
 455   old = priv->pipeline;
 456   priv->pipeline = GST_ELEMENT_CAST (pipeline);
 457   nettime = priv->nettime;
 458   priv->nettime = NULL;
 459   g_mutex_unlock (&priv->lock);
 460
 461   if (old)
 462     gst_object_unref (old);
 463
 464   if (nettime)
 465     gst_object_unref (nettime);
 466
 467   gst_bin_add (GST_BIN_CAST (pipeline), priv->element);
 468 }
 469
 470 /**
 471  * gst_rtsp_media_set_shared:
 472  * @media: a #GstRTSPMedia
 473  * @shared: the new value
 474  *
 475  * Set or unset if the pipeline for @media can be shared will multiple clients.
 476  * When @shared is %TRUE, client requests for this media will share the media
 477  * pipeline.
 478  */
 479 void
 480 gst_rtsp_media_set_shared (GstRTSPMedia * media, gboolean shared)
 481 {
 482   GstRTSPMediaPrivate *priv;
 483
 484   g_return_if_fail (GST_IS_RTSP_MEDIA (media));
 485
 486   priv = media->priv;
 487
 488   g_mutex_lock (&priv->lock);
 489   priv->shared = shared;
 490   g_mutex_unlock (&priv->lock);
 491 }
 492
 493 /**
 494  * gst_rtsp_media_is_shared:
 495  * @media: a #GstRTSPMedia
 496  *
 497  * Check if the pipeline for @media can be shared between multiple clients.
 498  *
 499  * Returns: %TRUE if the media can be shared between clients.
 500  */
 501 gboolean
 502 gst_rtsp_media_is_shared (GstRTSPMedia * media)
 503 {
 504   GstRTSPMediaPrivate *priv;
 505   gboolean res;
 506
 507   g_return_val_if_fail (GST_IS_RTSP_MEDIA (media), FALSE);
 508
 509   priv = media->priv;
 510
 511   g_mutex_lock (&priv->lock);
 512   res = priv->shared;
 513   g_mutex_unlock (&priv->lock);
 514
 515   return res;
 516 }
 517
 518 /**
 519  * gst_rtsp_media_set_reusable:
 520  * @media: a #GstRTSPMedia
 521  * @reusable: the new value
 522  *
 523  * Set or unset if the pipeline for @media can be reused after the pipeline has
 524  * been unprepared.
 525  */
 526 void
 527 gst_rtsp_media_set_reusable (GstRTSPMedia * media, gboolean reusable)
 528 {
 529   GstRTSPMediaPrivate *priv;
 530
 531   g_return_if_fail (GST_IS_RTSP_MEDIA (media));
 532
 533   priv = media->priv;
 534
 535   g_mutex_lock (&priv->lock);
 536   priv->reusable = reusable;
 537   g_mutex_unlock (&priv->lock);
 538 }
 539
 540 /**
 541  * gst_rtsp_media_is_reusable:
 542  * @media: a #GstRTSPMedia
 543  *
 544  * Check if the pipeline for @media can be reused after an unprepare.
 545  *
 546  * Returns: %TRUE if the media can be reused
 547  */
 548 gboolean
 549 gst_rtsp_media_is_reusable (GstRTSPMedia * media)
 550 {
 551   GstRTSPMediaPrivate *priv;
 552   gboolean res;
 553
 554   g_return_val_if_fail (GST_IS_RTSP_MEDIA (media), FALSE);
 555
 556   priv = media->priv;
 557
 558   g_mutex_lock (&priv->lock);
 559   res = priv->reusable;
 560   g_mutex_unlock (&priv->lock);
 561
 562   return res;
 563 }
 564
 565 /**
 566  * gst_rtsp_media_set_protocols:
 567  * @media: a #GstRTSPMedia
 568  * @protocols: the new flags
 569  *
 570  * Configure the allowed lower transport for @media.
 571  */
 572 void
 573 gst_rtsp_media_set_protocols (GstRTSPMedia * media, GstRTSPLowerTrans protocols)
 574 {
 575   GstRTSPMediaPrivate *priv;
 576
 577   g_return_if_fail (GST_IS_RTSP_MEDIA (media));
 578
 579   priv = media->priv;
 580
 581   g_mutex_lock (&priv->lock);
 582   priv->protocols = protocols;
 583   g_mutex_unlock (&priv->lock);
 584 }
 585
 586 /**
 587  * gst_rtsp_media_get_protocols:
 588  * @media: a #GstRTSPMedia
 589  *
 590  * Get the allowed protocols of @media.
 591  *
 592  * Returns: a #GstRTSPLowerTrans
 593  */
 594 GstRTSPLowerTrans
 595 gst_rtsp_media_get_protocols (GstRTSPMedia * media)
 596 {
 597   GstRTSPMediaPrivate *priv;
 598   GstRTSPLowerTrans res;
 599
 600   g_return_val_if_fail (GST_IS_RTSP_MEDIA (media),
 601       GST_RTSP_LOWER_TRANS_UNKNOWN);
 602
 603   priv = media->priv;
 604
 605   g_mutex_lock (&priv->lock);
 606   res = priv->protocols;
 607   g_mutex_unlock (&priv->lock);
 608
 609   return res;
 610 }
 611
 612 /**
 613  * gst_rtsp_media_set_eos_shutdown:
 614  * @media: a #GstRTSPMedia
 615  * @eos_shutdown: the new value
 616  *
 617  * Set or unset if an EOS event will be sent to the pipeline for @media before
 618  * it is unprepared.
 619  */
 620 void
 621 gst_rtsp_media_set_eos_shutdown (GstRTSPMedia * media, gboolean eos_shutdown)
 622 {
 623   GstRTSPMediaPrivate *priv;
 624
 625   g_return_if_fail (GST_IS_RTSP_MEDIA (media));
 626
 627   priv = media->priv;
 628
 629   g_mutex_lock (&priv->lock);
 630   priv->eos_shutdown = eos_shutdown;
 631   g_mutex_unlock (&priv->lock);
 632 }
 633
 634 /**
 635  * gst_rtsp_media_is_eos_shutdown:
 636  * @media: a #GstRTSPMedia
 637  *
 638  * Check if the pipeline for @media will send an EOS down the pipeline before
 639  * unpreparing.
 640  *
 641  * Returns: %TRUE if the media will send EOS before unpreparing.
 642  */
 643 gboolean
 644 gst_rtsp_media_is_eos_shutdown (GstRTSPMedia * media)
 645 {
 646   GstRTSPMediaPrivate *priv;
 647   gboolean res;
 648
 649   g_return_val_if_fail (GST_IS_RTSP_MEDIA (media), FALSE);
 650
 651   priv = media->priv;
 652
 653   g_mutex_lock (&priv->lock);
 654   res = priv->eos_shutdown;
 655   g_mutex_unlock (&priv->lock);
 656
 657   return res;
 658 }
 659
 660 /**
 661  * gst_rtsp_media_set_buffer_size:
 662  * @media: a #GstRTSPMedia
 663  * @size: the new value
 664  *
 665  * Set the kernel UDP buffer size.
 666  */
 667 void
 668 gst_rtsp_media_set_buffer_size (GstRTSPMedia * media, guint size)
 669 {
 670   GstRTSPMediaPrivate *priv;
 671
 672   g_return_if_fail (GST_IS_RTSP_MEDIA (media));
 673
 674   GST_LOG_OBJECT (media, "set buffer size %u", size);
 675
 676   priv = media->priv;
 677
 678   g_mutex_lock (&priv->lock);
 679   priv->buffer_size = size;
 680   g_mutex_unlock (&priv->lock);
 681 }
 682
 683 /**
 684  * gst_rtsp_media_get_buffer_size:
 685  * @media: a #GstRTSPMedia
 686  *
 687  * Get the kernel UDP buffer size.
 688  *
 689  * Returns: the kernel UDP buffer size.
 690  */
 691 guint
 692 gst_rtsp_media_get_buffer_size (GstRTSPMedia * media)
 693 {
 694   GstRTSPMediaPrivate *priv;
 695   guint res;
 696
 697   g_return_val_if_fail (GST_IS_RTSP_MEDIA (media), FALSE);
 698
 699   priv = media->priv;
 700
 701   g_mutex_unlock (&priv->lock);
 702   res = priv->buffer_size;
 703   g_mutex_unlock (&priv->lock);
 704
 705   return res;
 706 }
 707
 708 /**
 709  * gst_rtsp_media_use_time_provider:
 710  * @media: a #GstRTSPMedia
 711  *
 712  * Set @media to provide a GstNetTimeProvider.
 713  */
 714 void
 715 gst_rtsp_media_use_time_provider (GstRTSPMedia * media, gboolean time_provider)
 716 {
 717   GstRTSPMediaPrivate *priv;
 718
 719   g_return_if_fail (GST_IS_RTSP_MEDIA (media));
 720
 721   priv = media->priv;
 722
 723   g_mutex_lock (&priv->lock);
 724   priv->time_provider = time_provider;
 725   g_mutex_unlock (&priv->lock);
 726 }
 727
 728 /**
 729  * gst_rtsp_media_is_time_provider:
 730  * @media: a #GstRTSPMedia
 731  *
 732  * Check if @media can provide a #GstNetTimeProvider for its pipeline clock.
 733  *
 734  * Use gst_rtsp_media_get_time_provider() to get the network clock.
 735  *
 736  * Returns: %TRUE if @media can provide a #GstNetTimeProvider.
 737  */
 738 gboolean
 739 gst_rtsp_media_is_time_provider (GstRTSPMedia * media)
 740 {
 741   GstRTSPMediaPrivate *priv;
 742   gboolean res;
 743
 744   g_return_val_if_fail (GST_IS_RTSP_MEDIA (media), FALSE);
 745
 746   priv = media->priv;
 747
 748   g_mutex_unlock (&priv->lock);
 749   res = priv->time_provider;
 750   g_mutex_unlock (&priv->lock);
 751
 752   return res;
 753 }
 754
 755 /**
 756  * gst_rtsp_media_set_auth:
 757  * @media: a #GstRTSPMedia
 758  * @auth: a #GstRTSPAuth
 759  *
 760  * configure @auth to be used as the authentication manager of @media.
 761  */
 762 void
 763 gst_rtsp_media_set_auth (GstRTSPMedia * media, GstRTSPAuth * auth)
 764 {
 765   GstRTSPMediaPrivate *priv;
 766   GstRTSPAuth *old;
 767
 768   g_return_if_fail (GST_IS_RTSP_MEDIA (media));
 769
 770   priv = media->priv;
 771
 772   GST_LOG_OBJECT (media, "set auth %p", auth);
 773
 774   g_mutex_lock (&priv->lock);
 775   if ((old = priv->auth) != auth)
 776     priv->auth = auth ? g_object_ref (auth) : NULL;
 777   else
 778     old = NULL;
 779   g_mutex_unlock (&priv->lock);
 780
 781   if (old)
 782     g_object_unref (old);
 783 }
 784
 785 /**
 786  * gst_rtsp_media_get_auth:
 787  * @media: a #GstRTSPMedia
 788  *
 789  * Get the #GstRTSPAuth used as the authentication manager of @media.
 790  *
 791  * Returns: (transfer full): the #GstRTSPAuth of @media. g_object_unref() after
 792  * usage.
 793  */
 794 GstRTSPAuth *
 795 gst_rtsp_media_get_auth (GstRTSPMedia * media)
 796 {
 797   GstRTSPMediaPrivate *priv;
 798   GstRTSPAuth *result;
 799
 800   g_return_val_if_fail (GST_IS_RTSP_MEDIA (media), NULL);
 801
 802   priv = media->priv;
 803
 804   g_mutex_lock (&priv->lock);
 805   if ((result = priv->auth))
 806     g_object_ref (result);
 807   g_mutex_unlock (&priv->lock);
 808
 809   return result;
 810 }
 811
 812 /**
 813  * gst_rtsp_media_set_address_pool:
 814  * @media: a #GstRTSPMedia
 815  * @pool: a #GstRTSPAddressPool
 816  *
 817  * configure @pool to be used as the address pool of @media.
 818  */
 819 void
 820 gst_rtsp_media_set_address_pool (GstRTSPMedia * media,
 821     GstRTSPAddressPool * pool)
 822 {
 823   GstRTSPMediaPrivate *priv;
 824   GstRTSPAddressPool *old;
 825
 826   g_return_if_fail (GST_IS_RTSP_MEDIA (media));
 827
 828   priv = media->priv;
 829
 830   GST_LOG_OBJECT (media, "set address pool %p", pool);
 831
 832   g_mutex_lock (&priv->lock);
 833   if ((old = priv->pool) != pool)
 834     priv->pool = pool ? g_object_ref (pool) : NULL;
 835   else
 836     old = NULL;
 837   g_ptr_array_foreach (priv->streams, (GFunc) gst_rtsp_stream_set_address_pool,
 838       pool);
 839   g_mutex_unlock (&priv->lock);
 840
 841   if (old)
 842     g_object_unref (old);
 843 }
 844
 845 /**
 846  * gst_rtsp_media_get_address_pool:
 847  * @media: a #GstRTSPMedia
 848  *
 849  * Get the #GstRTSPAddressPool used as the address pool of @media.
 850  *
 851  * Returns: (transfer full): the #GstRTSPAddressPool of @media. g_object_unref() after
 852  * usage.
 853  */
 854 GstRTSPAddressPool *
 855 gst_rtsp_media_get_address_pool (GstRTSPMedia * media)
 856 {
 857   GstRTSPMediaPrivate *priv;
 858   GstRTSPAddressPool *result;
 859
 860   g_return_val_if_fail (GST_IS_RTSP_MEDIA (media), NULL);
 861
 862   priv = media->priv;
 863
 864   g_mutex_lock (&priv->lock);
 865   if ((result = priv->pool))
 866     g_object_ref (result);
 867   g_mutex_unlock (&priv->lock);
 868
 869   return result;
 870 }
 871
 872 /**
 873  * gst_rtsp_media_collect_streams:
 874  * @media: a #GstRTSPMedia
 875  *
 876  * Find all payloader elements, they should be named pay%d in the
 877  * element of @media, and create #GstRTSPStreams for them.
 878  *
 879  * Collect all dynamic elements, named dynpay%d, and add them to
 880  * the list of dynamic elements.
 881  */
 882 void
 883 gst_rtsp_media_collect_streams (GstRTSPMedia * media)
 884 {
 885   GstRTSPMediaPrivate *priv;
 886   GstElement *element, *elem;
 887   GstPad *pad;
 888   gint i;
 889   gboolean have_elem;
 890
 891   g_return_if_fail (GST_IS_RTSP_MEDIA (media));
 892
 893   priv = media->priv;
 894   element = priv->element;
 895
 896   have_elem = TRUE;
 897   for (i = 0; have_elem; i++) {
 898     gchar *name;
 899
 900     have_elem = FALSE;
 901
 902     name = g_strdup_printf ("pay%d", i);
 903     if ((elem = gst_bin_get_by_name (GST_BIN (element), name))) {
 904       GST_INFO ("found stream %d with payloader %p", i, elem);
 905
 906       /* take the pad of the payloader */
 907       pad = gst_element_get_static_pad (elem, "src");
 908       /* create the stream */
 909       gst_rtsp_media_create_stream (media, elem, pad);
 910       gst_object_unref (pad);
 911       gst_object_unref (elem);
 912
 913       have_elem = TRUE;
 914     }
 915     g_free (name);
 916
 917     name = g_strdup_printf ("dynpay%d", i);
 918     if ((elem = gst_bin_get_by_name (GST_BIN (element), name))) {
 919       /* a stream that will dynamically create pads to provide RTP packets */
 920
 921       GST_INFO ("found dynamic element %d, %p", i, elem);
 922
 923       g_mutex_lock (&priv->lock);
 924       priv->dynamic = g_list_prepend (priv->dynamic, elem);
 925       g_mutex_unlock (&priv->lock);
 926
 927       have_elem = TRUE;
 928     }
 929     g_free (name);
 930   }
 931 }
 932
 933 /**
 934  * gst_rtsp_media_create_stream:
 935  * @media: a #GstRTSPMedia
 936  * @payloader: a #GstElement
 937  * @srcpad: a source #GstPad
 938  *
 939  * Create a new stream in @media that provides RTP data on @srcpad.
 940  * @srcpad should be a pad of an element inside @media->element.
 941  *
 942  * Returns: (transfer none): a new #GstRTSPStream that remains valid for as long
 943  *          as @media exists.
 944  */
 945 GstRTSPStream *
 946 gst_rtsp_media_create_stream (GstRTSPMedia * media, GstElement * payloader,
 947     GstPad * pad)
 948 {
 949   GstRTSPMediaPrivate *priv;
 950   GstRTSPStream *stream;
 951   GstPad *srcpad;
 952   gchar *name;
 953   gint idx;
 954
 955   g_return_val_if_fail (GST_IS_RTSP_MEDIA (media), NULL);
 956   g_return_val_if_fail (GST_IS_ELEMENT (payloader), NULL);
 957   g_return_val_if_fail (GST_IS_PAD (pad), NULL);
 958   g_return_val_if_fail (GST_PAD_IS_SRC (pad), NULL);
 959
 960   priv = media->priv;
 961
 962   g_mutex_lock (&priv->lock);
 963   idx = priv->streams->len;
 964
 965   GST_DEBUG ("media %p: creating stream with index %d", media, idx);
 966
 967   name = g_strdup_printf ("src_%u", idx);
 968   srcpad = gst_ghost_pad_new (name, pad);
 969   gst_pad_set_active (srcpad, TRUE);
 970   gst_element_add_pad (priv->element, srcpad);
 971   g_free (name);
 972
 973   stream = gst_rtsp_stream_new (idx, payloader, srcpad);
 974   if (priv->pool)
 975     gst_rtsp_stream_set_address_pool (stream, priv->pool);
 976
 977   g_ptr_array_add (priv->streams, stream);
 978   g_mutex_unlock (&priv->lock);
 979
 980   g_signal_emit (media, gst_rtsp_media_signals[SIGNAL_NEW_STREAM], 0, stream,
 981       NULL);
 982
 983   return stream;
 984 }
 985
 986 static void
 987 gst_rtsp_media_remove_stream (GstRTSPMedia * media, GstRTSPStream * stream)
 988 {
 989   GstRTSPMediaPrivate *priv;
 990   GstPad *srcpad;
 991
 992   priv = media->priv;
 993
 994   g_mutex_lock (&priv->lock);
 995   /* remove the ghostpad */
 996   srcpad = gst_rtsp_stream_get_srcpad (stream);
 997   gst_element_remove_pad (priv->element, srcpad);
 998   gst_object_unref (srcpad);
 999   /* now remove the stream */
1000   g_object_ref (stream);
1001   g_ptr_array_remove (priv->streams, stream);
1002   g_mutex_unlock (&priv->lock);
1003
1004   g_signal_emit (media, gst_rtsp_media_signals[SIGNAL_REMOVED_STREAM], 0,
1005       stream, NULL);
1006
1007   g_object_unref (stream);
1008 }
1009
1010 /**
1011  * gst_rtsp_media_n_streams:
1012  * @media: a #GstRTSPMedia
1013  *
1014  * Get the number of streams in this media.
1015  *
1016  * Returns: The number of streams.
1017  */
1018 guint
1019 gst_rtsp_media_n_streams (GstRTSPMedia * media)
1020 {
1021   GstRTSPMediaPrivate *priv;
1022   guint res;
1023
1024   g_return_val_if_fail (GST_IS_RTSP_MEDIA (media), 0);
1025
1026   priv = media->priv;
1027
1028   g_mutex_lock (&priv->lock);
1029   res = priv->streams->len;
1030   g_mutex_unlock (&priv->lock);
1031
1032   return res;
1033 }
1034
1035 /**
1036  * gst_rtsp_media_get_stream:
1037  * @media: a #GstRTSPMedia
1038  * @idx: the stream index
1039  *
1040  * Retrieve the stream with index @idx from @media.
1041  *
1042  * Returns: (transfer none): the #GstRTSPStream at index @idx or %NULL when a stream with
1043  * that index did not exist.
1044  */
1045 GstRTSPStream *
1046 gst_rtsp_media_get_stream (GstRTSPMedia * media, guint idx)
1047 {
1048   GstRTSPMediaPrivate *priv;
1049   GstRTSPStream *res;
1050
1051   g_return_val_if_fail (GST_IS_RTSP_MEDIA (media), NULL);
1052
1053   priv = media->priv;
1054
1055   g_mutex_lock (&priv->lock);
1056   if (idx < priv->streams->len)
1057     res = g_ptr_array_index (priv->streams, idx);
1058   else
1059     res = NULL;
1060   g_mutex_unlock (&priv->lock);
1061
1062   return res;
1063 }
1064
1065 /**
1066  * gst_rtsp_media_get_range_string:
1067  * @media: a #GstRTSPMedia
1068  * @play: for the PLAY request
1069  * @unit: the unit to use for the string
1070  *
1071  * Get the current range as a string. @media must be prepared with
1072  * gst_rtsp_media_prepare ().
1073  *
1074  * Returns: The range as a string, g_free() after usage.
1075  */
1076 gchar *
1077 gst_rtsp_media_get_range_string (GstRTSPMedia * media, gboolean play,
1078     GstRTSPRangeUnit unit)
1079 {
1080   GstRTSPMediaClass *klass;
1081   GstRTSPMediaPrivate *priv;
1082   gchar *result;
1083   GstRTSPTimeRange range;
1084
1085   klass = GST_RTSP_MEDIA_GET_CLASS (media);
1086   g_return_val_if_fail (GST_IS_RTSP_MEDIA (media), NULL);
1087   g_return_val_if_fail (klass->convert_range != NULL, FALSE);
1088
1089   priv = media->priv;
1090
1091   g_rec_mutex_lock (&priv->state_lock);
1092   if (priv->status != GST_RTSP_MEDIA_STATUS_PREPARED)
1093     goto not_prepared;
1094
1095   g_mutex_lock (&priv->lock);
1096   /* make copy */
1097   range = priv->range;
1098
1099   if (!play && priv->n_active > 0) {
1100     range.min.type = GST_RTSP_TIME_NOW;
1101     range.min.seconds = -1;
1102   }
1103   g_mutex_unlock (&priv->lock);
1104   g_rec_mutex_unlock (&priv->state_lock);
1105
1106   if (!klass->convert_range (media, &range, unit)) {
1107     goto conversion_failed;
1108   }
1109
1110   result = gst_rtsp_range_to_string (&range);
1111
1112   return result;
1113
1114   /* ERRORS */
1115 not_prepared:
1116   {
1117     GST_WARNING ("media %p was not prepared", media);
1118     g_rec_mutex_unlock (&priv->state_lock);
1119     return NULL;
1120   }
1121 conversion_failed:
1122   {
1123     GST_WARNING ("range conversion to unit %d failed", unit);
1124     g_rec_mutex_unlock (&priv->state_lock);
1125     return NULL;
1126   }
1127 }
1128
1129 /**
1130  * gst_rtsp_media_seek:
1131  * @media: a #GstRTSPMedia
1132  * @range: a #GstRTSPTimeRange
1133  *
1134  * Seek the pipeline of @media to @range. @media must be prepared with
1135  * gst_rtsp_media_prepare().
1136  *
1137  * Returns: %TRUE on success.
1138  */
1139 gboolean
1140 gst_rtsp_media_seek (GstRTSPMedia * media, GstRTSPTimeRange * range)
1141 {
1142   GstRTSPMediaClass *klass;
1143   GstRTSPMediaPrivate *priv;
1144   GstSeekFlags flags;
1145   gboolean res;
1146   GstClockTime start, stop;
1147   GstSeekType start_type, stop_type;
1148
1149   klass = GST_RTSP_MEDIA_GET_CLASS (media);
1150
1151   g_return_val_if_fail (GST_IS_RTSP_MEDIA (media), FALSE);
1152   g_return_val_if_fail (range != NULL, FALSE);
1153   g_return_val_if_fail (klass->convert_range != NULL, FALSE);
1154
1155   priv = media->priv;
1156
1157   g_rec_mutex_lock (&priv->state_lock);
1158   if (priv->status != GST_RTSP_MEDIA_STATUS_PREPARED)
1159     goto not_prepared;
1160
1161   if (!priv->seekable)
1162     goto not_seekable;
1163
1164   /* depends on the current playing state of the pipeline. We might need to
1165    * queue this until we get EOS. */
1166   flags = GST_SEEK_FLAG_FLUSH | GST_SEEK_FLAG_ACCURATE | GST_SEEK_FLAG_KEY_UNIT;
1167
1168   start_type = stop_type = GST_SEEK_TYPE_NONE;
1169
1170   if (!klass->convert_range (media, range, GST_RTSP_RANGE_NPT))
1171     goto not_supported;
1172   gst_rtsp_range_get_times (range, &start, &stop);
1173
1174   GST_INFO ("got %" GST_TIME_FORMAT " - %" GST_TIME_FORMAT,
1175       GST_TIME_ARGS (start), GST_TIME_ARGS (stop));
1176   GST_INFO ("current %" GST_TIME_FORMAT " - %" GST_TIME_FORMAT,
1177       GST_TIME_ARGS (priv->range_start), GST_TIME_ARGS (priv->range_stop));
1178
1179   if (priv->range_start == start)
1180     start = GST_CLOCK_TIME_NONE;
1181   else if (start != GST_CLOCK_TIME_NONE)
1182     start_type = GST_SEEK_TYPE_SET;
1183
1184   if (priv->range_stop == stop)
1185     stop = GST_CLOCK_TIME_NONE;
1186   else if (stop != GST_CLOCK_TIME_NONE)
1187     stop_type = GST_SEEK_TYPE_SET;
1188
1189   if (start != GST_CLOCK_TIME_NONE || stop != GST_CLOCK_TIME_NONE) {
1190     GST_INFO ("seeking to %" GST_TIME_FORMAT " - %" GST_TIME_FORMAT,
1191         GST_TIME_ARGS (start), GST_TIME_ARGS (stop));
1192
1193     res = gst_element_seek (priv->pipeline, 1.0, GST_FORMAT_TIME,
1194         flags, start_type, start, stop_type, stop);
1195
1196     /* and block for the seek to complete */
1197     GST_INFO ("done seeking %d", res);
1198     gst_element_get_state (priv->pipeline, NULL, NULL, -1);
1199     GST_INFO ("prerolled again");
1200
1201     collect_media_stats (media);
1202   } else {
1203     GST_INFO ("no seek needed");
1204     res = TRUE;
1205   }
1206   g_rec_mutex_unlock (&priv->state_lock);
1207
1208   return res;
1209
1210   /* ERRORS */
1211 not_prepared:
1212   {
1213     g_rec_mutex_unlock (&priv->state_lock);
1214     GST_INFO ("media %p is not prepared", media);
1215     return FALSE;
1216   }
1217 not_seekable:
1218   {
1219     g_rec_mutex_unlock (&priv->state_lock);
1220     GST_INFO ("pipeline is not seekable");
1221     return TRUE;
1222   }
1223 not_supported:
1224   {
1225     g_rec_mutex_unlock (&priv->state_lock);
1226     GST_WARNING ("conversion to npt not supported");
1227     return FALSE;
1228   }
1229 }
1230
1231 static void
1232 gst_rtsp_media_set_status (GstRTSPMedia * media, GstRTSPMediaStatus status)
1233 {
1234   GstRTSPMediaPrivate *priv = media->priv;
1235
1236   g_mutex_lock (&priv->lock);
1237   priv->status = status;
1238   GST_DEBUG ("setting new status to %d", status);
1239   g_cond_broadcast (&priv->cond);
1240   g_mutex_unlock (&priv->lock);
1241 }
1242
1243 /**
1244  * gst_rtsp_media_get_status:
1245  * @media: a #GstRTSPMedia
1246  *
1247  * Get the status of @media. When @media is busy preparing, this function waits
1248  * until @media is prepared or in error.
1249  *
1250  * Returns: the status of @media.
1251  */
1252 GstRTSPMediaStatus
1253 gst_rtsp_media_get_status (GstRTSPMedia * media)
1254 {
1255   GstRTSPMediaPrivate *priv = media->priv;
1256   GstRTSPMediaStatus result;
1257   gint64 end_time;
1258
1259   g_mutex_lock (&priv->lock);
1260   end_time = g_get_monotonic_time () + 20 * G_TIME_SPAN_SECOND;
1261   /* while we are preparing, wait */
1262   while (priv->status == GST_RTSP_MEDIA_STATUS_PREPARING) {
1263     GST_DEBUG ("waiting for status change");
1264     if (!g_cond_wait_until (&priv->cond, &priv->lock, end_time)) {
1265       GST_DEBUG ("timeout, assuming error status");
1266       priv->status = GST_RTSP_MEDIA_STATUS_ERROR;
1267     }
1268   }
1269   /* could be success or error */
1270   result = priv->status;
1271   GST_DEBUG ("got status %d", result);
1272   g_mutex_unlock (&priv->lock);
1273
1274   return result;
1275 }
1276
1277 /* called with state-lock */
1278 static gboolean
1279 default_handle_message (GstRTSPMedia * media, GstMessage * message)
1280 {
1281   GstRTSPMediaPrivate *priv = media->priv;
1282   GstMessageType type;
1283
1284   type = GST_MESSAGE_TYPE (message);
1285
1286   switch (type) {
1287     case GST_MESSAGE_STATE_CHANGED:
1288       break;
1289     case GST_MESSAGE_BUFFERING:
1290     {
1291       gint percent;
1292
1293       gst_message_parse_buffering (message, &percent);
1294
1295       /* no state management needed for live pipelines */
1296       if (priv->is_live)
1297         break;
1298
1299       if (percent == 100) {
1300         /* a 100% message means buffering is done */
1301         priv->buffering = FALSE;
1302         /* if the desired state is playing, go back */
1303         if (priv->target_state == GST_STATE_PLAYING) {
1304           GST_INFO ("Buffering done, setting pipeline to PLAYING");
1305           gst_element_set_state (priv->pipeline, GST_STATE_PLAYING);
1306         } else {
1307           GST_INFO ("Buffering done");
1308         }
1309       } else {
1310         /* buffering busy */
1311         if (priv->buffering == FALSE) {
1312           if (priv->target_state == GST_STATE_PLAYING) {
1313             /* we were not buffering but PLAYING, PAUSE  the pipeline. */
1314             GST_INFO ("Buffering, setting pipeline to PAUSED ...");
1315             gst_element_set_state (priv->pipeline, GST_STATE_PAUSED);
1316           } else {
1317             GST_INFO ("Buffering ...");
1318           }
1319         }
1320         priv->buffering = TRUE;
1321       }
1322       break;
1323     }
1324     case GST_MESSAGE_LATENCY:
1325     {
1326       gst_bin_recalculate_latency (GST_BIN_CAST (priv->pipeline));
1327       break;
1328     }
1329     case GST_MESSAGE_ERROR:
1330     {
1331       GError *gerror;
1332       gchar *debug;
1333
1334       gst_message_parse_error (message, &gerror, &debug);
1335       GST_WARNING ("%p: got error %s (%s)", media, gerror->message, debug);
1336       g_error_free (gerror);
1337       g_free (debug);
1338
1339       gst_rtsp_media_set_status (media, GST_RTSP_MEDIA_STATUS_ERROR);
1340       break;
1341     }
1342     case GST_MESSAGE_WARNING:
1343     {
1344       GError *gerror;
1345       gchar *debug;
1346
1347       gst_message_parse_warning (message, &gerror, &debug);
1348       GST_WARNING ("%p: got warning %s (%s)", media, gerror->message, debug);
1349       g_error_free (gerror);
1350       g_free (debug);
1351       break;
1352     }
1353     case GST_MESSAGE_ELEMENT:
1354       break;
1355     case GST_MESSAGE_STREAM_STATUS:
1356       break;
1357     case GST_MESSAGE_ASYNC_DONE:
1358       if (priv->adding) {
1359         /* when we are dynamically adding pads, the addition of the udpsrc will
1360          * temporarily produce ASYNC_DONE messages. We have to ignore them and
1361          * wait for the final ASYNC_DONE after everything prerolled */
1362         GST_INFO ("%p: ignoring ASYNC_DONE", media);
1363       } else {
1364         GST_INFO ("%p: got ASYNC_DONE", media);
1365         collect_media_stats (media);
1366
1367         if (priv->status == GST_RTSP_MEDIA_STATUS_PREPARING)
1368           gst_rtsp_media_set_status (media, GST_RTSP_MEDIA_STATUS_PREPARED);
1369       }
1370       break;
1371     case GST_MESSAGE_EOS:
1372       GST_INFO ("%p: got EOS", media);
1373
1374       if (priv->status == GST_RTSP_MEDIA_STATUS_UNPREPARING) {
1375         GST_DEBUG ("shutting down after EOS");
1376         finish_unprepare (media);
1377       }
1378       break;
1379     default:
1380       GST_INFO ("%p: got message type %d (%s)", media, type,
1381           gst_message_type_get_name (type));
1382       break;
1383   }
1384   return TRUE;
1385 }
1386
1387 static gboolean
1388 bus_message (GstBus * bus, GstMessage * message, GstRTSPMedia * media)
1389 {
1390   GstRTSPMediaPrivate *priv = media->priv;
1391   GstRTSPMediaClass *klass;
1392   gboolean ret;
1393
1394   klass = GST_RTSP_MEDIA_GET_CLASS (media);
1395
1396   g_rec_mutex_lock (&priv->state_lock);
1397   if (klass->handle_message)
1398     ret = klass->handle_message (media, message);
1399   else
1400     ret = FALSE;
1401   g_rec_mutex_unlock (&priv->state_lock);
1402
1403   return ret;
1404 }
1405
1406 static void
1407 watch_destroyed (GstRTSPMedia * media)
1408 {
1409   GST_DEBUG_OBJECT (media, "source destroyed");
1410   g_object_unref (media);
1411 }
1412
1413 /* called from streaming threads */
1414 static void
1415 pad_added_cb (GstElement * element, GstPad * pad, GstRTSPMedia * media)
1416 {
1417   GstRTSPMediaPrivate *priv = media->priv;
1418   GstRTSPStream *stream;
1419
1420   /* FIXME, element is likely not a payloader, find the payloader here */
1421   stream = gst_rtsp_media_create_stream (media, element, pad);
1422
1423   g_object_set_data (G_OBJECT (pad), "gst-rtsp-dynpad-stream", stream);
1424
1425   GST_INFO ("pad added %s:%s, stream %p", GST_DEBUG_PAD_NAME (pad), stream);
1426
1427   g_rec_mutex_lock (&priv->state_lock);
1428   /* we will be adding elements below that will cause ASYNC_DONE to be
1429    * posted in the bus. We want to ignore those messages until the
1430    * pipeline really prerolled. */
1431   priv->adding = TRUE;
1432
1433   /* join the element in the PAUSED state because this callback is
1434    * called from the streaming thread and it is PAUSED */
1435   gst_rtsp_stream_join_bin (stream, GST_BIN (priv->pipeline),
1436       priv->rtpbin, GST_STATE_PAUSED);
1437
1438   priv->adding = FALSE;
1439   g_rec_mutex_unlock (&priv->state_lock);
1440 }
1441
1442 static void
1443 pad_removed_cb (GstElement * element, GstPad * pad, GstRTSPMedia * media)
1444 {
1445   GstRTSPMediaPrivate *priv = media->priv;
1446   GstRTSPStream *stream;
1447
1448   stream = g_object_get_data (G_OBJECT (pad), "gst-rtsp-dynpad-stream");
1449   if (stream == NULL)
1450     return;
1451
1452   GST_INFO ("pad removed %s:%s, stream %p", GST_DEBUG_PAD_NAME (pad), stream);
1453
1454   g_rec_mutex_lock (&priv->state_lock);
1455   gst_rtsp_stream_leave_bin (stream, GST_BIN (priv->pipeline), priv->rtpbin);
1456   g_rec_mutex_unlock (&priv->state_lock);
1457
1458   gst_rtsp_media_remove_stream (media, stream);
1459 }
1460
1461 static void
1462 remove_fakesink (GstRTSPMediaPrivate * priv)
1463 {
1464   GstElement *fakesink;
1465
1466   g_mutex_lock (&priv->lock);
1467   if ((fakesink = priv->fakesink))
1468     gst_object_ref (fakesink);
1469   priv->fakesink = NULL;
1470   g_mutex_unlock (&priv->lock);
1471
1472   if (fakesink) {
1473     gst_bin_remove (GST_BIN (priv->pipeline), fakesink);
1474     gst_element_set_state (fakesink, GST_STATE_NULL);
1475     gst_object_unref (fakesink);
1476     GST_INFO ("removed fakesink");
1477   }
1478 }
1479
1480 static void
1481 no_more_pads_cb (GstElement * element, GstRTSPMedia * media)
1482 {
1483   GstRTSPMediaPrivate *priv = media->priv;
1484
1485   GST_INFO ("no more pads");
1486   remove_fakesink (priv);
1487 }
1488
1489 typedef struct _DynPaySignalHandlers DynPaySignalHandlers;
1490
1491 struct _DynPaySignalHandlers
1492 {
1493   gulong pad_added_handler;
1494   gulong pad_removed_handler;
1495   gulong no_more_pads_handler;
1496 };
1497
1498 /**
1499  * gst_rtsp_media_prepare:
1500  * @media: a #GstRTSPMedia
1501  *
1502  * Prepare @media for streaming. This function will create the objects
1503  * to manage the streaming. A pipeline must have been set on @media with
1504  * gst_rtsp_media_take_pipeline().
1505  *
1506  * It will preroll the pipeline and collect vital information about the streams
1507  * such as the duration.
1508  *
1509  * Returns: %TRUE on success.
1510  */
1511 gboolean
1512 gst_rtsp_media_prepare (GstRTSPMedia * media)
1513 {
1514   GstRTSPMediaPrivate *priv;
1515   GstStateChangeReturn ret;
1516   GstRTSPMediaStatus status;
1517   guint i;
1518   GstRTSPMediaClass *klass;
1519   GstBus *bus;
1520   GList *walk;
1521
1522   g_return_val_if_fail (GST_IS_RTSP_MEDIA (media), FALSE);
1523
1524   priv = media->priv;
1525
1526   g_rec_mutex_lock (&priv->state_lock);
1527   priv->prepare_count++;
1528
1529   if (priv->status == GST_RTSP_MEDIA_STATUS_PREPARED)
1530     goto was_prepared;
1531
1532   if (priv->status == GST_RTSP_MEDIA_STATUS_PREPARING)
1533     goto wait_status;
1534
1535   if (priv->status != GST_RTSP_MEDIA_STATUS_UNPREPARED)
1536     goto not_unprepared;
1537
1538   if (!priv->reusable && priv->reused)
1539     goto is_reused;
1540
1541   priv->rtpbin = gst_element_factory_make ("rtpbin", NULL);
1542   if (priv->rtpbin == NULL)
1543     goto no_rtpbin;
1544
1545   GST_INFO ("preparing media %p", media);
1546
1547   /* reset some variables */
1548   priv->is_live = FALSE;
1549   priv->seekable = FALSE;
1550   priv->buffering = FALSE;
1551   /* we're preparing now */
1552   priv->status = GST_RTSP_MEDIA_STATUS_PREPARING;
1553
1554   bus = gst_pipeline_get_bus (GST_PIPELINE_CAST (priv->pipeline));
1555
1556   /* add the pipeline bus to our custom mainloop */
1557   priv->source = gst_bus_create_watch (bus);
1558   gst_object_unref (bus);
1559
1560   g_source_set_callback (priv->source, (GSourceFunc) bus_message,
1561       g_object_ref (media), (GDestroyNotify) watch_destroyed);
1562
1563   klass = GST_RTSP_MEDIA_GET_CLASS (media);
1564   priv->id = g_source_attach (priv->source, klass->context);
1565
1566   /* add stuff to the bin */
1567   gst_bin_add (GST_BIN (priv->pipeline), priv->rtpbin);
1568
1569   /* link streams we already have, other streams might appear when we have
1570    * dynamic elements */
1571   for (i = 0; i < priv->streams->len; i++) {
1572     GstRTSPStream *stream;
1573
1574     stream = g_ptr_array_index (priv->streams, i);
1575
1576     gst_rtsp_stream_join_bin (stream, GST_BIN (priv->pipeline),
1577         priv->rtpbin, GST_STATE_NULL);
1578   }
1579
1580   for (walk = priv->dynamic; walk; walk = g_list_next (walk)) {
1581     GstElement *elem = walk->data;
1582     DynPaySignalHandlers *handlers = g_slice_new (DynPaySignalHandlers);
1583
1584     GST_INFO ("adding callbacks for dynamic element %p", elem);
1585
1586     handlers->pad_added_handler = g_signal_connect (elem, "pad-added",
1587         (GCallback) pad_added_cb, media);
1588     handlers->pad_removed_handler = g_signal_connect (elem, "pad-removed",
1589         (GCallback) pad_removed_cb, media);
1590     handlers->no_more_pads_handler = g_signal_connect (elem, "no-more-pads",
1591         (GCallback) no_more_pads_cb, media);
1592
1593     g_object_set_data (G_OBJECT (elem), "gst-rtsp-dynpay-handlers", handlers);
1594
1595     /* we add a fakesink here in order to make the state change async. We remove
1596      * the fakesink again in the no-more-pads callback. */
1597     priv->fakesink = gst_element_factory_make ("fakesink", "fakesink");
1598     gst_bin_add (GST_BIN (priv->pipeline), priv->fakesink);
1599   }
1600
1601   GST_INFO ("setting pipeline to PAUSED for media %p", media);
1602   /* first go to PAUSED */
1603   ret = gst_element_set_state (priv->pipeline, GST_STATE_PAUSED);
1604   priv->target_state = GST_STATE_PAUSED;
1605
1606   switch (ret) {
1607     case GST_STATE_CHANGE_SUCCESS:
1608       GST_INFO ("SUCCESS state change for media %p", media);
1609       priv->seekable = TRUE;
1610       break;
1611     case GST_STATE_CHANGE_ASYNC:
1612       GST_INFO ("ASYNC state change for media %p", media);
1613       priv->seekable = TRUE;
1614       break;
1615     case GST_STATE_CHANGE_NO_PREROLL:
1616       /* we need to go to PLAYING */
1617       GST_INFO ("NO_PREROLL state change: live media %p", media);
1618       /* FIXME we disable seeking for live streams for now. We should perform a
1619        * seeking query in preroll instead */
1620       priv->seekable = FALSE;
1621       priv->is_live = TRUE;
1622       ret = gst_element_set_state (priv->pipeline, GST_STATE_PLAYING);
1623       if (ret == GST_STATE_CHANGE_FAILURE)
1624         goto state_failed;
1625       break;
1626     case GST_STATE_CHANGE_FAILURE:
1627       goto state_failed;
1628   }
1629 wait_status:
1630   g_rec_mutex_unlock (&priv->state_lock);
1631
1632   /* now wait for all pads to be prerolled, FIXME, we should somehow be
1633    * able to do this async so that we don't block the server thread. */
1634   status = gst_rtsp_media_get_status (media);
1635   if (status == GST_RTSP_MEDIA_STATUS_ERROR)
1636     goto state_failed;
1637
1638   g_signal_emit (media, gst_rtsp_media_signals[SIGNAL_PREPARED], 0, NULL);
1639
1640   GST_INFO ("object %p is prerolled", media);
1641
1642   return TRUE;
1643
1644   /* OK */
1645 was_prepared:
1646   {
1647     GST_LOG ("media %p was prepared", media);
1648     g_rec_mutex_unlock (&priv->state_lock);
1649     return TRUE;
1650   }
1651   /* ERRORS */
1652 not_unprepared:
1653   {
1654     GST_WARNING ("media %p was not unprepared", media);
1655     priv->prepare_count--;
1656     g_rec_mutex_unlock (&priv->state_lock);
1657     return FALSE;
1658   }
1659 is_reused:
1660   {
1661     priv->prepare_count--;
1662     g_rec_mutex_unlock (&priv->state_lock);
1663     GST_WARNING ("can not reuse media %p", media);
1664     return FALSE;
1665   }
1666 no_rtpbin:
1667   {
1668     priv->prepare_count--;
1669     g_rec_mutex_unlock (&priv->state_lock);
1670     GST_WARNING ("no rtpbin element");
1671     g_warning ("failed to create element 'rtpbin', check your installation");
1672     return FALSE;
1673   }
1674 state_failed:
1675   {
1676     GST_WARNING ("failed to preroll pipeline");
1677     gst_rtsp_media_unprepare (media);
1678     g_rec_mutex_unlock (&priv->state_lock);
1679     return FALSE;
1680   }
1681 }
1682
1683 /* must be called with state-lock */
1684 static void
1685 finish_unprepare (GstRTSPMedia * media)
1686 {
1687   GstRTSPMediaPrivate *priv = media->priv;
1688   gint i;
1689   GList *walk;
1690
1691   GST_DEBUG ("shutting down");
1692
1693   gst_element_set_state (priv->pipeline, GST_STATE_NULL);
1694   remove_fakesink (priv);
1695
1696   for (i = 0; i < priv->streams->len; i++) {
1697     GstRTSPStream *stream;
1698
1699     GST_INFO ("Removing elements of stream %d from pipeline", i);
1700
1701     stream = g_ptr_array_index (priv->streams, i);
1702
1703     gst_rtsp_stream_leave_bin (stream, GST_BIN (priv->pipeline), priv->rtpbin);
1704   }
1705
1706   /* remove the pad signal handlers */
1707   for (walk = priv->dynamic; walk; walk = g_list_next (walk)) {
1708     GstElement *elem = walk->data;
1709     DynPaySignalHandlers *handlers;
1710
1711     handlers =
1712         g_object_steal_data (G_OBJECT (elem), "gst-rtsp-dynpay-handlers");
1713     g_assert (handlers != NULL);
1714
1715     g_signal_handler_disconnect (G_OBJECT (elem), handlers->pad_added_handler);
1716     g_signal_handler_disconnect (G_OBJECT (elem),
1717         handlers->pad_removed_handler);
1718     g_signal_handler_disconnect (G_OBJECT (elem),
1719         handlers->no_more_pads_handler);
1720
1721     g_slice_free (DynPaySignalHandlers, handlers);
1722   }
1723
1724   gst_bin_remove (GST_BIN (priv->pipeline), priv->rtpbin);
1725   priv->rtpbin = NULL;
1726
1727   if (priv->nettime)
1728     gst_object_unref (priv->nettime);
1729   priv->nettime = NULL;
1730
1731   priv->reused = TRUE;
1732   priv->status = GST_RTSP_MEDIA_STATUS_UNPREPARED;
1733
1734   /* when the media is not reusable, this will effectively unref the media and
1735    * recreate it */
1736   g_signal_emit (media, gst_rtsp_media_signals[SIGNAL_UNPREPARED], 0, NULL);
1737
1738   /* the source has the last ref to the media */
1739   if (priv->source) {
1740     GST_DEBUG ("destroy source");
1741     g_source_destroy (priv->source);
1742     g_source_unref (priv->source);
1743   }
1744 }
1745
1746 /* called with state-lock */
1747 static gboolean
1748 default_unprepare (GstRTSPMedia * media)
1749 {
1750   GstRTSPMediaPrivate *priv = media->priv;
1751
1752   if (priv->eos_shutdown) {
1753     GST_DEBUG ("sending EOS for shutdown");
1754     /* ref so that we don't disappear */
1755     gst_element_send_event (priv->pipeline, gst_event_new_eos ());
1756     /* we need to go to playing again for the EOS to propagate, normally in this
1757      * state, nothing is receiving data from us anymore so this is ok. */
1758     gst_element_set_state (priv->pipeline, GST_STATE_PLAYING);
1759     priv->status = GST_RTSP_MEDIA_STATUS_UNPREPARING;
1760   } else {
1761     finish_unprepare (media);
1762   }
1763   return TRUE;
1764 }
1765
1766 /**
1767  * gst_rtsp_media_unprepare:
1768  * @media: a #GstRTSPMedia
1769  *
1770  * Unprepare @media. After this call, the media should be prepared again before
1771  * it can be used again. If the media is set to be non-reusable, a new instance
1772  * must be created.
1773  *
1774  * Returns: %TRUE on success.
1775  */
1776 gboolean
1777 gst_rtsp_media_unprepare (GstRTSPMedia * media)
1778 {
1779   GstRTSPMediaPrivate *priv;
1780   gboolean success;
1781
1782   g_return_val_if_fail (GST_IS_RTSP_MEDIA (media), FALSE);
1783
1784   priv = media->priv;
1785
1786   g_rec_mutex_lock (&priv->state_lock);
1787   if (priv->status == GST_RTSP_MEDIA_STATUS_UNPREPARED)
1788     goto was_unprepared;
1789
1790   priv->prepare_count--;
1791   if (priv->prepare_count > 0)
1792     goto is_busy;
1793
1794   GST_INFO ("unprepare media %p", media);
1795   priv->target_state = GST_STATE_NULL;
1796   success = TRUE;
1797
1798   if (priv->status == GST_RTSP_MEDIA_STATUS_PREPARED) {
1799     GstRTSPMediaClass *klass;
1800
1801     klass = GST_RTSP_MEDIA_GET_CLASS (media);
1802     if (klass->unprepare)
1803       success = klass->unprepare (media);
1804   } else {
1805     finish_unprepare (media);
1806   }
1807   g_rec_mutex_unlock (&priv->state_lock);
1808
1809   return success;
1810
1811 was_unprepared:
1812   {
1813     g_rec_mutex_unlock (&priv->state_lock);
1814     GST_INFO ("media %p was already unprepared", media);
1815     return TRUE;
1816   }
1817 is_busy:
1818   {
1819     GST_INFO ("media %p still prepared %d times", media, priv->prepare_count);
1820     g_rec_mutex_unlock (&priv->state_lock);
1821     return TRUE;
1822   }
1823 }
1824
1825 /* should be called with state-lock */
1826 static GstClock *
1827 get_clock_unlocked (GstRTSPMedia * media)
1828 {
1829   if (media->priv->status != GST_RTSP_MEDIA_STATUS_PREPARED) {
1830     GST_DEBUG_OBJECT (media, "media was not prepared");
1831     return NULL;
1832   }
1833   return gst_pipeline_get_clock (GST_PIPELINE_CAST (media->priv->pipeline));
1834 }
1835
1836 /**
1837  * gst_rtsp_media_get_clock:
1838  * @media: a #GstRTSPMedia
1839  *
1840  * Get the clock that is used by the pipeline in @media.
1841  *
1842  * @media must be prepared before this method returns a valid clock object.
1843  *
1844  * Returns: the #GstClock used by @media. unref after usage.
1845  */
1846 GstClock *
1847 gst_rtsp_media_get_clock (GstRTSPMedia * media)
1848 {
1849   GstClock *clock;
1850   GstRTSPMediaPrivate *priv;
1851
1852   g_return_val_if_fail (GST_IS_RTSP_MEDIA (media), NULL);
1853
1854   priv = media->priv;
1855
1856   g_rec_mutex_lock (&priv->state_lock);
1857   clock = get_clock_unlocked (media);
1858   g_rec_mutex_unlock (&priv->state_lock);
1859
1860   return clock;
1861 }
1862
1863 /**
1864  * gst_rtsp_media_get_base_time:
1865  * @media: a #GstRTSPMedia
1866  *
1867  * Get the base_time that is used by the pipeline in @media.
1868  *
1869  * @media must be prepared before this method returns a valid base_time.
1870  *
1871  * Returns: the base_time used by @media.
1872  */
1873 GstClockTime
1874 gst_rtsp_media_get_base_time (GstRTSPMedia * media)
1875 {
1876   GstClockTime result;
1877   GstRTSPMediaPrivate *priv;
1878
1879   g_return_val_if_fail (GST_IS_RTSP_MEDIA (media), GST_CLOCK_TIME_NONE);
1880
1881   priv = media->priv;
1882
1883   g_rec_mutex_lock (&priv->state_lock);
1884   if (media->priv->status != GST_RTSP_MEDIA_STATUS_PREPARED)
1885     goto not_prepared;
1886
1887   result = gst_element_get_base_time (media->priv->pipeline);
1888   g_rec_mutex_unlock (&priv->state_lock);
1889
1890   return result;
1891
1892   /* ERRORS */
1893 not_prepared:
1894   {
1895     g_rec_mutex_unlock (&priv->state_lock);
1896     GST_DEBUG_OBJECT (media, "media was not prepared");
1897     return GST_CLOCK_TIME_NONE;
1898   }
1899 }
1900
1901 /**
1902  * gst_rtsp_media_get_time_provider:
1903  * @media: a #GstRTSPMedia
1904  * @address: an address or NULL
1905  * @port: a port or 0
1906  *
1907  * Get the #GstNetTimeProvider for the clock used by @media. The time provider
1908  * will listen on @address and @port for client time requests.
1909  *
1910  * Returns: the #GstNetTimeProvider of @media.
1911  */
1912 GstNetTimeProvider *
1913 gst_rtsp_media_get_time_provider (GstRTSPMedia * media, const gchar * address,
1914     guint16 port)
1915 {
1916   GstRTSPMediaPrivate *priv;
1917   GstNetTimeProvider *provider = NULL;
1918
1919   g_return_val_if_fail (GST_IS_RTSP_MEDIA (media), NULL);
1920
1921   priv = media->priv;
1922
1923   g_rec_mutex_lock (&priv->state_lock);
1924   if (priv->time_provider) {
1925     if ((provider = priv->nettime) == NULL) {
1926       GstClock *clock;
1927
1928       if (priv->time_provider && (clock = get_clock_unlocked (media))) {
1929         provider = gst_net_time_provider_new (clock, address, port);
1930         gst_object_unref (clock);
1931
1932         priv->nettime = provider;
1933       }
1934     }
1935   }
1936   g_rec_mutex_unlock (&priv->state_lock);
1937
1938   if (provider)
1939     gst_object_ref (provider);
1940
1941   return provider;
1942 }
1943
1944 /**
1945  * gst_rtsp_media_set_state:
1946  * @media: a #GstRTSPMedia
1947  * @state: the target state of the media
1948  * @transports: a #GPtrArray of #GstRTSPStreamTransport pointers
1949  *
1950  * Set the state of @media to @state and for the transports in @transports.
1951  *
1952  * @media must be prepared with gst_rtsp_media_prepare();
1953  *
1954  * Returns: %TRUE on success.
1955  */
1956 gboolean
1957 gst_rtsp_media_set_state (GstRTSPMedia * media, GstState state,
1958     GPtrArray * transports)
1959 {
1960   GstRTSPMediaPrivate *priv;
1961   gint i;
1962   gboolean activate, deactivate, do_state;
1963   gint old_active;
1964
1965   g_return_val_if_fail (GST_IS_RTSP_MEDIA (media), FALSE);
1966   g_return_val_if_fail (transports != NULL, FALSE);
1967
1968   priv = media->priv;
1969
1970   g_rec_mutex_lock (&priv->state_lock);
1971   if (priv->status != GST_RTSP_MEDIA_STATUS_PREPARED)
1972     goto not_prepared;
1973
1974   /* NULL and READY are the same */
1975   if (state == GST_STATE_READY)
1976     state = GST_STATE_NULL;
1977
1978   activate = deactivate = FALSE;
1979
1980   GST_INFO ("going to state %s media %p", gst_element_state_get_name (state),
1981       media);
1982
1983   switch (state) {
1984     case GST_STATE_NULL:
1985     case GST_STATE_PAUSED:
1986       /* we're going from PLAYING to PAUSED, READY or NULL, deactivate */
1987       if (priv->target_state == GST_STATE_PLAYING)
1988         deactivate = TRUE;
1989       break;
1990     case GST_STATE_PLAYING:
1991       /* we're going to PLAYING, activate */
1992       activate = TRUE;
1993       break;
1994     default:
1995       break;
1996   }
1997   old_active = priv->n_active;
1998
1999   for (i = 0; i < transports->len; i++) {
2000     GstRTSPStreamTransport *trans;
2001
2002     /* we need a non-NULL entry in the array */
2003     trans = g_ptr_array_index (transports, i);
2004     if (trans == NULL)
2005       continue;
2006
2007     if (activate) {
2008       if (gst_rtsp_stream_transport_set_active (trans, TRUE))
2009         priv->n_active++;
2010     } else if (deactivate) {
2011       if (gst_rtsp_stream_transport_set_active (trans, FALSE))
2012         priv->n_active--;
2013     }
2014   }
2015
2016   /* we just activated the first media, do the playing state change */
2017   if (old_active == 0 && activate)
2018     do_state = TRUE;
2019   /* if we have no more active media, do the downward state changes */
2020   else if (priv->n_active == 0)
2021     do_state = TRUE;
2022   else
2023     do_state = FALSE;
2024
2025   GST_INFO ("state %d active %d media %p do_state %d", state, priv->n_active,
2026       media, do_state);
2027
2028   if (priv->target_state != state) {
2029     if (do_state) {
2030       if (state == GST_STATE_NULL) {
2031         gst_rtsp_media_unprepare (media);
2032       } else {
2033         GST_INFO ("state %s media %p", gst_element_state_get_name (state),
2034             media);
2035         priv->target_state = state;
2036         /* when we are buffering, don't update the state yet, this will be done
2037          * when buffering finishes */
2038         if (priv->buffering) {
2039           GST_INFO ("Buffering busy, delay state change");
2040         } else {
2041           gst_element_set_state (priv->pipeline, state);
2042         }
2043       }
2044     }
2045     g_signal_emit (media, gst_rtsp_media_signals[SIGNAL_NEW_STATE], 0, state,
2046         NULL);
2047   }
2048
2049   /* remember where we are */
2050   if (state != GST_STATE_NULL && (state == GST_STATE_PAUSED ||
2051           old_active != priv->n_active))
2052     collect_media_stats (media);
2053
2054   g_rec_mutex_unlock (&priv->state_lock);
2055
2056   return TRUE;
2057
2058   /* ERRORS */
2059 not_prepared:
2060   {
2061     GST_WARNING ("media %p was not prepared", media);
2062     g_rec_mutex_unlock (&priv->state_lock);
2063     return FALSE;
2064   }
2065 }
2066
2067 /* called with state-lock */
2068 static gboolean
2069 default_convert_range (GstRTSPMedia * media, GstRTSPTimeRange * range,
2070     GstRTSPRangeUnit unit)
2071 {
2072   return gst_rtsp_range_convert_units (range, unit);
2073 }