ristsrc: Add support for dynamic payload

This commit ports functionality from the `rtpsrc` to make the `ristsrc`
work with dynamic payload types.

It adds two properties:
  - `caps`
  - `encoding-name`

These can be used to make the `ristsrc` receive other payload types than
the MPEG TS one.

Part-of: <https://gitlab.freedesktop.org/gstreamer/gstreamer/-/merge_requests/5422>
This commit is contained in:
Jonas K Danielsson 2023-09-29 06:39:22 +02:00 committed by GStreamer Marge Bot
parent 8057597dd2
commit f4fb4a5606

View file

@ -41,6 +41,22 @@
* gst-play-1.0 "rist://0.0.0.0:5004?receiver-buffer=700"
* ]|
*
* In order to use a dynamic payload type the element needs to be able
* to set the correct caps. It can be done through setting the #GstRistSrc:caps
* property or one can use the #GstRistSrc:encoding-name property and the
* element can work out the caps from it.
*
* ## Example pipelines for sending and receiving dynamic payload
* |[
* gst-launch-1.0 videotestsrc ! videoconvert ! x264enc ! h264parse ! \
* rtph264pay ! ristsink address=127.0.0.1 port=5000
* ]| Encode and payload H264 video from videotestsrc. The H264 RTP packets are
* sent on port 5000.
* |[
* gst-launch-1.0 ristsrc address=0.0.0.0 port=5000 encoding-name="h264" ! \
* rtph264depay ! h264parse ! matroskamux ! filesink location=h264.mkv
* ] Receive and depayload the H264 video via RIST.
*
* Additionally, this element supports link bonding, which means it
* can receive the same stream from multiple addresses. Each address
* will be mapped to its own RTP session. In order to enable bonding
@ -92,7 +108,9 @@ enum
PROP_MULTICAST_LOOPBACK,
PROP_MULTICAST_IFACE,
PROP_MULTICAST_TTL,
PROP_BONDING_ADDRESSES
PROP_BONDING_ADDRESSES,
PROP_CAPS,
PROP_ENCODING_NAME
};
static GstStaticPadTemplate src_templ = GST_STATIC_PAD_TEMPLATE ("src",
@ -156,6 +174,10 @@ struct _GstRistSrc
* to fail state changes later */
gboolean construct_failed;
const gchar *missing_plugin;
/* For handling dynamic payload */
GstCaps *caps;
gchar *encoding_name;
};
static void gst_rist_src_uri_init (gpointer g_iface, gpointer iface_data);
@ -236,22 +258,52 @@ static GstCaps *
gst_rist_src_request_pt_map (GstRistSrc * src, guint session_id, guint pt,
GstElement * rtpbin)
{
const GstRTPPayloadInfo *pt_info;
const GstRTPPayloadInfo *pt_info = NULL;
GstCaps *ret;
pt_info = gst_rtp_payload_info_for_pt (pt);
if (!pt_info || !pt_info->clock_rate)
return NULL;
GST_DEBUG_OBJECT (src,
"Requesting caps for session-id 0x%x and pt %u.", session_id, pt);
ret = gst_caps_new_simple ("application/x-rtp",
"media", G_TYPE_STRING, pt_info->media,
"encoding_name", G_TYPE_STRING, pt_info->encoding_name,
"clock-rate", G_TYPE_INT, (gint) pt_info->clock_rate, NULL);
if (G_UNLIKELY (src->caps)) {
GST_DEBUG_OBJECT (src,
"Full caps were set, no need for lookup %" GST_PTR_FORMAT, src->caps);
return gst_caps_copy (src->caps);
}
/* FIXME add sprop-parameter-set if any */
g_warn_if_fail (pt_info->encoding_parameters == NULL);
if (src->encoding_name != NULL) {
/* Unfortunately, the media needs to be passed in the function. Since
* it is not known, try for video if video not found. */
pt_info = gst_rtp_payload_info_for_name ("video", src->encoding_name);
if (pt_info == NULL)
pt_info = gst_rtp_payload_info_for_name ("audio", src->encoding_name);
return ret;
}
/* If we have not found any info from encoding-name we will try with a
* static one. We need to check that is not a dynamic, since some encoders
* do not use dynamic values. */
if (pt_info == NULL) {
if (!GST_RTP_PAYLOAD_IS_DYNAMIC (pt))
pt_info = gst_rtp_payload_info_for_pt (pt);
}
if (pt_info != NULL) {
ret = gst_caps_new_simple ("application/x-rtp",
"media", G_TYPE_STRING, pt_info->media,
"encoding-name", G_TYPE_STRING, pt_info->encoding_name,
"clock-rate", G_TYPE_INT, (gint) pt_info->clock_rate, NULL);
GST_DEBUG_OBJECT (src, "Decided on caps %" GST_PTR_FORMAT, ret);
/* FIXME add sprop-parameter-set if any */
g_warn_if_fail (pt_info->encoding_parameters == NULL);
return ret;
}
GST_DEBUG_OBJECT (src,
"Could not determine caps based on pt or encoding name.");
return NULL;
}
static GstElement *
@ -407,6 +459,9 @@ gst_rist_src_init (GstRistSrc * src)
g_mutex_init (&src->bonds_lock);
src->bonds = g_ptr_array_new ();
src->encoding_name = NULL;
src->caps = NULL;
/* Construct the RIST RTP receiver pipeline.
*
* udpsrc -> [recv_rtp_sink_%u] -------- [recv_rtp_src_%u_%u_%u]
@ -1118,6 +1173,14 @@ gst_rist_src_get_property (GObject * object, guint prop_id,
g_value_take_string (value, gst_rist_src_get_bonds (src));
break;
case PROP_CAPS:
gst_value_set_caps (value, src->caps);
break;
case PROP_ENCODING_NAME:
g_value_set_string (value, src->encoding_name);
break;
default:
G_OBJECT_WARN_INVALID_PROPERTY_ID (object, prop_id, pspec);
break;
@ -1218,6 +1281,31 @@ gst_rist_src_set_property (GObject * object, guint prop_id,
gst_rist_src_set_bonds (src, g_value_get_string (value));
break;
case PROP_CAPS:
{
const GstCaps *new_caps_val = gst_value_get_caps (value);
GstCaps *new_caps = NULL;
if (new_caps_val != NULL)
new_caps = gst_caps_copy (new_caps_val);
gst_caps_replace (&src->caps, new_caps);
break;
}
case PROP_ENCODING_NAME:
{
g_free (src->encoding_name);
src->encoding_name = g_value_dup_string (value);
if (bond->rtp_src) {
GstCaps *caps = gst_rist_src_request_pt_map (src, 0, 96, NULL);
g_object_set (G_OBJECT (bond->rtp_src), "caps", caps, NULL);
gst_caps_unref (caps);
}
break;
}
default:
G_OBJECT_WARN_INVALID_PROPERTY_ID (object, prop_id, pspec);
break;
@ -1246,6 +1334,9 @@ gst_rist_src_finalize (GObject * object)
g_clear_object (&src->jitterbuffer);
g_clear_object (&src->rtxbin);
gst_caps_unref (src->caps);
g_free (src->encoding_name);
g_mutex_unlock (&src->bonds_lock);
g_mutex_clear (&src->bonds_lock);
@ -1350,6 +1441,31 @@ gst_rist_src_class_init (GstRistSrcClass * klass)
"Comma (,) separated list of <address>:<port> to receive from. "
"Only used if 'enable-bonding' is set.", NULL,
G_PARAM_READWRITE | G_PARAM_STATIC_STRINGS));
/**
* GstRistSrc:encoding-name:
*
* Set the encoding name of the stream to use. This is a short-hand for
* the full caps and maps typically to the encoding-name in the RTP caps.
*
* Since: 1.24
*/
g_object_class_install_property (object_class, PROP_ENCODING_NAME,
g_param_spec_string ("encoding-name", "Caps encoding name",
"Encoding name use to determine caps parameters",
NULL, G_PARAM_READWRITE | G_PARAM_STATIC_STRINGS));
/**
* GstRistSrc:caps:
*
* The RTP caps of the incoming RIST stream.
*
* Since: 1.24
*/
g_object_class_install_property (object_class, PROP_CAPS,
g_param_spec_boxed ("caps", "Caps",
"The caps of the incoming stream", GST_TYPE_CAPS,
G_PARAM_READWRITE | G_PARAM_STATIC_STRINGS));
}
static GstURIType