From 5a5b89d0c9c34029953db52d8d779e24a1f099a7 Mon Sep 17 00:00:00 2001 From: aboba Date: Thu, 19 May 2016 09:17:30 -0700 Subject: [PATCH 1/8] transports can be null RTCRtpSender.transport and RTCRtpReceiver.transport can be null since the DTLS transports only come into existence after calls to setLocalDescription() and setRemoteDescription(). Still work-in-progress (do not merge yet). Related to Issue https://github.com/w3c/webrtc-pc/issues/651 --- webrtc.html | 9 ++++++--- 1 file changed, 6 insertions(+), 3 deletions(-) diff --git a/webrtc.html b/webrtc.html index b448f2aad..9a015efde 100644 --- a/webrtc.html +++ b/webrtc.html @@ -4367,7 +4367,7 @@

RTCRtpSender Interface

interface RTCRtpSender {
     readonly        attribute MediaStreamTrack? track;
-    readonly        attribute RTCDtlsTransport  transport;
+    readonly        attribute RTCDtlsTransport?  transport;
     readonly        attribute RTCDtlsTransport? rtcpTransport;
     static RTCRtpCapabilities getCapabilities (DOMString kind);
     Promise<void>             setParameters (optional RTCRtpParameters parameters);
@@ -5064,7 +5064,7 @@ 
RTCRtpReceiver Interface

       

         
interface RTCRtpReceiver {
     readonly        attribute MediaStreamTrack  track;
-    readonly        attribute RTCDtlsTransport  transport;
+    readonly        attribute RTCDtlsTransport?  transport;
     readonly        attribute RTCDtlsTransport? rtcpTransport;
     static RTCRtpCapabilities          getCapabilities (DOMString kind);
     RTCRtpParameters                   getParameters ();
@@ -5434,7 +5434,10 @@ 
RTCDtlsTransport Interface

       SCTP packets sent and received by data channels. In particular, DTLS adds
       security to an underlying transport, and the
       RTCDtlsTransport interface allows access to information
-      about the underlying transport and the security added.

+      about the underlying transport and the security added.
+      RTCDtlsTransport objects are constructed
+      and destroyed as a result of calls to setLocalDescription()
+      and setRemoteDescription().

       

         
interface RTCDtlsTransport {
     readonly        attribute RTCIceTransport       transport;

From 3913ecc77bfb7b9bb516e98a3318a9e981216d3f Mon Sep 17 00:00:00 2001
From: aboba 
Date: Thu, 19 May 2016 09:27:23 -0700
Subject: [PATCH 2/8] Add text to clarify

Add text to clarify
---
 webrtc.html | 14 +++++++++-----
 1 file changed, 9 insertions(+), 5 deletions(-)

diff --git a/webrtc.html b/webrtc.html
index 9a015efde..b4cb3a170 100644
--- a/webrtc.html
+++ b/webrtc.html
@@ -4386,14 +4386,16 @@ 
Attributes

               associated with this RTCRtpSender object.

             
             
transport of type RTCDtlsTransport, readonly

+            "idlAttrType">RTCDtlsTransport, readonly, nullable
             

-              
The transport attribute is the transport over
+              
The transport attribute is the transport over
               which media from track is sent in the form of RTP
-              packets. When BUNDLE is used, many
+              packets. Prior to construction of the
+              RTCDtlsTransport object, the transport
+              attribute will be null. When BUNDLE is used, many
               RTCRtpSender objects will share one
               transport and will all send RTP over the same
-              transport. When RTCP mux is used, rtcpTransport will
+              transport. When RTCP mux is used, rtcpTransport will
               be null, and both RTP and RTCP traffic will flow over the
               transport described by transport.

             

@@ -5086,7 +5088,9 @@ 
Attributes

             

               
The transport attribute is the
               transport over which media for the receiver's track
-              is received in the form of RTP packets. When BUNDLE is used, many
+              is received in the form of RTP packets. Prior to construction of the
+              RTCDtlsTransport object, the transport
+              attribute will be null. When BUNDLE is used, many
               RTCRtpReceiver objects will share one
               transport and will all receive RTP over the same
               transport. When RTCP mux is used, rtcpTransport will

From 1fde1b9925c95dd6d164e2f3d1062c420f31a900 Mon Sep 17 00:00:00 2001
From: aboba 
Date: Thu, 19 May 2016 09:29:28 -0700
Subject: [PATCH 3/8] More clarifications

More clarifications
---
 webrtc.html | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/webrtc.html b/webrtc.html
index b4cb3a170..8d0b697c3 100644
--- a/webrtc.html
+++ b/webrtc.html
@@ -4395,7 +4395,7 @@ 
Attributes

               attribute will be null. When BUNDLE is used, many
               RTCRtpSender objects will share one
               transport and will all send RTP over the same
-              transport. When RTCP mux is used, rtcpTransport will
+              transport. When RTCP mux is used, rtcpTransport will
               be null, and both RTP and RTCP traffic will flow over the
               transport described by transport.

             

@@ -5084,7 +5084,7 @@ 
Attributes

