snapshot of https://github.com/pion/webrtc.git (main, 2026-09-15; blobs > 131072B omitted)

examples/ice-restart/README.md

@@ -0,0 +1,26 @@
+# ice-restart
+ice-restart demonstrates Pion WebRTC's ICE Restart abilities.
+
+## Instructions
+
+### Download ice-restart
+This example requires you to clone the repo since it is serving static HTML.
+
+```
+git clone https://github.com/pion/webrtc.git
+cd webrtc/examples/ice-restart
+```
+
+### Run ice-restart
+Execute `go run *.go`
+
+### Open the Web UI
+Open [http://localhost:8080](http://localhost:8080). This will automatically start a PeerConnection. This page will now prints stats about the PeerConnection
+and allow you to do an ICE Restart at anytime.
+
+* `ICE Restart` is the button that causes a new offer to be made with `iceRestart: true`.
+* `ICE Connection States` will contain all the connection states the PeerConnection moves through.
+* `ICE Selected Pairs` will print the selected pair every 3 seconds. Note how the uFrag/uPwd/Port change everytime you start the Restart process.
+* `Inbound DataChannel Messages` containing the current time sent by the Pion process every 3 seconds.
+
+Congrats, you have used Pion WebRTC! Now start building something cool

examples/ice-restart/index.html

@@ -0,0 +1,86 @@
+<html>
+  <!--
+		SPDX-FileCopyrightText: 2026 The Pion community <https://pion.ly>
+		SPDX-License-Identifier: MIT
+	-->
+  <head>
+    <title>ice-restart</title>
+  </head>
+
+  <body>
+    <button onclick="window.doSignaling(true)"> ICE Restart </button><br />
+
+
+    <h3> ICE Connection States </h3>
+    <div id="iceConnectionStates"></div> <br />
+
+    <h3> ICE Selected Pairs </h3>
+    <div id="iceSelectedPairs"></div> <br />
+
+    <h3> Inbound DataChannel Messages </h3>
+    <div id="inboundDataChannelMessages"></div>
+  </body>
+
+  <script>
+    let pc = new RTCPeerConnection({
+      iceServers: [
+        {
+          urls: 'stun:stun.l.google.com:19302'
+        }
+      ]
+    })
+    let dc = pc.createDataChannel('data')
+
+    dc.onopen = () => {
+      setInterval(function() {
+        let el = document.createElement('template')
+        let selectedPair = pc.sctp.transport.iceTransport.getSelectedCandidatePair()
+
+        el.innerHTML = `<div>
+          <ul>
+             <li> <i> Local</i> - ${selectedPair.local.candidate}</li>
+             <li> <i> Remote</i> - ${selectedPair.remote.candidate} </li>
+          </ul>
+        </div>`
+
+        document.getElementById('iceSelectedPairs').appendChild(el.content.firstChild);
+      }, 3000);
+    }
+
+    dc.onmessage = event => {
+      let el = document.createElement('p')
+      el.appendChild(document.createTextNode(event.data))
+
+      document.getElementById('inboundDataChannelMessages').appendChild(el);
+    }
+
+    pc.oniceconnectionstatechange = () => {
+      let el = document.createElement('p')
+      el.appendChild(document.createTextNode(pc.iceConnectionState))
+
+      document.getElementById('iceConnectionStates').appendChild(el);
+    }
+
+
+    window.doSignaling = iceRestart => {
+      pc.createOffer({iceRestart})
+        .then(offer => {
+          pc.setLocalDescription(offer)
+
+          return fetch(`/doSignaling`, {
+            method: 'post',
+            headers: {
+              'Accept': 'application/json, text/plain, */*',
+              'Content-Type': 'application/json'
+            },
+            body: JSON.stringify(offer)
+          })
+        })
+        .then(res => res.json())
+        .then(res => pc.setRemoteDescription(res))
+        .catch(alert)
+    }
+
+    window.doSignaling(false)
+  </script>
+</html>

examples/ice-restart/main.go

@@ -0,0 +1,87 @@
+// SPDX-FileCopyrightText: 2026 The Pion community <https://pion.ly>
+// SPDX-License-Identifier: MIT
+
+// ice-restart demonstrates Pion WebRTC's ICE Restart abilities.
+package main
+
+import (
+	"encoding/json"
+	"fmt"
+	"net/http"
+	"time"
+
+	"github.com/pion/webrtc/v4"
+)
+
+var peerConnection *webrtc.PeerConnection //nolint
+
+// nolint: cyclop
+func doSignaling(res http.ResponseWriter, req *http.Request) {
+	var err error
+
+	if peerConnection == nil {
+		if peerConnection, err = webrtc.NewPeerConnection(webrtc.Configuration{}); err != nil {
+			panic(err)
+		}
+
+		// Set the handler for ICE connection state
+		// This will notify you when the peer has connected/disconnected
+		peerConnection.OnICEConnectionStateChange(func(connectionState webrtc.ICEConnectionState) {
+			fmt.Printf("ICE Connection State has changed: %s\n", connectionState.String())
+		})
+
+		// Send the current time via a DataChannel to the remote peer every 3 seconds
+		peerConnection.OnDataChannel(func(d *webrtc.DataChannel) {
+			d.OnOpen(func() {
+				for range time.Tick(time.Second * 3) {
+					if err = d.SendText(time.Now().String()); err != nil {
+						panic(err)
+					}
+				}
+			})
+		})
+	}
+
+	var offer webrtc.SessionDescription
+	if err = json.NewDecoder(req.Body).Decode(&offer); err != nil {
+		panic(err)
+	}
+
+	if err = peerConnection.SetRemoteDescription(offer); err != nil {
+		panic(err)
+	}
+
+	// Create channel that is blocked until ICE Gathering is complete
+	gatherComplete := webrtc.GatheringCompletePromise(peerConnection)
+
+	answer, err := peerConnection.CreateAnswer(nil)
+	if err != nil {
+		panic(err)
+	} else if err = peerConnection.SetLocalDescription(answer); err != nil {
+		panic(err)
+	}
+
+	// Block until ICE Gathering is complete, disabling trickle ICE
+	// we do this because we only can exchange one signaling message
+	// in a production application you should exchange ICE Candidates via OnICECandidate
+	<-gatherComplete
+
+	response, err := json.Marshal(*peerConnection.LocalDescription())
+	if err != nil {
+		panic(err)
+	}
+
+	res.Header().Set("Content-Type", "application/json")
+	if _, err := res.Write(response); err != nil {
+		panic(err)
+	}
+}
+
+func main() {
+	http.Handle("/", http.FileServer(http.Dir(".")))
+	http.HandleFunc("/doSignaling", doSignaling)
+
+	fmt.Println("Open http://localhost:8080 to access this demo")
+	// nolint: gosec
+	panic(http.ListenAndServe(":8080", nil))
+}