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