RTCPeerConnection: phương thức createOffer()

Baseline Widely available

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

Phương thức createOffer() của giao diện RTCPeerConnection bắt đầu tạo một offer SDP để khởi động một kết nối WebRTC mới tới máy ngang hàng từ xa. Offer SDP bao gồm thông tin về các đối tượng MediaStreamTrack đã được gắn vào phiên WebRTC, codec và tùy chọn được trình duyệt hỗ trợ, cũng như mọi candidate đã được bộ máy ICE thu thập, nhằm được gửi qua kênh báo hiệu tới máy ngang hàng tiềm năng để yêu cầu kết nối hoặc cập nhật cấu hình của một kết nối hiện có.

Cú pháp

js
createOffer()
createOffer(options)

createOffer(successCallback, failureCallback) // deprecated
createOffer(options, successCallback, failureCallback) // deprecated

Tham số

options Optional

Một đối tượng tùy chọn, chẳng hạn như iceRestart, dùng để điều khiển quá trình tạo offer.

Tham số lỗi thời

successCallback Deprecated

Hàm được gọi khi offer được tạo thành công.

failureCallback Deprecated

Hàm được gọi nếu việc tạo offer thất bại.

Giá trị trả về

Một Promise được giải quyết với một đối tượng RTCSessionDescription.

Ví dụ

js
pc.createOffer().then((offer) => pc.setLocalDescription(offer));

Thông số kỹ thuật

Specification
WebRTC: Real-Time Communication in Browsers
# dom-rtcpeerconnection-createoffer

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