WebRTC - API RTCDataChannel
WebRTC không chỉ tốt trong việc truyền các luồng âm thanh và video mà còn bất kỳ dữ liệu tùy ý nào mà chúng tôi có thể có. Đây là lúc đối tượng RTCDataChannel phát huy tác dụng.
API RTCDataChannel
Tính chất
RTCDataChannel.label (read only) - Trả về một chuỗi chứa tên kênh dữ liệu.
RTCDataChannel.ordered (read only) - Trả về true nếu thứ tự giao tin được đảm bảo hoặc trả về false nếu không được đảm bảo.
RTCDataChannel.protocol (read only) - Trả về một chuỗi chứa tên giao thức con được sử dụng cho kênh này.
RTCDataChannel.id (read only) - Trả về một id duy nhất cho kênh được đặt khi tạo đối tượng RTCDataChannel.
RTCDataChannel.readyState (read only)- Trả về enum RTCDataChannelState đại diện cho trạng thái của kết nối. Các giá trị có thể có -
connecting- Cho biết kết nối chưa hoạt động. Đây là trạng thái ban đầu.
open - Cho biết kết nối đang chạy.
closing- Cho biết kết nối đang trong quá trình tắt. Thư được lưu trong bộ nhớ cache đang trong quá trình gửi hoặc nhận, nhưng không có tác vụ mới tạo nào được chấp nhận.
closed - Cho biết kết nối không thể được thiết lập hoặc đã bị tắt.
RTCDataChannel.bufferedAmount (read only)- Trả về số lượng byte đã được xếp hàng đợi để gửi. Đây là lượng dữ liệu chưa được gửi qua RTCDataChannel.send ().
RTCDataChannel.bufferedAmountLowThreshold- Trả về số byte mà tại đó RTCDataChannel.bufferedAmount được lấy ở mức thấp. Khi RTCDataChannel.bufferedAmount giảm xuống dưới ngưỡng này, sự kiện bufferedamountlow sẽ được kích hoạt.
RTCDataChannel.binaryType- Trả về kiểu dữ liệu nhị phân được truyền bởi kết nối. Có thể là “blob” hoặc “arraybuffer”.
RTCDataChannel.maxPacketLifeType (read only) - Trả về một đoạn ngắn không dấu cho biết độ dài tính bằng mili giây của cửa sổ khi nhắn tin đang ở chế độ không đáng tin cậy.
RTCDataChannel.maxRetransmits (read only) - Trả về một đoạn ngắn chưa được đánh dấu cho biết số lần tối đa một kênh sẽ truyền lại dữ liệu nếu nó không được phân phối.
RTCDataChannel.negotiated (read only) - Trả về boolean cho biết kênh đã được tác nhân người dùng hoặc ứng dụng thương lượng hay chưa.
RTCDataChannel.reliable (read only) - Trả về boolean cho biết kết nối có thể gửi tin nhắn ở chế độ không đáng tin cậy.
RTCDataChannel.stream (read only) - Từ đồng nghĩa với RTCDataChannel.id
Trình xử lý sự kiện
RTCDataChannel.onopen- Trình xử lý sự kiện này được gọi khi sự kiện mở được kích hoạt. Sự kiện này được gửi khi kết nối dữ liệu đã được thiết lập.
RTCDataChannel.onmessage- Trình xử lý sự kiện này được gọi khi sự kiện thông báo được kích hoạt. Sự kiện được gửi khi có thông báo trên kênh dữ liệu.
RTCDataChannel.onbufferedamountlow- Trình xử lý sự kiện này được gọi khi sự kiện bufferedamoutlow được kích hoạt. Sự kiện này được gửi khi RTCDataChannel.bufferedAmount giảm xuống dưới thuộc tính RTCDataChannel.bufferedAmountLowThreshold.
RTCDataChannel.onclose- Trình xử lý sự kiện này được gọi khi sự kiện đóng được kích hoạt. Sự kiện này được gửi khi kết nối dữ liệu đã bị đóng.
RTCDataChannel.onerror- Trình xử lý sự kiện này được gọi khi sự kiện lỗi được kích hoạt. Sự kiện này được gửi khi gặp lỗi.
Phương pháp
RTCDataChannel.close() - Đóng kênh dữ liệu.
RTCDataChannel.send()- Gửi dữ liệu trong tham số qua kênh. Dữ liệu có thể là một blob, một chuỗi, một ArrayBuffer hoặc một ArrayBufferView.