Aggiunta e rimozione delle tracce multimediali
Impari a gestire le tracce audio e video all'interno di un `RTCPeerConnection`, abilitando la manipolazione dinamica dello stream durante una chiamata.
Aggiunta e rimozione delle tracce multimediali è una lezione Real-Time Streaming Systems (WebRTC + Live Data) gratuita su CoddyKit. Questa è la lezione 2 di 4. Puoi leggere la lezione completa qui gratuitamente — poi esercitati direttamente nel browser con un editor di codice integrato e un tutor IA disponibile 24/7. Fa parte del percorso di apprendimento Real-Time Streaming Systems (WebRTC + Live Data), e i tuoi progressi si sincronizzano tra il web e l'app CoddyKit. Il corso Real-Time Streaming Systems (WebRTC + Live Data) include 4 lezioni in totale.
Parti di questa lezione non sono ancora state tradotte e vengono mostrate in inglese.
Dynamic Media in WebRTC Calls
Imagine you're in a video call and want to mute your microphone or switch your camera. How does WebRTC handle these changes without dropping the call?
This lesson explores how to dynamically add and remove audio/video tracks from an active WebRTC peer connection. This is crucial for creating interactive and flexible real-time applications.
What is a MediaStreamTrack?
Before managing tracks, let's clarify what they are. A MediaStreamTrack represents a single audio or video component within a MediaStream.
- Kind: Tracks have a
kindproperty, either'audio'or'video'. - Enabled: The
enabledproperty (boolean) lets you temporarily pause/unpause a track without removing it.
Sending Media with addTrack()
To start sending a local audio or video track to a remote peer, you use the RTCPeerConnection.addTrack() method.
It takes two arguments:
- The
MediaStreamTrackyou want to send. - The
MediaStreamthe track belongs to (important for grouping related tracks).
This method tells the peer connection to prepare and send this track's data.
Code: Adding a Local Video Track
Let's see how you'd add a local video track to your RTCPeerConnection. This snippet sets up a basic peer connection and adds a camera feed.
async function addLocalVideoTrack() {
// In a real app, 'pc' would be an already established RTCPeerConnection
const pc = new RTCPeerConnection();
try {
// Get access to the user's camera
const localStream = await navigator.mediaDevices.getUserMedia({ video: true, audio: false });
const videoTrack = localStream.getVideoTracks()[0];
// Add the video track to the peer connection
const sender = pc.addTrack(videoTrack, localStream);
console.log('Video track added! RTCRtpSender:', sender);
// In a full WebRTC app, you'd now create an offer and exchange SDP
// pc.createOffer().then(offer => pc.setLocalDescription(offer)).then(() => sendOfferToRemote(pc.localDescription));
} catch (error) {
console.error('Error adding video track:', error);
}
}
addLocalVideoTrack();Understanding RTCRtpSender
When you call pc.addTrack(), it returns an RTCRtpSender object. This object is your handle to manage the sending of that specific track.
- It allows you to modify parameters related to how the track is sent.
- It's also required if you later want to remove the track from the peer connection.
Stopping Media with removeTrack()
To stop sending a particular media track, you use the RTCPeerConnection.removeTrack() method.
This method takes one argument: the RTCRtpSender object that was returned when you originally called addTrack() for that track.
Once removed, the track's data will no longer be transmitted over the peer connection.
Code: Implementing removeTrack()
Let's extend our previous example to demonstrate how to remove a track after it has been added. We need to keep track of the RTCRtpSender.
let peerConnection; // Global or accessible RTCPeerConnection instance
let videoSender; // Global or accessible RTCRtpSender instance
let localVideoTrack; // Global or accessible MediaStreamTrack
async function setupAndAddTrack() {
peerConnection = new RTCPeerConnection();
try {
const localStream = await navigator.mediaDevices.getUserMedia({ video: true, audio: false });
localVideoTrack = localStream.getVideoTracks()[0];
videoSender = peerConnection.addTrack(localVideoTrack, localStream);
console.log('Video track added. Sender:', videoSender);
} catch (error) {
console.error('Error during setup or addTrack:', error);
}
}
function removeLocalVideoTrack() {
if (peerConnection && videoSender) {
peerConnection.removeTrack(videoSender);
localVideoTrack.stop(); // Stops the camera/mic itself
console.log('Video track removed and stopped!');
} else {
console.log('No track to remove or not set up.');
}
}
// Simulate adding a track, then removing it after 3 seconds
setupAndAddTrack().then(() => {
setTimeout(removeLocalVideoTrack, 3000);
});Receiving Remote Track Updates
On the receiving end, how does a peer know that a new track has been added or an existing one removed by the sender?
The RTCPeerConnection.ontrack event listener is fired on the receiving peer when a new MediaStreamTrack is added to the remote description. This is where you would typically attach the incoming track to a video or audio element.
Real-World Track Management
Dynamic track management is essential for many real-time features:
- Muting/Unmuting: Simply toggle
track.enabled = falseortrue. - Camera/Mic Switching: Remove the old track, get a new one from
getUserMedia(), and add the new track. - Screen Sharing: Get a screen share track (e.g., with
getDisplayMedia()) and add it to the peer connection.
Test Your Track Knowledge
RTCPeerConnection allows for dynamic management of media streams. Let's check your understanding of how tracks are handled.
Recap: Dynamic Media Control
In this lesson, you learned how to dynamically manage media tracks within a WebRTC call:
addTrack()sends aMediaStreamTrack, returning anRTCRtpSender.removeTrack()stops sending a track by taking itsRTCRtpSender.- The remote peer listens for the
ontrackevent to receive new media. - You can mute/unmute using
track.enabledand switch sources by adding/removing tracks.
Mastering these methods allows for rich, interactive real-time experiences!
Impara Real-Time Streaming Systems (WebRTC + Live Data) con un tutor IA — gratis
Scrivi ed esegui vero codice nel tuo browser, ricevi aiuto istantaneo da un tutor IA disponibile 24/7, e riprendi da dove hai lasciato sul web o nell'app.
- Corsi
- 12
- Lezioni
- 48
Domande Frequenti
La lezione «Aggiunta e rimozione delle tracce multimediali» è gratuita?
Sì — il testo completo di «Aggiunta e rimozione delle tracce multimediali» è gratuito qui sul web. Per esercitarvi in modo interattivo (un editor di codice integrato e un tutor IA 24/7) e sbloccare il resto del corso Real-Time Streaming Systems (WebRTC + Live Data), passa a CoddyKit PRO. Il corso Real-Time Streaming Systems (WebRTC + Live Data) include 4 lezioni in totale.
Cosa imparerò in «Aggiunta e rimozione delle tracce multimediali»?
Impari a gestire le tracce audio e video all'interno di un `RTCPeerConnection`, abilitando la manipolazione dinamica dello stream durante una chiamata. Eserciti Real-Time Streaming Systems (WebRTC + Live Data) con codice pratico che esegui direttamente nel browser, e un tutor IA 24/7 risponde alle tue domande mentre lavori sulla lezione.
Ho bisogno di esperienza per iniziare Real-Time Streaming Systems (WebRTC + Live Data)?
Non è richiesta alcuna esperienza precedente. Real-Time Streaming Systems (WebRTC + Live Data) su CoddyKit è strutturato per principianti e studenti avanzati, quindi puoi iniziare da qui o dall'inizio e procedere al tuo ritmo. Questa è la lezione 2 di 4.
Quanto tempo richiede la lezione «Aggiunta e rimozione delle tracce multimediali»?
La maggior parte delle lezioni CoddyKit richiede circa 5–10 minuti. Ogni lezione è breve e interattiva, quindi fai progressi costanti e riprendi esattamente da dove hai lasciato su web e app.
Posso scrivere ed eseguire codice in questa lezione Real-Time Streaming Systems (WebRTC + Live Data)?
Sì. Ogni lezione Real-Time Streaming Systems (WebRTC + Live Data) include un editor di codice integrato, quindi scrivi ed esegui codice reale direttamente nel tuo browser e ricevi feedback istantaneo dall'IA — nessuna configurazione locale necessaria.
Tutte le lezioni di questo corso
- Accesso ai dispositivi multimediali dell'utente
- Aggiunta e rimozione delle tracce multimediali
- Visualizzazione di audio e video remoti
- Controllo della qualità dei media e dei vincoli