---
title: RTCPeerConnection.removeTrack()
slug: Web/API/RTCPeerConnection/removeTrack
translation_of: Web/API/RTCPeerConnection/removeTrack
---
<div>{{APIRef("WebRTC")}}</div>

<p><span class="seoSummary"><code><strong>RTCPeerConnection.removeTrack()</strong></code> 메소드는 {{domxref("RTCPeerConnection.getSenders()")}}에 의해 보고된 발신자 목록에서 해당 {{domxref("RTCRtpSender")}}를 실제로 제거하지 않은채, 지정한 트랙에서 미디어 전송을 중단하도록 연결의 로컬엔드에 알려줍니다.</span> 해당 트랙이 이미 중단되었거나, 연결의 발신자 목록에 존재하지 않으면, 이 메소드는 아무 영향이 없습니다.</p>

<p>연결이 이미 협상된 경우 ({{domxref("RTCPeerConnection.signalingState", "signalingState")}}가 <code>"stable"</code>로 설정된 경우), 재협상이 필요하다고 표시를 하게됩니다. 따라서, 원격 유저는 해당 협상이 발생하기 전까지 아무런 변화를 감지 할 수 없습니다. {{event("negotiationneeded")}} 이벤트가 {{domxref("RTCPeerConnection")}}에 전송되고, 로컬엔드에게 해당 협상이 반드시 발생해야 한다고 알려주게됩니다.</p>

<h2 id="Syntax" name="Syntax">Syntax</h2>

<pre class="syntaxbox"><code><em>pc</em>.removeTrack(sender);
</code></pre>

<h3 id="Example" name="Example">매개변수</h3>

<dl>
 <dt><code>mediaTrack</code></dt>
 <dd>연결에서 해당하는 발신자를 제거하도록 알려주는 {{domxref("RTCRtpSender")}}.</dd>
</dl>

<h3 id="반환_값">반환 값</h3>

<p><code>undefined</code>.</p>

<h3 id="예외처리">예외처리</h3>

<dl>
 <dt><code>InvalidStateError</code></dt>
 <dd>연결이 열린 상태가 아닙니다.</dd>
</dl>

<h2 id="Example" name="Example">예시</h2>

<p>아래의 예시는 연결에 비디오 트랙을 추가하고, 닫기 버튼을 감청하여 유저가 버튼을 클릭하면 해당 미디어를 제거하도록 합니다.</p>

<pre class="brush: js">var pc, sender;
navigator.getUserMedia({video: true}, function(stream) {
  pc = new RTCPeerConnection();
  var track = stream.getVideoTracks()[0];
  sender = pc.addTrack(track, stream);
});

document.getElementById("closeButton").addEventListener("click", function(event) {
  pc.removeTrack(sender);
  pc.close();
}, false);</pre>

<h2 id="Specifications" name="Specifications">사양서</h2>

<table class="standard-table" style="height: 49px; width: 1000px;">
 <thead>
  <tr>
   <th scope="col">사양서</th>
   <th scope="col">상태</th>
   <th scope="col">코멘트</th>
  </tr>
 </thead>
 <tbody>
  <tr>
   <td>{{ SpecName('WebRTC 1.0', '#dom-rtcpeerconnection-removetrack', 'RTCPeerConnection.removeTrack()') }}</td>
   <td>{{ Spec2('WebRTC 1.0') }}</td>
   <td>Initial specification.</td>
  </tr>
 </tbody>
</table>

<h2 id="브라우저_호환성">브라우저 호환성</h2>



<p>{{Compat("api.RTCPeerConnection.removeTrack")}}</p>

<h2 id="참조">참조</h2>

<ul>
 <li><a href="/en-US/docs/Web/API/WebRTC_API">WebRTC API</a></li>
</ul>