               object.

             
             
transport of type RTCDtlsTransport, readonly

+            "idlAttrType">RTCDtlsTransport, readonly, nullable
             

               
The transport attribute is the
               transport over which media for the receiver's track

From d866b31f634fdc4dd3c12f5be423ef00e0a7f156 Mon Sep 17 00:00:00 2001
From: aboba 
Date: Thu, 19 May 2016 09:30:40 -0700
Subject: [PATCH 4/8] Updates

Updates
---
 webrtc.html | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/webrtc.html b/webrtc.html
index 8d0b697c3..abf53aefa 100644
--- a/webrtc.html
+++ b/webrtc.html
@@ -4388,7 +4388,7 @@ 
Attributes

             
transport of type RTCDtlsTransport, readonly, nullable

             

-              
The transport attribute is the transport over
+              
The transport attribute is the transport over
               which media from track is sent in the form of RTP
               packets. Prior to construction of the
               RTCDtlsTransport object, the transport

From 9ff9b26f1f437483f5a236eca558015b6058b151 Mon Sep 17 00:00:00 2001
From: aboba 
Date: Thu, 19 May 2016 09:32:54 -0700
Subject: [PATCH 5/8] More updates

More updates
---
 webrtc.html | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/webrtc.html b/webrtc.html
index abf53aefa..ba47f221c 100644
--- a/webrtc.html
+++ b/webrtc.html
@@ -4391,7 +4391,7 @@ 
Attributes

               
The transport attribute is the transport over
               which media from track is sent in the form of RTP
               packets. Prior to construction of the
-              RTCDtlsTransport object, the transport
+              RTCDtlsTransport object, the transport
               attribute will be null. When BUNDLE is used, many
               RTCRtpSender objects will share one
               transport and will all send RTP over the same
@@ -5089,7 +5089,7 @@ 
Attributes

               
The transport attribute is the
               transport over which media for the receiver's track
               is received in the form of RTP packets. Prior to construction of the
-              RTCDtlsTransport object, the transport
+              RTCDtlsTransport object, the transport
               attribute will be null. When BUNDLE is used, many
               RTCRtpReceiver objects will share one
               transport and will all receive RTP over the same

From 487e210b86eb3c4cfbbc55eb21ec1ef94ac38b16 Mon Sep 17 00:00:00 2001
From: aboba 
Date: Thu, 26 May 2016 10:59:38 -0700
Subject: [PATCH 6/8] Update text

Add text about RTCIceTransport construction and remove text relating to destruction of RTCDtlsTransport objects.
---
 webrtc.html | 6 ++++--
 1 file changed, 4 insertions(+), 2 deletions(-)

diff --git a/webrtc.html b/webrtc.html
index ba47f221c..852bb0d42 100644
--- a/webrtc.html
+++ b/webrtc.html
@@ -5440,7 +5440,7 @@ 
RTCDtlsTransport Interface

       RTCDtlsTransport interface allows access to information
       about the underlying transport and the security added.
       RTCDtlsTransport objects are constructed
-      and destroyed as a result of calls to setLocalDescription()
+      as a result of calls to setLocalDescription()
       and setRemoteDescription().

       

         
interface RTCDtlsTransport {
@@ -5547,7 +5547,9 @@ 
RTCIceTransport Interface

       application access to information about the ICE transport over which
       packets are sent and received. In particular, ICE manages peer-to-peer
       connections which involve state which the application may want to
-      access.

+      access. RTCIceTransport objects are constructed
+      as a result of calls to setLocalDescription()
+      and setRemoteDescription().

       

         
interface RTCIceTransport {
     readonly        attribute RTCIceRole           role;

From e55253eacc4e2a20013aeec41c70d580a1b4768f Mon Sep 17 00:00:00 2001
From: aboba 
Date: Thu, 26 May 2016 13:40:22 -0700
Subject: [PATCH 7/8] Delete DTLS transport construction text

Delete DTLS transport construction text
---
 webrtc.html | 4 +---
 1 file changed, 1 insertion(+), 3 deletions(-)

diff --git a/webrtc.html b/webrtc.html
index 852bb0d42..bcbd7cdf3 100644
--- a/webrtc.html
+++ b/webrtc.html
@@ -4390,9 +4390,7 @@ 
Attributes

             

               
The transport attribute is the transport over
               which media from track is sent in the form of RTP
-              packets. Prior to construction of the
-              RTCDtlsTransport object, the transport
-              attribute will be null. When BUNDLE is used, many
+              packets. When BUNDLE is used, many
               RTCRtpSender objects will share one
               transport and will all send RTP over the same
               transport. When RTCP mux is used, rtcpTransport will

From 12558c68cefdf9b42208117c3991083fd9c689ca Mon Sep 17 00:00:00 2001
From: aboba 
Date: Thu, 26 May 2016 13:41:10 -0700
Subject: [PATCH 8/8] Remove DTLS transport text

Remove DTLS transport text
---
 webrtc.html | 4 +---
 1 file changed, 1 insertion(+), 3 deletions(-)

diff --git a/webrtc.html b/webrtc.html
index bcbd7cdf3..83fec1e08 100644
--- a/webrtc.html
+++ b/webrtc.html
@@ -5086,9 +5086,7 @@ 
Attributes

             

               
The transport attribute is the
               transport over which media for the receiver's track
-              is received in the form of RTP packets. Prior to construction of the
-              RTCDtlsTransport object, the transport
-              attribute will be null. When BUNDLE is used, many
+              is received in the form of RTP packets. When BUNDLE is used, many
               RTCRtpReceiver objects will share one
               transport and will all receive RTP over the same
               transport. When RTCP mux is used, rtcpTransport will