webrtc: Add missing Since markers to new ICE API

Part-of: <https://gitlab.freedesktop.org/gstreamer/gstreamer/-/merge_requests/8698>
This commit is contained in:
Matthew Waters 2025-04-03 13:43:55 +11:00 committed by GStreamer Marge Bot
parent 4718fc9be7
commit 601c772447
2 changed files with 71 additions and 12 deletions

View File

@ -1573,9 +1573,11 @@ stops automatic ICE gathering.</doc>
</parameters>
</glib:signal>
</class>
<record name="WebRTCICECandidateStats" c:type="GstWebRTCICECandidateStats" glib:type-name="GstWebRTCICECandidateStats" glib:get-type="gst_webrtc_ice_candidate_stats_get_type" c:symbol-prefix="webrtc_ice_candidate_stats">
<record name="WebRTCICECandidateStats" c:type="GstWebRTCICECandidateStats" version="1.22" glib:type-name="GstWebRTCICECandidateStats" glib:get-type="gst_webrtc_ice_candidate_stats_get_type" c:symbol-prefix="webrtc_ice_candidate_stats">
<source-position filename="../subprojects/gst-plugins-bad/gst-libs/gst/webrtc/ice.h"/>
<field name="ipaddr" writable="1">
<doc xml:space="preserve" filename="../subprojects/gst-plugins-bad/gst-libs/gst/webrtc/ice.h">A string containing the address of the candidate. This value may be
an IPv4 address, an IPv6 address, or a fully-qualified domain name (Since: 1.22)</doc>
<type name="utf8" c:type="gchar*"/>
</field>
<field name="port" writable="1">
@ -1584,7 +1586,7 @@ stops automatic ICE gathering.</doc>
</field>
<field name="stream_id" writable="1">
<doc xml:space="preserve" filename="../subprojects/gst-plugins-bad/gst-libs/gst/webrtc/ice.h">A string that uniquely identifies the object that is being
monitored to produce this set of statistics (Since: 1.22)</doc>
monitored to produce this set of statistics (Since: 1.22)</doc>
<type name="guint" c:type="guint"/>
</field>
<field name="type" writable="1">
@ -1593,7 +1595,7 @@ stops automatic ICE gathering.</doc>
</field>
<field name="proto" writable="1">
<doc xml:space="preserve" filename="../subprojects/gst-plugins-bad/gst-libs/gst/webrtc/ice.h">A string specifying the protocol (tcp or udp) used to transmit data
on the @port (Since: 1.22)</doc>
on the @port (Since: 1.22)</doc>
<type name="utf8" c:type="const gchar*"/>
</field>
<field name="relay_proto" writable="1">
@ -1605,7 +1607,7 @@ on the @port (Since: 1.22)</doc>
</field>
<field name="url" writable="1">
<doc xml:space="preserve" filename="../subprojects/gst-plugins-bad/gst-libs/gst/webrtc/ice.h">For local candidates, the url property is the URL of the ICE server
from which the candidate was received (Since: 1.22)</doc>
from which the candidate was received (Since: 1.22)</doc>
<type name="utf8" c:type="gchar*"/>
</field>
<union name="ABI" c:type="ABI">

View File

@ -49,27 +49,28 @@ struct _GstWebRTCICE
/**
* GstWebRTCICECandidateStats:
* @ipadd: A string containing the address of the candidate. This value may be
* an IPv4 address, an IPv6 address, or a fully-qualified domain name (Since: 1.22)
* @ipaddr: A string containing the address of the candidate. This value may be
* an IPv4 address, an IPv6 address, or a fully-qualified domain name (Since: 1.22)
* @port: The network port number used by the candidate (Since: 1.22)
* @stream_id: A string that uniquely identifies the object that is being
* monitored to produce this set of statistics (Since: 1.22)
* monitored to produce this set of statistics (Since: 1.22)
* @type: The candidate type (Since: 1.22)
* @proto: A string specifying the protocol (tcp or udp) used to transmit data
* on the @port (Since: 1.22)
* on the @port (Since: 1.22)
* @replay_proto: A string identifying the protocol used by the endpoint for
* communicating with the TURN server; valid values are tcp, udp, and tls (Since: 1.22)
* communicating with the TURN server; valid values are tcp, udp, and tls (Since: 1.22)
* @prio: The candidate's priority, corresponding to RTCIceCandidate.priority (Since: 1.22)
* @url: For local candidates, the url property is the URL of the ICE server
* from which the candidate was received (Since: 1.22)
* from which the candidate was received (Since: 1.22)
* @foundation: The ICE foundation as defined in RFC5245 section 15.1 (Since: 1.28)
* @related_address: The ICE rel-addr defined in RFC5245 section 15.1 Only
* set for serverreflexive, peerreflexive and relay candidates. (Since: 1.28)
* set for serverreflexive, peerreflexive and relay candidates. (Since: 1.28)
* @related_port: The ICE rel-addr defined in RFC5245 section 15.1. Only set
* for serverreflexive, peerreflexive and relay candidates. (Since: 1.28)
* for serverreflexive, peerreflexive and relay candidates. (Since: 1.28)
* @username_fragment: The ICE username fragment as defined in RFC5245 section 7.1.2.3 (Since: 1.28)
* @tcp_type: The ICE candidate TCP type, (Since: 1.28)
*
* Since: 1.22
*/
struct _GstWebRTCICECandidateStats
{
@ -82,12 +83,68 @@ struct _GstWebRTCICECandidateStats
guint prio;
gchar *url;
/**
* GstWebRTCICECandidateStats.ABI: (attributes doc.skip=true)
*
* ABI compatibility union
*
* Since: 1.28
*/
union {
/**
* GstWebRTCICECandidateStats.ABI.abi: (attributes doc.skip=true)
*
* ABI compatibility struct
*
* Since: 1.28
*/
struct {
/**
* GstWebRTCICECandidateStats.ABI.abi.foundation:
*
* The foundation of the ICE candidate.
*
* Since: 1.28
*/
gchar *foundation;
/**
* GstWebRTCICECandidateStats.ABI.abi.related_address:
*
* The related address (STUN or TURN server) of the candidate. Will be
* NULL for host candidates.
*
* Since: 1.28
*/
gchar *related_address;
/**
* GstWebRTCICECandidateStats.ABI.abi.related_port:
*
* The related port (STUN or TURN server) of the candidate. Will be
* 0 for host candidates.
*
* Since: 1.28
*/
guint related_port;
/**
* GstWebRTCICECandidateStats.ABI.abi.username_fragment:
*
* The ICE username for this candidate.
*
* Since: 1.28
*/
gchar *username_fragment;
/**
* GstWebRTCICECandidateStats.ABI.abi.tcp_type:
*
* The type of TCP candidate. Will be NULL if the candidate is not a TCP
* candidate.
*
* Since: 1.28
*/
const gchar *tcp_type;
} abi;
/*< private >*/