RTCRtpTransceiver: stop() method

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since January 2021.

Phương thức stop() trong giao diện RTCRtpTransceiver sẽ dừng vĩnh viễn transceiver bằng cách dừng cả RTCRtpSenderRTCRtpReceiver đi kèm.

Cú pháp

js
stop()

Tham số

Không có.

Giá trị trả về

Không có (undefined).

Ngoại lệ

InvalidStateError DOMException

Bị ném nếu RTCPeerConnection mà transceiver là một thành viên đang đóng.

Mô tả

Khi bạn gọi stop() trên một transceiver, sender sẽ dừng gửi media ngay lập tức và từng luồng RTP của nó sẽ được đóng bằng thông điệp RTCP "BYE". Sau đó receiver dừng nhận media; track của receiver bị dừng, và direction của transceiver được đổi thành stopped. Việc thương lượng lại được kích hoạt bằng cách gửi sự kiện negotiationneeded đến RTCPeerConnection của transceiver, để kết nối có thể thích ứng với thay đổi.

Phương thức này không làm gì nếu transceiver đã dừng. Bạn có thể kiểm tra nó đã dừng hay chưa bằng cách so sánh currentDirection với "stopped".

Note: Các phiên bản trước của đặc tả dùng thuộc tính stopped Đã lỗi thời đã bị loại bỏ để cho biết transceiver có dừng hay không.

Tiêu chuẩn

Thông số kỹ thuật
WebRTC: Real-Time Communication in Browsers
# dom-rtcrtptransceiver-stop

Tương thích trình duyệt

Xem thêm